MMTSB
Tool Set Documentation

Difference between revisions of "latrex.pl"

From MMTSB
Jump to: navigation, search
(WhIiqWnhNCrBtcgJo)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
dummy
+
__NOTOC__
 +
== Usage ==
 +
 
 +
<mmtsbToolUsage cmd="latrex.pl"></mmtsbToolUsage>
 +
 
 +
== Description ==
 +
 
 +
This script is used to run replica exchange lattice Monte Carlo simulations
 +
with MONSSTER. Most of the options are identical to the options in
 +
[[aarex.pl]]. This script will also start up a server automatically
 +
in most parallel environment or can connect to a server that has been
 +
started manually with [[rexserver.pl]]<font color=#508060> -monsster</font>.<BR>
 +
 
 +
Input files may be given as in [[aarex.pl]] but can be either
 +
in PDB or SICHO chain format. The format has to be specified with <B>-input</B>.
 +
If no input files are given, random initial conformations are generated.<BR>
 +
 
 +
Lattice simulations require a sequence file that needs to be identified by using
 +
the <font color=#508060>seq</font> parameter in the <B>-par</B> option. The parameter <font color=#508060>rebuild</font> also only applies to lattice simulations and controls whether the final lattice chains is automatically rebuild to an all-atom model. Depending on the length of each Monte Carlo cycle this may slow down the overall simulation
 +
time quite significantly since it is done by the server in a serial fashion.<BR>
 +
 
 +
Lattice simulation specific parameters are set with <B>-simpar</B>
 +
(see [[latticesim.pl]] for a detailed explanation). The lattice
 +
grid size and restraint force constant for loop modeling may be given
 +
with <B>-simopt</B>. Finally, as in [[latticesim.pl]]
 +
distance restraints to be applied during the simulations can be given with
 +
<B>-d</B>.
 +
 
 +
== Options ==
 +
 
 +
; -help : usage information
 +
; -n runs : number of replica exchange runs
 +
; -par key=value[,...] : replica exchange simulation parameters
 +
; -temp nwin&#58;min&#58;max : number and range of temperature replicas
 +
; -condfile file : conditions file
 +
; -input pdb|chain : input format of initial structure(s)
 +
; -f listfile : list of initial files for different replicas
 +
; -simpar key=val[,...] : MONSSTER simulation parameters
 +
; -simopt key=val[,...] : MONSSTER simulation options
 +
; -l refPDB min&#58;max[=...] : limit sampling to residue range while keeping rest of the structure restrained to reference PDB
 +
; -d force res1&#58;res2[=...] : residue-residue contact restraints
 +
; -dir directory : data directory
 +
; -ens tag : ensemble tag for storing structures sampled at lowest temperature
 +
; -ensdir dir : ensemble directory
 +
; -log file : ouptut log file
 +
 
 +
== Examples ==
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test1"></mmtsbToolExample>
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test2"></mmtsbToolExample>
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test3"></mmtsbToolExample>
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test4"></mmtsbToolExample>
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test5"></mmtsbToolExample>
 +
 
 +
<mmtsbToolExample cmd="latrex.pl" set="/apps/mmtsb/bench/latrex.pl-test/test6"></mmtsbToolExample>

Latest revision as of 02:26, 31 July 2009

Usage

usage:   latrex.pl [options] [files]
options: [-n runs]
         [-par initruns=value,equilruns=value,
               [no]save,savebestfreq=value,archive,
               [no]rebuild,ensmode=add|replace,
               natpdb=file,seq=file]
         [-temp nwin:min:max]
         [-condfile file]
         [-input pdb|chain]
         [-f listfile]
         [-simpar ncycle=val,icycle=val,
                  stiff=val,short=val,central=val,kdcore=val]
         [-simopt limforce=value,gridsize=value]
         [-l refPDB min:max[=min:max ...]]
         [-d force res1:res2[=res1:res2...]]
         [-dir workdir]
         [-ens tag] [-ensdir dir]
         [PARALLELoptions]
         [-log file]

Show source


Description

This script is used to run replica exchange lattice Monte Carlo simulations with MONSSTER. Most of the options are identical to the options in aarex.pl. This script will also start up a server automatically in most parallel environment or can connect to a server that has been started manually with rexserver.pl -monsster.

Input files may be given as in aarex.pl but can be either in PDB or SICHO chain format. The format has to be specified with -input. If no input files are given, random initial conformations are generated.

Lattice simulations require a sequence file that needs to be identified by using the seq parameter in the -par option. The parameter rebuild also only applies to lattice simulations and controls whether the final lattice chains is automatically rebuild to an all-atom model. Depending on the length of each Monte Carlo cycle this may slow down the overall simulation time quite significantly since it is done by the server in a serial fashion.

Lattice simulation specific parameters are set with -simpar (see latticesim.pl for a detailed explanation). The lattice grid size and restraint force constant for loop modeling may be given with -simopt. Finally, as in latticesim.pl distance restraints to be applied during the simulations can be given with -d.

Options

-help 
usage information
-n runs 
number of replica exchange runs
-par key=value[,...] 
replica exchange simulation parameters
-temp nwin:min:max 
number and range of temperature replicas
-condfile file 
conditions file
-input pdb|chain 
input format of initial structure(s)
-f listfile 
list of initial files for different replicas
-simpar key=val[,...] 
MONSSTER simulation parameters
-simopt key=val[,...] 
MONSSTER simulation options
-l refPDB min:max[=...] 
limit sampling to residue range while keeping rest of the structure restrained to reference PDB
-d force res1:res2[=...] 
residue-residue contact restraints
-dir directory 
data directory
-ens tag 
ensemble tag for storing structures sampled at lowest temperature
-ensdir dir 
ensemble directory
-log file 
ouptut log file

Examples

latrex.pl -n 8 -par initruns=2,equilruns=2,seq=1vii.seq -temp 4:1.0:1.6
performs 8 cycles of replica exchange Monte Carlo lattice simulations with 2 initilization and 2 equilibration runs. The sequence file is required as input parameter and used to generate random input chains. 4 exponentially spaced temperature windows from 1 to 1.6 are used.


latrex.pl -n 8 -par initruns=2,equilruns=2,seq=1vii.seq -temp 4:1.0:1.6 -ens rex -ensdir data
runs replica exchange lattice simulations and stores the structures from the lowest temperature window in an ensemble.


latrex.pl -n 8 -par initruns=2,equilruns=2,seq=1vii.seq -temp 4:1.0:1.6 -input pdb 1vii.sample.?.pdb
runs a replica exchange lattice simulation starting from SICHO chains that have been generated from the given PDB input files rather than a random chain, generated by default.


latrex.pl -n 8 -par initruns=2,equilruns=2 -par seq=1vii.seq,rebuild,natpdb=1vii.exp.pdb -temp 4:1.0:1.6 -l 1vii.exp.pdb 10:21 -simopt limforce=2.0
runs replica exchange lattice simulations for a loop modeling application. The residues outside the loop are restrained during the simulation with a force of 2.0. The resulting chains are automatically rebuilt at each cycle and since the native structure is given, RMSD values between the reconstructed all-atom structure and the native structure are also calculated and stored.


latrex.pl -n 10 -par initruns=2,equilruns=2,seq=1vii.seq -temp 4:1.0:1.6 -hosts sgi.workstations
runs a distributed replica exchange lattice simulations. The host information is taken from sgi.workstations.


latrex.pl -n 10 -par initruns=2,equilruns=2,seq=1vii.seq -temp 4:1.0:1.6 -mp -hosts sgi.local
runs a distributed replica exchange lattice simulations with local directory. The host information is taken from sgi.local.