Subsections


frame_order.pdb_model

Image frame_order Image document-save

Synopsis

Create a PDB file representation of the frame order dynamics.

Defaults

frame_order.pdb_model(ave_pos=`ave_pos', rep=`frame_order', dir=None, compress_type=0, size=30.0, inc=36, model=1, force=False)

Keyword arguments

ave_pos: The file root of the 3D structure PDB file for the molecular structure with the moving domains shifted to the average position.

rep: The file root of the PDB file for the geometric object representation of the frame order dynamics.

dir: The directory where the files are to be located.

compress_type: The type of compression to use when creating the files.

size: The size of the geometric object in Å.

inc: The number of increments used to create the geometric object.

model: Only one model from an analysed ensemble can be used for the PDB representation of the Monte Carlo simulations of the average domain position, as these consists of one model per simulation.

force: A flag which, if set to True, will overwrite the any pre-existing files.

Description

This function creates a set of PDB files for representing the frame order cone models. This includes a file for the average position of the molecule and a file containing a geometric representation of the frame order motions.

The three files are specified via the file root whereby the extensions `.pdb', `.pdb.gz', etc. should not be provided. This is important for the geometric representation whereby different files are created for the positive and negative representations (due to symmetry in the NMR data, these cannot be differentiated), and for the Monte Carlo simulations. For example if the file root is `frame_order', the positive and negative representations will be placed in the `frame_order_pos.pdb.gz' and `frame_order_neg.pdb.gz' files and the Monte Carlo simulations in the `frame_order_sim_pos.pdb.gz' and `frame_order_sim_neg.pdb.gz' files. For models where there is no difference in representation between the positive and negative directions, the files `frame_order.pdb.gz' and `frame_order_sim.pdb.gz' will be produced.

There are four different types of residue within the PDB. The pivot point is represented as as a single carbon atom of the residue `PIV'. The cone consists of numerous H atoms of the residue `CON'. The cone axis vector is presented as the residue `AXE' with one carbon atom positioned at the pivot and the other x Åaway on the cone axis (set by the geometric object size). Finally, if Monte Carlo have been performed, there will be multiple `MCC' residues representing the cone for each simulation, and multiple `MCA' residues representing the multiple cone axes.

To create the diffusion in a cone PDB representation, a uniform distribution of vectors on a sphere is generated using spherical coordinates with the polar angle defined by the cone axis. By incrementing the polar angle using an arccos distribution, a radial array of vectors representing latitude are created while incrementing the azimuthal angle evenly creates the longitudinal vectors. These are all placed into the PDB file as H atoms and are all connected using PDB CONECT records. Each H atom is connected to its two neighbours on the both the longitude and latitude. This creates a geometric PDB object with longitudinal and latitudinal lines representing the filled cone.

The PDB representation of the Monte Carlo simulations consists of one model per simulation. Therefore if an ensemble of structures has been analysed, only one model from the ensemble can be used for the representation. This defaults to model number 1, but this can be changed.


The relax user manual (PDF), created 2020-08-26.