You are reading the documentation for version 1.6 of OpenStructure. You may also want to read the documentation for:
1.1
1.2
1.3
1.4
1.5
1.7
1.7.1
1.8
1.9
1.10
1.11
2.0
2.1
2.2
devel

Parameters: 


Returns:  a tuple containing the counts of the conserved distances in the model and of all the checked distances 
LocalDistDiffTest
(alignment, tolerance, radius, ref_index=0, mdl_index=1)Calculates the Local Distance Difference Test score (see previous function) starting from an alignment between a reference structure and a model. The AlignmentHandle parameter used to provide the alignment to the function needs to have the two structures attached to it. By default the first structure in the alignment is considered to be the reference structure, and the second structure is taken as the model. This can however be changed by passing the indexes of the two structures in the AlignmentHandle as parameters to the function.
BEWARE: This function uses the old implementation of the Local Distance Difference Test algorithm and will give slightly different results from the new one.
Parameters: 


Returns:  the Local Distance Difference Test score 
LDDTHA
(model, distance_list, sequence_separation=0)¶This function calculates the Local Distance Difference Test, using the same threshold values as the GDTHA test (the default set of thresholds used for the lDTT score) (See previous functions). The thresholds are 0.5, 1, 2, and 4 Angstroms.
The function only compares the input distance list to the first chain of the model structure
The local residuebased lDDT score values are stored in the ResidueHandles of the model passed to the function in a float property called “locallddt”
A sequence separation parameter can be passed to the function. If this happens, only distances between residues whose separation is higher than the provided parameter are considered when computing the score.
Parameters: 


Returns:  the Local Distance Difference Test score 
DistanceRMSDTest
(model, distance_list, cap_difference, sequence_separation=0, local_drmsd_property_string="")¶This function performs a Distance RMSD Test on a provided model, and calculates the two values that are necessary to determine the Distance RMSD Score, namely the sum of squared distance deviations and the number of distances on which the sum was computed.
The Distance RMSD Test (or DRMSD Test) computes the deviation in the length of local contacts between a model and a reference structure and expresses it in the form of a score value. The score has an an RMSDlike form, with the deviations in the RMSD formula computed as contact distance differences. The score is openended, with a value of zero meaning complete agreement of local contact distances, and a positive value revealing a disagreement of magnitude proportional to the score value itself. This score does not require any superposition between the model and the reference.
This function processes a list of distances provided by the user, together with their length in the reference structure. For each distance that is found in the model, its difference with the reference length is computed and used as deviation term in the RMSDlike formula. When a distance is not present in the model because one or both the atoms are missing, a default deviation value provided by the user is used.
The function only processes distances between atoms that do not belong to the same residue, and considers only standard residues in the first chain of the model. For residues with symmetric sidechains (GLU, ASP, ARG, VAL, PHE, TYR), the naming of the atoms is ambiguous. For these residues, the function computes the Distance RMSD Test score that each naming convention would generate when considering all nonambiguous surrounding atoms. The solution that gives the lower score is then picked to compute the final Distance RMSD Score for the whole model.
A sequence separation parameter can be passed to the function. If this happens, only distances between residues whose separation is higher than the provided parameter are considered when computing the score
If a string is passed as last parameter to the function, the function computes the Distance RMSD Score for each residue and saves it as a float property in the ResidueHandle, with the passed string as property name. Additionally, the actual sum of squared deviations and the number of distances on which it was computed are stored as properties in the ResidueHandle. The property names are respectively <passed string>_sum (a float property) and <passed string>_count (an integer property)
Parameters: 


Returns:  a tuple containing the sum of squared distance deviations, and the number of distances on which it was computed. 
DRMSD
(model, distance_list, cap_difference, sequence_separation=0)¶This function calculates the Distance RMSD Test score (see previous function).
The local Local Distance Difference Test score values are stored in the ResidueHandles of the model passed to the function in a float property called “localdrmsd”
A sequence separation parameter can be passed to the function. If this happens, only distances between residues whose separation is higher than the provided parameter are considered when computing the score
Parameters: 


Returns:  the Distance RMSD Test score 
CreateDistanceList
(reference, radius)¶CreateDistanceListFromMultipleReferences
(reference_list, tolerance_list, sequence_separation, radius)¶Both these functions create lists of distances to be checked during a Local Distance Difference Test (see description of the functions above).
Both functions process only standard residues present in the first chain of the reference structures.
The only difference between the two functions is that one takes a single reference structure and the other a list of reference structures. The structures in the list have to be properly prepared before being passed to the function. Corresponding residues in the structures must have the same residue number, the same chain name, etc. Gaps are allowed and automatically dealt with: if information about a distance is present in at least one of the structures, it will be considered.
If a distance between two atoms is shorter than the inclusion radius in all structures in which the two atoms are present, it is included in the list. However, if the distance is longer than the inclusion radius in at least one of the structures, it is not considered to be a local interaction and is excluded from the list.
The multiplereference function takes care of residues with ambiguous symmetric sidechains. To decide which naming convention to use, the function computes a Local Distance Difference Test score for each reference against the first reference structure in the list, using only non ambiguouslynamed atoms. It picks then the naming convention that gives the highest score, guaranteeing that all references are processed with the correct atom names.
The cutoff list that will later be used to compute the Local Distance Difference Test score and the sequence separation parameter must be passed to the multireference function. These parameters do not influence the output distance list, which always includes all distances within the provided radius (to make it consistent with the singlereference corresponding function). However, the parameters are used when dealing with the naming convention of residues with ambiguous nomenclature.
Parameters: 


Returns: 
UniqueAtomIdentifier
¶Object containing enough information to uniquely identify an atom in a structure
UniqueAtomIdentifier
(chain, residue_number, residue_name, atom_name)¶Creates an UniqueAtomIdentifier object starting from relevant atom information
Parameters: 


GetChainName
()¶Returns the name of the chain to which the atom belongs, as a String
GetResidueName
()¶Returns the name of the residue to which the atom belongs, as a String
GetAtomName
()¶Returns the name of the atom, as a String
GetQualifiedAtomName
()¶Returns the qualified name of the atom (the chain name, followed by a unique residue identifier and the atom name. For example: “A.GLY2.CA”)
ResidueRDMap
¶Dictionarylike object containing the a list of distances that originate from the a single residue residue, to check during a run of the Local Distance Difference Test algorithm
GlobalRDMap
¶Dictionarylike object containing all the ResidueRDMap
objects related to residues
of a single structure
PrintResidueRDMap
(residue_distance_list)¶Prints to standard output all the distances contained in a ResidueRDMap
object
PrintGlobalRDMap
(global_distance_list)¶Prints to standard output all the distances contained in each of the ResidueRDMap
objects that
make up a GlobalRDMap
object
Swappable
(residue_name, atom_name)¶Parameters: 


Returns:  True if the atom has a symmetry equivalent, false otherwise 
SwappedName
(atom_name)¶If the atom does belongs to a residue with a symmetric sidechain and if the atom has a symmetry equivalent, the function returns the name of the symmetry equivalent atom, otherwise it returns the name of the original atom
Parameters:  atom_name – a string containing the name of the atom 

Returns:  A string containing the same of the symmetry equivalent atom if the input atom has one, otherwise the name of the input atom itself. 
The following function detects steric clashes in atomic structures. Two atoms are clashing if their euclidian distance is smaller than a threshold value (minus a tolerance offset).
FilterClashes
(entity, clashing_distances, always_remove_bb=False)¶This function filters out residues with nonbonded clashing atoms. If the clashing atom is a backbone atom, the complete residue is removed from the structure, if the atom is part of the sidechain, only the sidechain atoms are removed. This behavior is changed by the always_remove_bb flag: when the flag is set to True the whole residue is removed even if a clash is just detected in the sidechain.
The function returns a view containing all elements (residues, atoms) that have not been removed from the
input structure, plus a ClashingInfo
object containing information about the
detected clashes.
Two atoms are defined as clashing if their distance is shorter than the reference distance minus a tolerance threshold. The information about the clashing distances and the tolerance thresholds for all possible pairs of atoms is passed to the function as a parameter
Hydrogen and deuterium atoms are ignored by this function.
Parameters: 


Returns:  A tuple of two elements: The filtered 
CheckStereoChemistry
(entity, bond_stats, angle_stats, bond_tolerance, angle_tolerance, always_remove_bb=False)¶This function filters out residues with severe stereochemical violations. If the violation involves a backbone atom, the complete residue is removed from the structure, if it involves an atom that is part of the sidechain, only the sidechain is removed. This behavior is changed by the always_remove_bb flag: when the flag is set to True the whole residue is removed even if a violation is just detected in the sidechain
The function returns a view containing all elements (residues, atoms) that have not been removed from the input structure, plus a StereoChemistryInfo
object containing information about the detected stereochemical violations.
A violation is defined as a bond length that lies outside of the range: [mean_lengthstd_dev*bond_tolerance <> meanlength+std_dev*bond_tolerance] or an angle width lying outside of the range [mean_widthstd_dev*angle_tolerance <> mean_width+std_dev*angle_tolerance ]. The information about the mean lengths and widths and the corresponding standard deviations is passed to the function using two parameters.
Hydrogen and deuterium atoms are ignored by this function.
Parameters: 


Returns:  A tuple of two elements: The filtered 
ClashingInfo
¶This object is returned by the FilterClashes function, and contains information about the clashes detected by the function.
GetClashCount
()¶This method returns the number of clashes between nonbonded atoms detected in the input structure
GetAverageOffset
()¶This methods returns a value in Angstroms representing the average offset by which clashing atoms lie closer than the minimum acceptable distance (which of course differs for each possible pair of elements)
Returns:  the average offset, in Angstroms 

GetClashList
()¶Returns the list of detected interatomic clashes
Returns:  a list of ClashEvent objects 

ClashEvent
¶This object contains all the information relative to a single clash detected by the FilterClashes function
GetFirstAtom
()¶GetSecondAtom
()¶These two methods return the two atoms which clash
Returns:  UniqueAtomIdentifier 

GetModelDistance
()¶This method returns the distance between the two clashing atoms as observed in the model
Returns:  the distance in Angstroms between the two atoms 

GetAdjustedReferenceDistance
()¶This method returns the minimum acceptable distance between the two atoms involved in the clash, as defined in the ClashingDistances
class
Returns:  the minimum acceptable distance in Angstroms 

StereoChemistryInfo
¶This object is returned by the CheckStereoChemistry function, and contains information about bond lengths and planar angle widths in the structure that diverge from the parameters tabulated by Engh and Huber in the International Tables of Crystallography. Only elements that diverge from the tabulated value by a minimum number of standard deviations (defined when the CheckStereoChemistry function is called) are reported.
GetBadBondCount
()¶This method returns the number of bonds where a serious violation was detected
GetBondCount
()¶This method returns the total number of bonds in the structure checked by the CheckStereoChemistry function
GetAvgZscoreBonds
()¶This method returns the average zscore of all the bond lengths in the structure, computed using Engh and Huber’s mean and standard deviation values.
Returns:  The average zscore of bond lengths 

GetBadAngleCount
()¶This method returns the number of planar angles where a serious violation was detected
GetAngleCount
()¶This method returns the total number of planar angles in the structure checked by the CheckStereoChemistry function
GetAvgZscoreAngles
()¶This method returns the average zscore of all the planar angle widths, computed using Engh and Huber’s mean and standard deviation values.
Returns:  The average zscore of planar angle widths 

GetBondViolationList
()¶Returns the list of bond length violations detected in the structure
Returns:  a list of StereoChemicalBondViolation objects 

GetAngleViolationList
()¶Returns the list of angle width violations detected in the structure
Returns:  a list of StereoChemicalAngleViolation objects 

StereoChemicalBondViolation
¶This object contains all the information relative to a single detected violation of stereochemical parameters in a bond length
GetFirstAtom
()¶Returns the first atom of the bond
Returns:  UniqueAtomIdentifier 

GetSecondAtom
()¶Returns the first atom of the bond
Returns:  UniqueAtomIdentifier 

GetBondLength
()¶Returns the length of the bond as observed in the model
Returns:  the bond length in Angstroms 

GetAllowedRange
()¶Returns the allowed range of bond lengths, according to the Engh and Huber’s tabulated parameters and the tolerance threshold used when CheckStereoChemistry function was called
Returns:  a tuple containing the minimum and maximum allowed bond lengths in Angstroms 

StereoChemicalAngleViolation
¶This object contains all the information relative to a single detected violation of stereochemical parameters in a planar angle width
GetFirstAtom
()¶Returns the first atom that defines the planar angle
Returns:  UniqueAtomIndentifier 

GetSecondAtom
()¶Returns the vertex atom of the planar angle
Returns:  UniqueAtomIdentifier 

GetThirdAtom
()¶Returns the third atom that defines the planar angle
Returns:  UniqueAtomIdentifier 

GetAngleWidth
()¶Returns the width of the planar angle as observed in the model
Returns:  the angle width in degrees 

GetAllowedRange
()¶Returns the allowed range of angle widths, according to the Engh and Huber’s tabulated parameters and the tolerance threshold used when the CheckStereoChemistry function was called
Returns:  a tuple containing the minimum and maximum allowed angle widths in degrees 

ClashingDistances
¶Object containing information about clashing distances between nonbonded atoms
ClashingDistances
()¶Creates an empty distance list
SetClashingDistance
(ele1, ele2, clash_distance, tolerance)¶Adds or replaces an entry in the list
Parameters: 


GetClashingDistance
()¶Recovers a reference distance and a tolerance threshold from the list
Parameters: 


Returns:  a tuple containing the minimum clashing distance and the tolerance threshold 
GetAdjustedClashingDistance
()¶Recovers a reference distance from the list, already adjusted by the tolerance threshold
Parameters: 


Returns:  the adjusted minimum clashing distance 
GetMaxAdjustedDistance
()¶Returns the longest clashing distance in the list, after adjustment with tolerance threshold
IsEmpty
()¶Returns True if the list is empty (i.e. in an invalid, useless state)
PrintAllDistances
()¶Prints all distances in the list to standard output
StereoChemicalParams
¶Object containing stereochemical information about bonds and angles. For each item (bond or angle in a specific residue), stores the mean and standard deviation
StereoChemicalParams
()¶Creates an empty parameter list
SetParam
(item, residue, mean, standard_dev)¶Adds or replaces an entry in the list
Parameters: 


IsEmpty
()¶Returns True if the list is empty (i.e. in an invalid, useless state)
PrintAllParameters
()¶Prints all distances in the list to standard output
FillClashingDistances
(file_content)¶FillBondStereoChemicalParams
(file_content)¶FillAngleStereoChemicalParams
(file_content)¶These three functions fill a list of reference clashing distances, a list of stereochemical parameters for bonds and a list of stereochemical parameters for angles, respectively, starting from a the content of parameter file. The content of the file is passed to the function as a list of strings, each containing a line from the parameter file
Returns:  ClashingDistances and StereoChemicalParams respectively 

FillClashingDistancesFromFile
(filename)¶FillBondStereoChemicalParamsFromFile
(filename)¶FillAngleStereoChemicalParamsFromFile
(filename)¶These three functions fill a list of reference clashing distances, a list of stereochemical parameters for bonds and a list of stereochemical parameters for angles, respectively, starting from a file. The filename passed to the function can be a full path.
Returns:  ClashingDistances and StereoChemicalParams respectively 

DefaultClashingDistances
()¶DefaultBondStereoChemicalParams
()¶DefaultAngleStereoChemicalParams
()¶These three functions fill a list of reference clashing distances, a list of stereochemical parameters for bonds and a list of stereochemical parameters for angles, respectively, using the default parameter file distributed with OpenStructure.
Returns:  ClashingDistances and StereoChemicalParams respectively 

ResidueNamesMatch
(probe, reference)¶The function requires a reference structure and a probe structure. The function checks that all the residues in the reference structure that appear in the probe structure (i.e., that have the same ResNum) are of the same residue type. Chains are comapred by order, not by chain name (i.e.: the first chain of the reference will be compared with the first chain of the probe structure, etc.)
Parameters: 


Returns:  true if the residue names are the same, false otherwise 
ParseAtomNames
(atoms)¶Parses different representations of a list of atom names and returns a
set
, understandable by MatchResidueByNum()
. In
essence, this function translates
None
None
set(['N', 'CA', 'C', 'O'])
set(['aname1', 'aname2'])
['aname1', 'aname2']
to set(['aname1', 'aname2'])
Parameters:  atoms (str , list , set ) – Identifier or list of atoms 

Returns:  A set of atoms. 
MatchResidueByNum
(ent_a, ent_b, atoms='all')¶Returns a tuple of views containing exactly the same number of atoms. Residues are matched by residue number. A subset of atoms to be included in the views can be specified in the atoms argument. Regardless of what the list of atoms says, only those present in two matched residues will be included in the views. Chains are processed in the order they occur in the entities. If ent_a and ent_b contain a different number of chains, processing stops with the lower count.
Parameters: 


Returns:  Two 
MatchResidueByIdx
(ent_a, ent_b, atoms='all')¶Returns a tuple of views containing exactly the same number of atoms. Residues are matched by position in the chains of an entity. A subset of atoms to be included in the views can be specified in the atoms argument. Regardless of what the list of atoms says, only those present in two matched residues will be included in the views. Chains are processed in order of appearance. If ent_a and ent_b contain a different number of chains, processing stops with the lower count. The number of residues per chain is supposed to be the same.
Parameters: 


Returns:  Two 
MatchResidueByLocalAln
(ent_a, ent_b, atoms='all')¶Match residues by local alignment. Takes ent_a and ent_b, extracts the sequences chainwise and aligns them in Smith/Waterman manner using the BLOSUM62 matrix for scoring. The residues of the entities are then matched based on this alignment. Only atoms present in both residues are included in the views. Chains are processed in order of appearance. If ent_a and ent_b contain a different number of chains, processing stops with the lower count.
Parameters: 


Returns:  Two 
MatchResidueByGlobalAln
(ent_a, ent_b, atoms='all')¶Match residues by global alignment. Takes ent_a and ent_b, extracts the sequences chainwise and aligns them in Needleman/Wunsch manner using the BLOSUM62 matrix for scoring. The residues of the entities are then matched based on this alignment. Only atoms present in both residues are included in the views. Chains are processed in order of appearance. If ent_a and ent_b contain a different number of chains, processing stops with the lower count.
Parameters: 


Returns:  Two 
Superpose
(ent_a, ent_b, match='number', atoms='all', iterative=False, max_iterations=5, distance_threshold=3.0)¶Superposes the model entity onto the reference. To do so, two views are
created, returned with the result. atoms describes what goes into these
views and match the selection method. For superposition,
SuperposeSVD()
is called. For matching, the following methods
are recognised:
number
 select residues by residue number, includes atoms, calls
MatchResidueByNum()
index
 select residues by index in chain, includes atoms, calls
MatchResidueByIdx()
localaln
 select residues from a Smith/Waterman alignment, includes
atoms, calls MatchResidueByLocalAln()
globalaln
 select residues from a Needleman/Wunsch alignment, includes
atoms, calls MatchResidueByGlobalAln()
There is also an option to use iterative matching which allows for an iterative approach to superposing two structures. iterative takes two additional parameters, max_iteration and distance_threshold.
Parameters: 


Returns:  An instance of 
rmsd
 RMSD of the superposed entitiesview1
 First EntityView
usedview2
 Second EntityView
usedThis is a set of functions used for basic trajectory analysis such as extracting
positions, distances, angles and RMSDs. The organization is such that most
functions have their counterpart at the individual frame level
so that they can also be called on one frame instead
of the whole trajectory.
All these functions have a “stride” argument that defaults to stride=1, which is used to skip frames in the analysis.
SuperposeFrames
(frames, sel, from=0, to=1, ref=1)¶This function superposes the frames of the given coord group and returns them as a new coord group.
Parameters: 


Returns:  A newly created coord group containing the superposed frames. 
SuperposeFrames
(frames, sel, ref_view, from=0, to=1)Same as SuperposeFrames above, but the superposition is done on a reference view and not on another frame of the trajectory.
Parameters: 


Returns:  A newly created coord group containing the superposed frames. 
AnalyzeAtomPos
(traj, atom1, stride=1)¶This function extracts the position of an atom from a trajectory. It returns a vector containing the position of the atom for each analyzed frame.
Parameters: 


AnalyzeCenterOfMassPos
(traj, sele, stride=1)¶This function extracts the position of the centerofmass of a selection
(EntityView
) from a trajectory and returns it as a vector.
Parameters: 


AnalyzeDistanceBetwAtoms
(traj, atom1, atom2, stride=1)¶This function extracts the distance between two atoms from a trajectory and returns it as a vector.
Parameters: 


AnalyzeAngle
(traj, atom1, atom2, atom3, stride=1)¶This function extracts the angle between three atoms from a trajectory and returns it as a vector. The second atom is taken as being the central atom, so that the angle is between the vectors (atom1.posatom2.pos) and (atom3.posatom2.pos).
Parameters: 


AnalyzeDihedralAngle
(traj, atom1, atom2, atom3, atom4, stride=1)¶This function extracts the dihedral angle between four atoms from a trajectory and returns it as a vector. The angle is between the planes containing the first three and the last three atoms.
Parameters: 


AnalyzeDistanceBetwCenterOfMass
(traj, sele1, sele2, stride=1)¶This function extracts the distance between the centerofmass of two
selections (EntityView
) from a trajectory and returns it as
a vector.
Parameters: 


AnalyzeRMSD
(traj, reference_view, sele_view, stride=1)¶This function extracts the rmsd between two EntityView
and
returns it as a vector. The views don’t have to be from the same entity. The
reference positions are taken directly from the reference_view, evaluated only
once. The positions from the sele_view are evaluated for each frame.
If you want to compare to frame i of the trajectory t, first use
t.CopyFrame(i) for example:
eh=io.LoadPDB(...)
t=io.LoadCHARMMTraj(eh,...)
sele=eh.Select(...)
t.CopyFrame(0)
mol.alg.AnalyzeRMSD(t,sele,sele)
Parameters: 


AnalyzeMinDistance
(traj, view1, view2, stride=1)¶This function extracts the minimal distance between two sets of atoms (view1 and view2) for each frame in a trajectory and returns it as a vector.
Parameters: 


AnalyzeMinDistanceBetwCenterOfMassAndView
(traj, view_cm, view_atoms, stride=1)¶This function extracts the minimal distance between a set of atoms (view_atoms) and the center of mass of a second set of atoms (view_cm) for each frame in a trajectory and returns it as a vector.
Parameters: 


AnalyzeAromaticRingInteraction
(traj, view_ring1, view_ring2, stride=1)¶This function is a crude analysis of aromatic ring interactions. For each frame in a trajectory, it calculates the minimal distance between the atoms in one view and the center of mass of the other and vice versa, and returns the minimum between these two minimal distances. Concretely, if the two views are the heavy atoms of two rings, then it returns the minimal center of mass  heavy atom distance betweent he two rings
Parameters: 


mol.alg.helix_kinks
– Algorithms to calculate Helix Kinks¶CalculateHelixKink
(sele, proline=False)¶This function calculates the bend,wobble and faceshift angles in an alphahelix of an EntityView. The determination is more stable if there are at least 4 residues on each side (8 is even better) of the prolin around which the helix is kinked. The selection should contain all residues in the correct order and with no gaps and no missing Calphas.
Parameters: 


Returns:  A tuple (bend_angle, face_shift, wobble_angle). 
Return type:  (float, float, float) 
AnalyzeHelixKink
(t, sele, proline=False)¶This function calculates the bend,wobble and faceshift angles in an alphahelix over a trajectory. The determination is more stable if there are at least 4 residues on each side (8 is even better) of the proline around which the helix is kinked. The selection should contain all residues in the correct order and with no gaps and no missing Calphas.
Parameters: 


Returns:  A tuple (bend_angle, face_shift, wobble_angle). 
Return type:  (FloatList, FLoatList, FloatList) 
mol.alg.trajectory_analysis
– DRMSD, pairwise distances and more¶This Module requires numpy
This module contains functions to analyze trajectories, mainly similiraty measures baed on RMSDS and pairwise distances.
Author: Niklaus Johner (niklaus.johner@unibas.ch)
AverageDistanceMatrixFromTraj
(t, sele, first=0, last=1)¶This function calcultes the distance between each pair of atoms in sele, averaged over the trajectory t.
Parameters: 


Returns:  a numpy N_{pairs}xN_{pairs} matrix, where N_{pairs} is the number of atom pairs in sele. 
DistRMSDFromTraj
(t, sele, ref_sele, radius=7.0, average=False, seq_sep=4, first=0, last=1)¶This function calculates the distance RMSD from a trajectory. The distances selected for the calculation are all the distances between pair of atoms from residues that are at least seq_sep apart in the sequence and that are smaller than radius in ref_sel. The number and order of atoms in ref_sele and sele should be the same.
Parameters: 


Returns:  a numpy vecor dist_rmsd(N_{frames}). 
DistanceMatrixFromPairwiseDistances
(distances, p=2)¶This function calculates an distance matrix M(N_{frames}xN_{frames}) from the pairwise distances matrix D(N_{pairs}xN_{frames}), where N_{frames} is the number of frames in the trajectory and N_{pairs} the number of atom pairs. M[i,j] is the distance between frame i and frame j calculated as a pnorm of the differences in distances from the two frames (distanceRMSD for p=2).
Parameters: 


Returns:  a numpy N_{frames}xN_{frames} matrix, where N_{frames} is the number of frames. 
PairwiseDistancesFromTraj
(t, sele, first=0, last=1, seq_sep=1)¶This function calculates the distances between any pair of atoms in sele with sequence separation larger than seq_sep from a trajectory t. It return a matrix containing one line for each atom pair and N_{frames} columns, where N_{frames} is the number of frames in the trajectory.
Parameters: 


Returns:  a numpy N_{pairs}xN_{frames} matrix. 
RMSD_Matrix_From_Traj
(t, sele, first=0, last=1, align=True, align_sele=None)¶This function calculates a matrix M such that M[i,j] is the RMSD (calculated on sele) between frames i and j of the trajectory t aligned on sele.
Parameters: 


Returns:  Returns a numpy N_{frames}xN_{frames} matrix, where N_{frames} is the number of frames. 
mol.alg.structure_analysis
– Functions to analyze structures¶Some functions for analyzing structures
Author: Niklaus Johner (Niklaus.Johner@unibas.ch)
CalculateBestFitLine
(sele1)¶This function calculates the best fit line to the atoms in sele1.
Parameters:  sele1 (EntityView ) – 

Returns:  Line3 
CalculateBestFitPlane
(sele1)¶This function calculates the best fit plane to the atoms in sele1.
Parameters:  sele1 (EntityView ) – 

Returns:  Plane 
CalculateDistanceDifferenceMatrix
(sele1, sele2)¶This function calculates the pairwise distance differences between two selections (EntityView
).
The two selections should have the same number of atoms
It returns an NxN DistanceDifferenceMatrix M (where N is the number of atoms in sele1)
where M[i,j]=(sele2.atoms[i].possele2.atoms[j].pos)(sele1.atoms[i].possele1.atoms[j].pos)
Parameters: 


Returns:  NxN numpy matrix 
CalculateHelixAxis
(sele1)¶This function calculates the best fit cylinder to the CA atoms in sele1, and returns its axis. Residues should be ordered correctly in sele1.
Parameters:  sele1 (EntityView ) – 

Returns:  Line3 
GetAlphaHelixContent
(sele1)¶This function calculates the content of alpha helix in a view. All residues in the view have to ordered and adjacent (no gaps allowed)
Parameters:  sele1 (EntityView ) – 

Returns:  float 
GetDistanceBetwCenterOfMass
(sele1, sele2)¶This function calculates the distance between the centers of mass of sele1 and sele2, two selections from the same Entity.
Parameters: 


Returns: 

GetFrameFromEntity
(eh)¶This function returns a CoordFrame from an EntityHandle
Parameters:  eh (EntityHandle ) – 

Returns:  ost.mol.CoordFrame 
GetMinDistBetwCenterOfMassAndView
(sele1, sele2)¶This function calculates the minimal distance between sele2 and the center of mass of sele1, two selections from the same Entity.
Parameters: 


Returns:  distance ( 
GetMinDistanceBetweenViews
(sele1, sele2)¶This function calculates the minimal distance between sele1 and sele2, two selections from the same Entity.
Parameters: 


Returns: 

mol.alg
– Algorithms for Structures
mol.alg.helix_kinks
– Algorithms to calculate Helix Kinksmol.alg.trajectory_analysis
– DRMSD, pairwise distances and moremol.alg.structure_analysis
– Functions to analyze structuresEnter search terms or a module, class or function name.
conop
– Connectivity and Topology of Molecules
mol.alg
– Algorithms for Structures