next up previous contents index
Next: restraints.make_distance() make Up: The restraints class: static Previous: restraints.symmetry.report() report   Contents   Index

restraints.make() -- make restraints

make(atmsel, restraint_type, spline_on_site, residue_span_range=(0, 99999), residue_span_sign=True, residue_grouping=1, restraint_sel_atoms=1, basis_pdf_weight='LOCAL', basis_relative_weight=0.05, intersegment=True, dih_lib_only=False, spline_dx=0.5, spline_min_points=5, spline_range=4.0, mnch_lib=1, accessibility_type=8, surftyp=1, distance_atoms=('CA', 'CA'), distngh=6.0, aln=None, edat=None, io=None)
Requirements:
topology & parameters

This command calculates and selects new restraints of a specified type. See the original papers for the most detailed definition and description of the restraints [Š ali & Blundell, 1993,Š ali & Overington, 1994]. The calculation of restraints of all types is now (partly) limited to the atoms in the atom selection atmsel. The new restraints are added to any currently present.

The physical restraint type of the new restraints is specified by restraint_group, and should be an object from the physical module (see Table 6.1).

restraint_type selects the types of the generated restraints. (For restraint type DISTANCE, do not use this command; instead, use restraints.make_distance().) Only one restraint type can be selected at a time, except for the stereochemical restraints (BOND, ANGLE, DIHEDRAL, IMPROPER) that can all be calculated at the same time. It is useful to distinguish between the stereochemical restraints and homology-derived restraints. The stereochemical restraints are obtained from libraries that depend on atom and/or residue types only (e.g., CHARMM 22 force field [MacKerell et al., 1998] or statistical potentials), and do not require the alignment aln with template structures. In contrast, the homology-derived restraints are calculated from related protein structures, which correspond to all but the last sequence in the alignment aln (the target). These templates are read from coordinate files, which are the only data files required. All restraints are added to the existing restraints, even if they duplicate them (but see the comment for the 'OMEGA' restraints below).

The atoms for non-bonded restraints also have to be within the residue spanning range specified by residue_span_range = r1 r2, such that the residue index difference $ r1 \le \vert ir2 - ir1\vert \le r2$ when residue_span_sign = False and $ r1 \le (ir2 - ir1) \le r2$ when residue_span_sign = True.

Stereochemical restraints:

Homology-derived restraints:

For these restraints, the input alignment aln must be given.

The weights of basis pdf's depend on local sequence similarity between the target and the templates when basis_pdf_weight = 'LOCAL' and on global sequence identity when basis_pdf_weight = 'GLOBAL'.

basis_relative_weight is the cutoff for removing weak basis pdf's from poly-Gaussian feature pdf's: a basis pdf whose weight is less than the basis_relative_weight fraction of the largest weight is deleted.

If spline_on_site is True, then certain dihedral restraints are automatically replaced by splines for efficiency. See restraints.spline() for a description of the spline_dx, spline_min_points, and spline_range parameters.

Several restraint types look up information from pre-calculated MDT tables, and for these the residue_grouping variable defines the way in which residues are grouped, as defined in $LIB/resgrp.lib, and accessibility_type defines the type of solvent accessibility.

Example: examples/commands/make_restraints.py


# Example for: restraints.make(), restraints.spline(), restraints.write()

# This will compare energies of bond length restraints expressed
# by harmonic potential and by cubic spline.

from modeller import *
from modeller.scripts import complete_pdb

log.verbose()
env = environ()
env.io.atom_files_directory = '../atom_files'
env.libs.topology.read(file='$(LIB)/top_heav.lib')
env.libs.parameters.read(file='$(LIB)/par.lib')

code = '1fas'
mdl = complete_pdb(env, code)
mdl.write(file=code+'.ini')

sel = selection(mdl)
mdl.restraints.make(sel, restraint_type='bond', spline_on_site=False)
mdl.restraints.write(file=code+'-1.rsr')
edat = energy_data(dynamic_sphere=False)
sel.energy(edat=edat)

mdl.restraints.spline(forms.gaussian, features.distance, physical.bond,
                      spline_range=5.0, spline_dx=0.005, edat=edat)
mdl.restraints.condense()
mdl.restraints.write(file=code+'-2.rsr')
sel.energy(edat=edat)


next up previous contents index
Next: restraints.make_distance() make Up: The restraints class: static Previous: restraints.symmetry.report() report   Contents   Index
Ben Webb 2008-02-01