IMP logo
IMP Reference Guide  2.5.0
The Integrative Modeling Platform
IMP.pmi.topology.Molecule Class Reference

This class is constructed from within the State class. More...

+ Inheritance diagram for IMP.pmi.topology.Molecule:

Detailed Description

This class is constructed from within the State class.

It wraps an IMP.atom.Molecule and IMP.atom.Copy Structure is read using this class Resolutions and copies can be registered, but are only created when build() is called

Note
This class is only available in Python.

Definition at line 197 of file pmi/topology/__init__.py.

Public Member Functions

def __init__
 The user should not call this direclty, instead call State::create_molecule() More...
 
def add_representation
 handles the IMP.atom.Representation decorators, such as multi-scale, density, etc. More...
 
def add_structure
 Read a structure and store the coordinates. More...
 
def build
 Create all parts of the IMP hierarchy including Atoms, Residues, and Fragments/Representations and, finally, Copies /note Any residues assigned a resolution must have an IMP.atom.Residue hierarchy containing at least a CAlpha. More...
 
def create_clone
 Create a Molecule clone (automatically builds same structure and representation) More...
 
def create_copy
 Create a new Molecule with the same name and sequence but a higher copy number. More...
 
def get_atomic_residues
 Return a set of Residues that have associated structure coordinates. More...
 
def get_non_atomic_residues
 Return a set of Residues that don't have associated structure coordinates. More...
 
def get_residues
 Return all Residues as a set. More...
 
def residue_range
 get residue range. More...
 
- Public Member Functions inherited from IMP.pmi.topology.SystemBase
def build
 Build the coordinates of the system. More...
 

Constructor & Destructor Documentation

def IMP.pmi.topology.Molecule.__init__ (   self,
  state,
  name,
  sequence,
  chain_id,
  copy_num,
  mol_to_clone = None,
  transformation = None 
)

The user should not call this direclty, instead call State::create_molecule()

Parameters
stateThe parent PMI State
nameThe name of the molecule (string)
sequenceSequence (string)
mol_to_cloneThe original molecule (for cloning ONLY)
transformationA transform to apply during building (primarily for cloning)

Definition at line 204 of file pmi/topology/__init__.py.

Member Function Documentation

def IMP.pmi.topology.Molecule.add_representation (   self,
  res_set = None,
  representation_type = 'balls',
  resolutions = [] 
)

handles the IMP.atom.Representation decorators, such as multi-scale, density, etc.

Parameters
res_setset of PMI residues for adding the representation
representation_typecurrently supports only balls
resolutionswhat resolutions to add to the residues (see Resolution in PMI)

Definition at line 341 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.add_structure (   self,
  pdb_fn,
  chain_id,
  res_range = [],
  offset = 0,
  model_num = None,
  ca_only = False,
  soft_check = False 
)

Read a structure and store the coordinates.

Returns the atomic residues (as a set)

Parameters
pdb_fnThe file to read
chain_idChain ID to read
res_rangeAdd only a specific set of residues
offsetApply an offset to the residue indexes of the PDB file
model_numRead multi-model PDB and return that model
soft_checkIf True, it only warns if there are sequence mismatches between the pdb and the Molecules sequence If False (Default), it raises and exit when there are sequence mismatches.

ote After offset, we expect the PDB residue numbering to match the FASTA file

Definition at line 309 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.build (   self,
  merge_type = 'backbone',
  ca_centers = True,
  fill_in_missing_residues = True 
)

Create all parts of the IMP hierarchy including Atoms, Residues, and Fragments/Representations and, finally, Copies /note Any residues assigned a resolution must have an IMP.atom.Residue hierarchy containing at least a CAlpha.

For missing residues, these can be constructed from the PDB file

Parameters
merge_typePrinciple for grouping into fragments. "backbone": linear sequences along backbone are grouped into fragments if they have identical sets of representations. "volume": at each resolution, groups are made based on spatial distance (not currently implemented)
ca_centersFor single-bead-per-residue only. Set the center over the CA position.

Definition at line 358 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.create_clone (   self,
  chain_id,
  transformation = None 
)

Create a Molecule clone (automatically builds same structure and representation)

Parameters
chain_idIf you want to set the chain ID of the copy to something
transformationApply transformation after building (at the end)

Definition at line 295 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.create_copy (   self,
  chain_id 
)

Create a new Molecule with the same name and sequence but a higher copy number.

Returns the Molecule. No structure or representation will be copied!

Parameters
chain_idChain ID of the new molecule

Definition at line 285 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.get_atomic_residues (   self)

Return a set of Residues that have associated structure coordinates.

Definition at line 269 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.get_non_atomic_residues (   self)

Return a set of Residues that don't have associated structure coordinates.

Definition at line 277 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.get_residues (   self)

Return all Residues as a set.

Definition at line 262 of file pmi/topology/__init__.py.

def IMP.pmi.topology.Molecule.residue_range (   self,
  a,
  b,
  stride = 1 
)

get residue range.

Use integers to get 0-indexing, or strings to get PDB-indexing

Definition at line 253 of file pmi/topology/__init__.py.


The documentation for this class was generated from the following file: