MMTSB
Tool Set Documentation

Difference between revisions of "ensrun.pl"

From MMTSB
Jump to: navigation, search
 
Line 36: Line 36:
 
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/cgi-bin/parallelopt here]<BR>
  
 
== Options ==
 
== Options ==

Revision as of 12:11, 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 <docmark>ensmin.pl</docmark> and <docmark>enslatsim.pl</docmark> 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


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.