next up previous contents index
Next: READ_MODEL2 read Up: Handling of atomic coordinates Previous: Handling of atomic coordinates   Contents   Index

READ_MODEL -- read coordinates for MODEL

FILE = <string:1> 'default' name of the coordinates' file
ATOM_FILES_DIRECTORY = <string:1> './' input atom files directory list (e.g., 'dir1:dir2:dir3:./:/')
MODEL_SEGMENT = <string:2> 'FIRST:@' 'LAST:' segment to be read in
MODEL_FORMAT = <string:1> 'PDB' selects input atom file format: 'PDB' | 'CHARMM' | 'UHBD'
WATER_IO = <logical:1> off whether to read water coordinates
HETATM_IO = <logical:1> off whether to read HETATM coordinates
HYDROGEN_IO = <logical:1> off whether to read hydrogen coordinates

Description:
This command reads the atomic coordinates, atom names, residue names, residue numbers, isotropic temperature factors and segment specifications for MODEL, assigns residue types, and defines the dihedral angles listed in the $RESDIH_LIB library. For CHARMM and UHBD file formats, it also reads the atomic charges. However, it does not assign CHARMM and MODELLER atom types, internal coordinates, charges (in the case of the 'PDB' format), or patches (such as disulfides); to make these assignments, which are necessary for almost all energy commands, use GENERATE_TOPOLOGY. All real and pseudo atoms are selected. The PDB residue type 'HIS' is assigned the CHARMM residue type 'HSD', which is the neutral His with H on ND1. The PDB types 'ASP' and 'GLU' are assigned the corresponding charged CHARMM residue types, as are 'LYS' and 'ARG'. These conventions are relevant only if electrostatic terms and/or hydrogens are used.

MODEL_SEGMENT sets the beginning and ending residue identifiers for the contiguous sequence of residues to be read from the PDB file (this option does not work yet for the other file formats). The format of residue identifiers is described in Section 2.4.1. In addition, the following rule applies: If there is no `:' in the first residue specification, the segment specification is taken from the alignment entry with the specified code. Similarly, if there is no `:' in the second residue specification, the PDB filename is taken from the alignment entry with the specified code. The two codes do not have to be the same. For example, MODEL_SEGMENT = '4ape' '4ape' will take the segment specification and atom filename for entry 4ape in the alignment.

Example:


# Example for: READ_MODEL, WRITE_MODEL

# This will read a PDB file and write a CHARMM atom file without atomic charges
# or radii. For assigning charges and radii, see the all_hydrogen.top script.

READ_MODEL  FILE = '1fas'
WRITE_MODEL FILE = '1fas.crd', MODEL_FORMAT = 'CHARMM'
WRITE_MODEL FILE = '1fas.cif', MODEL_FORMAT = 'MMCIF'


next up previous contents index
Next: READ_MODEL2 read Up: Handling of atomic coordinates Previous: Handling of atomic coordinates   Contents   Index
Ben Webb 2004-10-04