Trees  Indices  Help 



Class containing the user functions of the Frame Order theories.












Inherited from 

Create a PDB file representing the Frame Order cone models. Keyword Arguments ~~~~~~~~~~~~~~~~~ size: The size of the geometric object in Angstroms. inc: The number of increments used to create the geometric object. file: The name of the PDB file to create. dir: The directory where the file is to be located. force: A flag which, if set to True, will overwrite the any preexisting file. Description ~~~~~~~~~~~ This function creates a PDB file containing an artificial geometric structure representing the Frame Order cone models. 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 Angstroms away on the cone axis (set by the size argument). 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. 
Match the domains to PDB files. Keyword Arguments ~~~~~~~~~~~~~~~~~ domain: The domain to associate the PDB file to. pdb: The PDB file to associate the domain to. Description ~~~~~~~~~~~ To display the frame order cone models within Pymol, the two domains need to be associated with PDB files. Then the reference domain will be fixed in the PDB frame, and the moving domain will be rotated to its average position. Examples ~~~~~~~~ To set the 'N' domain to the PDB file 'bax_N_1J7O_1st.pdb', type one of: relax> frame_order.domain_to_pdb('N', 'bax_N_1J7O_1st.pdb') relax> frame_order.domain_to_pdb(domain='N', pdb='bax_N_1J7O_1st.pdb') 
Set the pivot point for the two body motion in the structural coordinate system. Keyword Arguments ~~~~~~~~~~~~~~~~~ pivot: The pivot point for the motion (e.g. the position between the 2 domains in PDB coordinates). Examples ~~~~~~~~ To set the pivot point, type one of: relax> frame_order.pivot([12.067, 14.313, 3.2675]) relax> frame_order.pivot(pivot=[12.067, 14.313, 3.2675]) 
Set the reference domain for the '2domain' Frame Order theories. Keyword Arguments ~~~~~~~~~~~~~~~~~ ref: The domain which will act as the frame of reference. This is only valid for the '2domain' Frame Order theories. Description ~~~~~~~~~~~ Prior to optimisation of the '2domain' Frame Order theories, which of the two domains will act as the frame of reference must be specified. This is important for the attachment of cones to domains, etc. Examples ~~~~~~~~ To set up the isotropic cone frame order model with 'centre' domain being the frame of reference, type: relax> frame_order.ref_domain(ref='centre') 
Select and set up the Frame Order model. Keyword Arguments ~~~~~~~~~~~~~~~~~ model: The name of the preset Frame Order model. Description ~~~~~~~~~~~ Prior to optimisation, the Frame Order model should be selected. These models consist of three parameter categories:  The average domain position. This includes the parameters ave_pos_alpha, ave_pos_beta, and ave_pos_gamma. These Euler angles rotate the tensors from the arbitrary PDB frame of the moving domain to the average domain position.  The frame order eigenframe. This includes the parameters eigen_alpha, eigen_beta, and eigen_gamma. These Euler angles define the major modes of motion. The cone central axis is defined as the zaxis. The pseudoelliptic cone x and yaxes are defined as the x and yaxes of the eigenframe.  The cone parameters. These are defined as the tilttorsion angles cone_theta_x, cone_theta_y, and cone_sigma_max. The cone_theta_x and cone_theta_y parameters define the two cone opening angles of the pseudoellipse. The amount of domain torsion is defined as the average domain position, plus and minus cone_sigma_max. The isotropic cones are defined by setting cone_theta_x = cone_theta_y and converting the single parameter into a 2nd rank order parameter. The list of available models are: 'pseudoellipse'  The pseudoelliptic cone model. This is the full model consisting of the parameters ave_pos_alpha, ave_pos_beta, ave_pos_gamma, eigen_alpha, eigen_beta, eigen_gamma, cone_theta_x, cone_theta_y, and cone_sigma_max. 'pseudoellipse, torsionless'  The pseudoelliptic cone with the torsion angle cone_sigma_max set to zero. 'pseudoellipse, free rotor'  The pseudoelliptic cone with no torsion angle restriction. 'iso cone'  The isotropic cone model. The cone is defined by a single order parameter s1 which is related to the single cone opening angle cone_theta_x = cone_theta_y. Due to rotational symmetry about the cone axis, the average position alpha Euler angle ave_pos_alpha is dropped from the model. The symmetry also collapses the eigenframe to a single zaxis defined by the parameters axis_theta and axis_phi. 'iso cone, torsionless'  The isotropic cone model with the torsion angle cone_sigma_max set to zero. 'iso cone, free rotor'  The isotropic cone model with no torsion angle restriction. 'line'  The line cone model. This is the pseudoelliptic cone with one of the cone angles, cone_theta_y, assumed to be statistically negligible. I.e. the cone angle is so small that it cannot be distinguished from noise. 'line, torsionless'  The line cone model with the torsion angle cone_sigma_max set to zero. 'line, free rotor'  The line cone model with no torsion angle restriction. 'rotor'  The only motion is a rotation about the cone axis restricted by the torsion angle cone_sigma_max. 'rigid'  No domain motions. 'free rotor'  The only motion is free rotation about the cone axis. Examples ~~~~~~~~ To select the isotropic cone model, type: relax> frame_order.select_model(model='iso cone') 
Trees  Indices  Help 


Generated by Epydoc 3.0.1 on Wed Apr 10 13:31:51 2013  http://epydoc.sourceforge.net 