1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318
|
# ncs.py
# Copyright 2007, 2008 by Bernhard Lohkamp
# copyright 2008 The University of York
# Copyright 2007 by Paul Emsley, The University of York
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
import coot
from coot_redefine_functions import *
def find_first_model_molecule():
imols = molecule_number_list()
if not imols:
return False
else:
for molecule in imols:
if coot_utils.valid_model_molecule_qm(molecule):
return molecule
# Skip the residue in the next chain (typically of a molecule with
# NCS) with the same residue number. If on the last chain, then wrap
# to beginning. If it can't find anything then don't move (and put a
# message in the status bar)
#
def skip_to_next_ncs_chain(direction):
import types
# Given a chain-id and a list of chain-ids, return the chain-id of
# the next chain to be jumped to (use wrapping). If the list of
# chain-ids is less then length 2, return False.
#
def skip_to_chain_internal(this_chain_id, chain_id_list):
# print "this_chain_id: ", this_chain_id
if len(chain_id_list) < 2:
return False
else:
# we do it differnt to Paul's function, as I dont understand it and
# feel that this is easier and equally good!?
# Agreed, it does the same thing and more obviously correct 20100126-PE
current_chain_index = chain_id_list.index(this_chain_id)
if current_chain_index == len(chain_id_list)-1: # last chain
# return the first chain
return chain_id_list[0]
else:
# return the next chain
return chain_id_list[current_chain_index + 1]
def skip_to_chain(imol, this_chain_id, chain_id_list):
# Given a chain-id and a list of chain-ids, return the chain-id of
# the next chain to be jumped to (use wrapping). If the list of
# chain-ids is less then length 2, return False.
#
chain_guess = skip_to_chain_internal(this_chain_id, chain_id_list)
if ((not type(chain_guess) is bytes)):
return chain_guess
elif (coot_utils.is_solvent_chain_qm(imol, chain_guess)):
skip_to_chain(imol, chain_guess, chain_id_list)
else:
return chain_guess
def get_chain_id_list(imol, this_chain_id):
att = ncs_chain_ids(imol)
if (not att):
return coot_utils.chain_ids(imol)
else:
for attempt in att:
if (this_chain_id in attempt):
return attempt
# we havent found this_chain_id in ncs chains, so return all chains
return coot_utils.chain_ids(imol)
# First, what is imol? imol is the go to atom molecule
imol = coot.go_to_atom_molecule_number()
this_chain_id = coot.go_to_atom_chain_id()
chains = get_chain_id_list(imol, this_chain_id)
# try to get ghosts to be able to apply orientations
coot.make_ncs_ghosts_maybe(imol)
found_atom_state = 0
if (not chains):
print("BL WARNING:: empty set of chains!!! This should never happen.")
msg_txt = "BL WARNING:: somehow there are no chains in mol " + str(imol)
msg_txt+= "\n Try \"p\" to update the Go To Atom molecule and then\n"
msg_txt+= "skip again. Good luck skipping!\n"
coot.info_dialog(msg_txt)
# what shall we do now? Bail out I guess. But this should never happen!
return
next_chain = skip_to_chain(imol, this_chain_id, chains)
try_next_chain = next_chain
while (not try_next_chain == this_chain_id):
# OK, stop trying for next chain if we have looped round
# (as it were) so that we are back at the starting chain:
# e.g. consider the case: ["A" is protein, "B" is water,
# "C" is ligand]
#
if (not try_next_chain):
coot.add_status_bar_text("No 'NCS Next Chain' found")
break
else:
if (not (try_next_chain == this_chain_id)):
found_atom_state = coot.set_go_to_atom_chain_residue_atom_name_no_redraw(
try_next_chain,
coot.go_to_atom_residue_number(),
coot.go_to_atom_atom_name(),
0)
# now, did that set-go-to-atom function work (was there a
# real atom)? If not, then that could have been the ligand
# chain or the water chain that we tried to go to. We want
# to try again, and we shbould keep trying again until we get
# back to this-chain-id - in which case we have a "No NCS
# Next Chain atom" status-bar message.
if (found_atom_state == 0):
# then we did *not* find the atom, e.g. next-chain was
# the water chain
try_next_chain = skip_to_chain(imol, try_next_chain, chains)
else:
# otherwise all was hunkey-dorey
# set the orientation
forward_flag = 0
if (direction == "forward"):
forward_flag = 1
coot.apply_ncs_to_view_orientation_and_screen_centre(imol, this_chain_id, next_chain, forward_flag)
break
# A function inspired by a question from Bill Scott. He wanted to
# RNA ghosts. Because RNA does not work with SSM, we need to define
# the matrix manually. Let's make a copy of given imol and get
# the rtop from that. Typical usage manual_ncs_ghosts(0, 1, 10, "A", "C")
#
def single_manual_ncs_ghosts(imol, resno_start, resno_end, ref_chain, peer_chain):
imol_copy = coot.copy_molecule(imol)
clear_lsq_matches()
add_lsq_match(resno_start, resno_end, ref_chain,
resno_start, resno_end, peer_chain, 0) # ref mov - all atoms
rtop = apply_lsq_matches(imol_copy, imol_copy)
close_molecule(imol_copy)
if (not rtop):
print("Failed to get matching matrix")
else:
coot.clear_ncs_ghost_matrices(imol)
coot.set_draw_ncs_ghosts(imol, 1)
args = [imol, peer_chain, ref_chain] + rtop[0] + rtop[1]
coot.add_ncs_matrix(*args)
# chain-id-list is ["A", "B", "C", "D"], i.e. the
# reference/target/master chain-id first and then the peers. This
# allows us to add many peers at the same time (unlike above
# function).
#
def manual_ncs_ghosts(imol, resno_start, resno_end, chain_id_list):
# from types import ListType
if True:
if (len(chain_id_list) > 1):
# OK, OK, to the standard SSM-based NCS matrices are bad for this
# molecule, lets use LSQ.
coot.clear_ncs_ghost_matrices(imol)
imol_copy = coot.copy_molecule(imol)
for chain_id in chain_id_list[1:]: # I dont think we need to superpose A onto A?!
coot.clear_lsq_matches()
coot.add_lsq_match(resno_start, resno_end, chain_id_list[0],
resno_start, resno_end, chain_id, 1)
rtop = apply_lsq_matches(imol, imol_copy)
if (not rtop):
print("Failed to get LSQ matching matrix", chain_id)
else:
master = chain_id_list[0]
print("chain_id %s master %s rtop: %s" %(chain_id, master, rtop))
if master: # should be string or False, so ok I belive
args = [imol, chain_id, master] + rtop[0] + rtop[1]
coot.add_ncs_matrix(*args)
coot.close_molecule(imol_copy)
coot.set_draw_ncs_ghosts(imol, 1)
# Update NCS ghosts based on local environment (residues within 6A of
# (and including) the active residue).
#
# Typically one would bind this function to a key.
#
def update_ncs_ghosts_by_local_sphere():
"""Update NCS ghosts based on local environment (residues within 6A of
(and including) the active residue).
Typically one would bind this function to a key."""
with coot_utils.UsingActiveAtom() as [aa_imol, aa_chain_id, aa_res_no, aa_ins_code,
aa_atom_name, aa_alt_conf]:
# coot.clear_ncs_ghost_matrices(aa_imol)
ghost_ncs_chain_ids = ncs_chain_ids(aa_imol)
if (isinstance(ghost_ncs_chain_ids, list)):
ghost_chain_id_list = ghost_ncs_chain_ids[0]
if (isinstance(ghost_chain_id_list, list)):
coot.clear_ncs_ghost_matrices(aa_imol)
for chain_id in ghost_chain_id_list[1]:
imol_copy = coot.copy_molecule(aa_imol)
coot.set_mol_displayed(imol_copy, 0)
coot.set_mol_active(imol_copy, 0)
coot.clear_lsq_matches()
active_residue_spec = [aa_chain_id, aa_res_no, aa_ins_code]
near_residues = coot.residues_near_residue_py(aa_imol, active_residue_spec, 6)
sphere_residues = [active_residue_spec, near_residues]
for residue_spec in sphere_residues:
res_no = res_spec_utils.residue_spec_to_res_no(residue_spec)
coot.add_lsq_match(res_no, res_no, ghost_chain_id_list[0],
res_no, res_no, chain_id, 1)
rtop = apply_lsq_matches(aa_imol, imol_copy)
coot.close_molecule(imol_copy)
if not rtop:
print("Failed to get LSQ matching matrix", chain_id)
else:
master = ghost_chain_id_list[0]
if (isinstance(master, str)):
args = [aa_imol, chain_id, master] + rtop[0] + rtop[1]
coot.add_ncs_matrix(*args)
# Return the first master chain id (usually there is only one of course) or False
#
def ncs_master_chain_id(imol):
from types import ListType
cids_ls = ncs_chain_ids(imol)
if type(cids_ls) is not ListType:
return False
else:
if (len(cids_ls) == 0):
return False
else:
cids = cids_ls[0]
if (len(cids) == 0):
return False
else:
return cids[0]
# This was designed to create an NCS copy of a ligand (or range of
# residues) in the active site of one chain to the as yet unoccupied
# active site of another, i.e. it makes a NCS ligand "D"1 that is a NCS
# copy of ligand "C"1 using an NCS operator that maps protein chain "A"
# onto chain "B".
#
def ncs_ligand(imol_protein, ncs_master_chain_id,
imol_ligand, chain_id_ligand,
resno_ligand_start, resno_ligand_stop):
# find ghost in ghosts that has a chain-id matching
# chain-id-protein and get its rtop. Return #f on not finding the
# ghost
def rtop_from_ghost_with_chain_id(ghosts, chain_id):
for ghost in ghosts:
if (ghost[1] == chain_id):
return ghost[3]
return False
coot_utils.chain_ids_from_ncs = ncs_chain_ids(imol_protein)
if coot_utils.chain_ids_from_ncs:
ligand_selection_string = "//" + chain_id_ligand + "/" + str(resno_ligand_start) + \
"-" + str(resno_ligand_stop)
imol_ligand_fragment = coot.new_molecule_by_atom_selection(imol_ligand, ligand_selection_string)
ghosts = ncs_ghosts(imol_protein)
for coot_utils.chain_ids in chain_ids_from_ncs:
if (chain_ids[0] == ncs_master_chain_id):
peer_chains = coot_utils.chain_ids[1:len(chain_ids)]
candidate_name = "Candidate NCS-related ligand"
for chain_id_protein in peer_chains:
rtop = rtop_from_ghost_with_chain_id(ghosts, chain_id_protein)
if (not rtop):
print("Opps - ncs-ligand: Missing ghost rt-op!")
coot.info_dialog("Opps - ncs-ligand: Missing ghost rt-op!")
else:
new_lig_mol = coot.copy_molecule(imol_ligand_fragment)
coot_utils.transform_coords_molecule(new_lig_mol, inverse_rtop(rtop))
coot.set_molecule_name(new_lig_mol,
str(new_lig_mol) +
": " +
candidate_name +
" to protein chain " +
chain_id_protein)
def test_func(imol):
if (not coot_utils.valid_model_molecule_qm(imol)):
return False
else:
name = coot.molecule_name(imol)
if (candidate_name in name):
ls = [name]
for i in coot_utils.molecule_centre(imol):
ls.append(i)
return ls
else:
return False
fitting.molecules_matching_criteria(lambda imol: test_func(imol))
|