model.mutate() -- mutate selected MODEL residues

residue_type = <str:1>

'undefined'

new residue type

Description:

This command mutates the selected residues of the MODEL to the type specified by residue_type. CHARMM 4-character residue type names are used (see library file $RESTYP_LIB). To select the residues for mutation, use model.pick_atoms() command. All the residues with at least one atom in the selected set 1 of atoms are mutated. To produce mutants, employ this command with alignment.append_model() and alignment.write(). It is usually necessary to write the mutated sequence out and read it in before proceeding, because not all sequence related information about MODEL is changed by this command (e.g., internal coordinates, charges, and atom types and radii are not updated).

Example: examples/commands/mutate_model.py

# Example for: model.mutate()

# This will read a PDB file, change its sequence a little, build new 
# coordinates for any of the additional atoms using only the internal
# geometry, and write the mutant PDB file.  It can be seen as primitive,
# but rapid comparative modeling for substitution mutants. For insertion 
# and deletion mutants, follow the standard comparative modeling procedure.

env = environ()

# Read the topology library with non-hydrogen atoms only:
env.libs.topology.read(file='$(LIB)/top_heav.lib')
# To produce a mutant with all hydrogens, uncomment these two lines:
#env.libs.topology.read(file='$(LIB)/top_allh.lib')

# Read the CHARMM parameter library:
env.libs.parameters.read(file='$(LIB)/par.lib')

# Read the original PDB file and copy its sequence to the alignment array:
code = '1fas'
aln = alignment(env)
mdl = model(env, file=code)
aln.append_model(mdl, atom_files=code, align_codes=code)

# Select the residues to be mutated: in this case all ASP residues:
mdl.pick_atoms(aln, res_types='ASP')

# The second example is commented out; it selects residues '1' and '10'.
#mdl.pick_atoms(aln, selection_segment=('1', '1'),
#               selection_status='INITIALIZE', selection_search='SEGMENT',
#               selection_from='ALL')
#mdl.pick_atoms(aln, selection_segment=('10', '10'), selection_status='ADD',
#               selection_search='SEGMENT', selection_from='ALL')

# Mutate the selected residues into HIS residues (neutral HIS):
mdl.mutate(residue_type='HIS')

# Add the mutated sequence to the alignment arrays (it is now the second 
# sequence in the alignment):
aln.append_model(mdl, align_codes='1fas-1')

# Generate molecular topology for the mutant:
mdl.generate_topology(aln, sequence='1fas-1')

# Transfer all the coordinates you can from the template native structure
# to the mutant (this works even if the order of atoms in the native PDB 
# file is not standard):
mdl.transfer_xyz(aln)

# Build the remaining unknown coordinates for the mutant:
mdl.build(initialize_xyz=False, build_method='INTERNAL_COORDINATES')

# Write the mutant to a file:
mdl.write(file='1fas-1.atm')