MMTSB
Tool Set Documentation

checkin.pl

From MMTSB
Revision as of 12:09, 30 July 2009 by Edit (talk | contribs) (→‎Options)
(diff) ←Older revision | view current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

Usage

usage:   checkin.pl [options] tag [file(s)]
options: [-sicho] [-seq file]
         [-at index]
         [-dir datadir]
         [-f filelist]
         [-links]
         [-verbose]
         [-[no]compress]
         [-dcd PDBtemplate CHARMMtrajectory]
         [-dcdskip value]

Show source


Description

This script is used to add PDB files or SICHO chain files to an ensemble of protein structures.

Ensembles are used in structure prediction to obtain statistically meaningful energy scores for structural families identified by clustering (see cluster.pl). While a number of MMTSB tools directly generate ensembles from running multiple lattice simulations and all-atom refinement (enslatsim.pl, ensmin.pl), or replica exchange sampling (latrex.pl and aarex.pl) this script is intended to setup an ensemble data structure from structures generated elsewhere so that ensemble-based MMTSB tools can be used for structure evaluation and refinement.

Structure ensembles are stored in a directory tree with a separate directory for each running index within the ensemble. Multiple conformations for a given index are distinguished by tags. Structural properties for all structures with a given tag are maintained in a single database file in the top of the directory tree. It is not recommended to modify the directory structure, add or remove files manually, or edit property database files directly since a number of different MMTSB tools rely on certain data structures and formats.

checkin.pl is called with a tag and one or more files to be added to an ensemble. The list of files can also be read from an external file (or standard input if - is given as the file name) by using the -f option. By default, the file(s) are added to an ensemble in the current directory (a new ensemble is created if none exists). A different directory may be specified with -dir. The option -at can be used to replace structures starting at a given index rather than adding them. The option -sicho is available to check in SICHO lattice chains instead of PDB files. All-atom structures in PDB format are automatically rebuilt from SICHO chains if a MONSSTER sequence file is available (see: genseq.pl). If the name of the sequence file is not available from the ensemble configuration files it may by given with -seq.

This script can also generate an ensemble from a binary CHARMM trajectory file if it is run on the same computer platform as CHARMM when the trajectory was created. In this case the option -dcd can be used with a PDB template file, which has to have the correct matching order and number of atoms corresponding to the trajectory file, and the name of the trajectory file.-dcdskip can be used in addition in order to skip conformations in the trajectory.

Options

-help 
usage information
-sicho 
checkin SICHO chain
-seq file 
provide SICHO sequence file to rebuild all-atom structures from SICHO chain
-at index 
checkin at specific index in ensemble
-dir datadir 
data directory
-f filelist 
external file with list of files to be checked
-links 
create symbolic links rather than coyping files
-verbose 
write out information during checkin
-[no]compress 
(do not) compress PDB structures using gzip
-dcd PDBtemplate CHARMMtrajectory 
checkin structures from a trajectory file into an ensemble
-dcdskip value 
skip structures according to the given value

Examples

checkin.pl sample 1vii.sample.?.pdb
checks the structures from the files matching 1vii.sample.?.pdb into an ensemble in the current directory under the tag sample


checkin.pl -dir data -f file.list sample
checks the structures from the files given in file.list into an ensemble in the data directory under the tag sample


checkin.pl -at 5 sample 1vii.sample.1?.pdb
checks the structures from the files matching 1vii.sample.1?.pdb into an existing ensemble in the current directory under the tag sample beginning at index 5. Exisiting conformations at index 5 or higher are overwritten with the new ones.