MMTSB
Tool Set Documentation

Difference between revisions of "ensrun.pl"

From MMTSB
Jump to: navigation, search
 
 
(3 intermediate revisions by the same user not shown)
Line 33: Line 33:
 
a reference structure is available or supplied with <B>-natpdb</B>.
 
a reference structure is available or supplied with <B>-natpdb</B>.
 
<BR><BR>
 
<BR><BR>
As in <docmark>ensmin.pl</docmark> and <docmark>enslatsim.pl</docmark>
+
As in [[ensmin.pl]] and [[enslatsim.pl]]
 
the options <B>-dir</B>, <B>-run</B> are available to select the
 
the options <B>-dir</B>, <B>-run</B> are available to select the
 
ensemble directory and specify a subset of ensemble structures.
 
ensemble directory and specify a subset of ensemble structures.
The options for parallel execution are listed <A HREF="http://mmtsb.scripps.edu/cgi-bin/parallelopt">here.</A><BR>
+
The options for parallel execution are listed [http://feig.bch.msu.edu/mmtsb/PARALLELoptions here]<BR>
  
 
== Options ==
 
== Options ==
  
 
; -help : usage information
 
; -help : usage information
 
+
; -new tag : tag name for new set of structures to be added to ensemble
 +
; -set prop[&#58;index][,...] : property names (and column indices) for data to be added to ensemble
 +
; -overwrite : overwrite property data even if it already exists
 +
; -noinp : do not pass PDB file as input to given command
 +
; -natpdb pdbFile : provide reference structure for automatically calculating RMSD values
 +
; -dir workdir : data directory
 +
; -update frq : update frequency of property database during parallel calculation
 +
; -[no]compress : (do not) compress new structures that are being created
 +
; -run [from&#58;]to : limit command to subset of ensemble
 +
; -cmd file : provide script file to be executed
 +
; -log file : output log file
  
 
== Examples ==
 
== Examples ==

Latest revision as of 12:25, 30 July 2009

Usage

usage:   ensrun.pl [options] tag [command]
options: [-new tag]
         [-set prop[:index][,prop[:index]]]
         [-overwrite]
         [-noinp]
         [-natpdb pdbFile]
         [-dir workdir]
         [-update frq]
         [-[no]compress]
         [-run [from:]to]
         [PARALLELoptions]
         [-cmd file]
         [-log file]

Show source


Description

This script is used to execute user commands for ensemble structures. Required is the tag of the strucutures for which the command is applied. A single command may follow as the last parameter on the command line. Alternatively, one or more commands can be provided through standard input.

For each ensemble structure the command is then executed with the PDB structure passed through standard input/output. For a list of commands, the PDB structure is only passed to the first command. The command has to be setup appropriately to be able to read the PDB structure from standard input unless -noinp is given. In this case no data is passed to the command through standard input/output.

Three modes are available to treat the command output. In the first mode (if neither of the options -set or -new are given) the output is ignored. In the second mode the output is used to set one or more property values within the ensemble under property tags given with the -set option. One or more property tag names may be appended with an index specifying the field within the command output line where the respective value is located. Values that have been set already they will not be recomputed and overwritten unless -overwrite is specified. In the third mode the command output is assumed to be a new PDB structure and used to generate a new ensemble structure set. In this case the corresponding tag of the new ensemble has to be set with -new. The new structures are then automatically checked in and analyzed if a reference structure is available or supplied with -natpdb.

As in ensmin.pl and enslatsim.pl the options -dir, -run are available to select the ensemble directory and specify a subset of ensemble structures. The options for parallel execution are listed here

Options

-help 
usage information
-new tag 
tag name for new set of structures to be added to ensemble
-set prop[:index][,...] 
property names (and column indices) for data to be added to ensemble
-overwrite 
overwrite property data even if it already exists
-noinp 
do not pass PDB file as input to given command
-natpdb pdbFile 
provide reference structure for automatically calculating RMSD values
-dir workdir 
data directory
-update frq 
update frequency of property database during parallel calculation
-[no]compress 
(do not) compress new structures that are being created
-run [from:]to 
limit command to subset of ensemble
-cmd file 
provide script file to be executed
-log file 
output log file

Examples

ensrun.pl -dir data -set sasa lat enerCHARMM.pl -out sasa
obtains solvent accessible surface areas by executing enerCHARMM.pl -out sasa for each ensemble structure associated with the lat tag and stores them under the sasa property tag.


ensrun.pl -dir data -cpus 2 -new amber lat minAmber.pl -par steps=100 -elog amber.elog
executes minAmber.pl -par steps=100 -elog amber.elog for each structure associated with the lat tag to obtain new structures minimized with Amber. From the resulting structures a new ensemble set is created with the amber tag. The run is done in parallel on two CPUs.