MMTSB
Tool Set Documentation

Difference between revisions of "ensmin.pl"

From MMTSB
Jump to: navigation, search
 
Line 8: Line 8:
 
This script is used to generate structure ensemble structures
 
This script is used to generate structure ensemble structures
 
through minimization of PDB files. Many options are similar
 
through minimization of PDB files. Many options are similar
to <docmark>minCHARMM.pl</docmark>, the script for single
+
to [[minCHARMM.pl]], the script for single
minimization runs, and <docmark>enslatsim.pl</docmark>, the
+
minimization runs, and [[enslatsim.pl]], the
 
script for generating ensembles from lattice simulations.<BR><BR>
 
script for generating ensembles from lattice simulations.<BR><BR>
 
Two tags are required as argument to <font color=#508060>ensmin.pl</font>:
 
Two tags are required as argument to <font color=#508060>ensmin.pl</font>:
Line 30: Line 30:
 
probably want to take advantage of parallel architectures for
 
probably want to take advantage of parallel architectures for
 
a larger number of simulations. The available parallel options are
 
a larger number of simulations. The available parallel options are
listed  <A HREF="http://mmtsb.scripps.edu/cgi-bin/parallelopt">here.</A><BR>
+
listed  [http://feig.bch.msu.edu/mmtsb/PARALLELoptions here]<BR>
 
The remaining options are used to control minimization runs
 
The remaining options are used to control minimization runs
 
and are kept in a file <font color=#508060>tag.options</font> for later reference
 
and are kept in a file <font color=#508060>tag.options</font> for later reference
Line 37: Line 37:
 
<docmark>minCHARMM.pl</docmark> with the exception of restraints
 
<docmark>minCHARMM.pl</docmark> with the exception of restraints
 
for loop modeling:<BR>
 
for loop modeling:<BR>
In <docmark>minCHARMM.pl</docmark> the option <B>-l</B> switches
+
In [[minCHARMM.pl]] the option <B>-l</B> switches
 
on gradual restraints outside a given fragment list based on distance
 
on gradual restraints outside a given fragment list based on distance
 
in sequence space. An alternative is to use <B>-cons</B> with a
 
in sequence space. An alternative is to use <B>-cons</B> with a
restraint list generated by <docmark>vicinity.pl</docmark>. Such a
+
restraint list generated by [[vicinity.pl]]. Such a
 
list will restrain residues surrounding the loop region in two shells
 
list will restrain residues surrounding the loop region in two shells
 
with different force constants to allow some readjustment of residues in
 
with different force constants to allow some readjustment of residues in

Revision as of 12:27, 30 July 2009

Usage

usage:   ensmin.pl [options] intag outtag
options: [-par CHARMMparams]
         [-opt file[:file]]
         [-l refPDB min:max[=min:max ...]]
         [-[no]conslim] [-limforce value]
         [-limsel=ca|cb|cab|heavy]
         [-cons [ca|cb|cab|heavy] self|refpdb min:max[_force][=...]]
         [-run [from:]to]
         [-dir workdir]
         [-natpdb pdbFile]
         [-[no]compress]
         [-update frq]
         [PARALLELoptions]
         [-log file]

Show source


Description

This script is used to generate structure ensemble structures through minimization of PDB files. Many options are similar to minCHARMM.pl, the script for single minimization runs, and enslatsim.pl, the script for generating ensembles from lattice simulations.

Two tags are required as argument to ensmin.pl: The first one identifies the ensemble structures that are used for input at each run and have to be present already, the second one is used for the output after the minimization run is complete.
The ensemble directory can be given with -dir if it is not the current directory. The number of desired runs is specified using -run either followed by a single number for the total number of runs or by an explicit interval.
A reference PDB file for comparison with the native conformation may be given through -natpdb but is not required. For loop or fragment modeling the range of residues that are being modeled and a template PDB file with the structure outside the modeled residues are specified using -l. Like the native PDB structure this data may already be present in the ensemble configuration file and does not need to be given in that case.
Although this script will work in a serial fashion, one would probably want to take advantage of parallel architectures for a larger number of simulations. The available parallel options are listed here
The remaining options are used to control minimization runs and are kept in a file tag.options for later reference and subsequent executions of this script on the same ensemble set. They are very similar to the options in <docmark>minCHARMM.pl</docmark> with the exception of restraints for loop modeling:
In minCHARMM.pl the option -l switches on gradual restraints outside a given fragment list based on distance in sequence space. An alternative is to use -cons with a restraint list generated by vicinity.pl. Such a list will restrain residues surrounding the loop region in two shells with different force constants to allow some readjustment of residues in direct contact with the loop. In ensmin.pl a fragment list, given with -l, is not just used for restraints but also to limit RMSD and other calculations to the loop region. In typical loop modeling applications this option would always be specified even if the restraints are given through -cons. A second option -conslim is therefore necessary to request explicitly that the fragment list is also used to generate restraints. However, if a fragment list is given and no other restraint list is given with -cons this flag is turned on automatically, unless -noconslim is given. The options -limsel and -limforce to specify the atom selection and maximum force constant used for automatically restraints from the fragment list. If any of these options is given the conslim is also turned on automatically.

Options

-help 
usage information


Examples

ensmin.pl -dir data -run 5 -par steps=200,tol=1E-2,param=19 lat vacmin
performs 5 minimization runs starting from the lat ensemble structures and stores them under the tag vacmin Each run is done in vacuum (default) over 200 steps with the adopted-basis Newton-Raphson scheme or until an energy tolerance of 1E-2 is reached. CHARMM19 parameters are used.


ensmin.pl -dir data -run 6:20 -cpus 3 lat vacmin
adds more minimization runs for indices 6 through 20 to an existing ensemble in the data directory. The simulations are run in parallel on 3 CPUs.


ensmin.pl -dir data -cpus 2 -conslim -limforce 1.0 -limsel ca -noslowrest lat vacmin
minimizes a set of ensemble structures that have been generated previously through lattice simulations in a loop modeling application (see enslatsim.pl). The loop residues (10 through 21) are available from the ensemble configuration file and do not have to be specified again. Only the maximum force constant for the all-atom restraints and the atom subset used for the restraints are given as parameters. Furthermore only a single stage of restrained minimization is used (see minCHARMM.pl).