OpenStructure
|
#include <entity_handle.hh>
Inherits EntityBase.
Friends | |
class | XCSEditor |
class | ICSEditor |
Related Functions | |
(Note that these are not member functions.) | |
DLLEXPORT_OST_MOL EntityHandle | CreateEntity () |
Additional Inherited Members | |
Protected Member Functions inherited from EntityBase | |
GenericPropContainerImpl * | GpImpl () |
const GenericPropContainerImpl * | GpImpl () const |
void | CheckValidity () const |
Protein or molecule.
Molecules such as proteins and ligands are all represented as entities in OpenStructure. To work with subsets of atoms, residues, chains and bonds, refer to EntityView
Entities consist of zero or more chains of residues. The interface of entities is tailored to proteins, but is not limited to that. An entity may also represent a ligand or a collection of water molecules - hence the rather generic name. A new, empty entity is created with CreateEntity(). Atoms, residues, chains and bonds are added,removed or manipulated via editors.
Definition at line 55 of file entity_handle.hh.
EntityHandle | ( | const impl::EntityImplPtr & | ) |
internally used ctor
EntityHandle | ( | ) |
default ctor. creates invalid handle.
void Apply | ( | EntityVisitor & | v | ) |
visitor interface
AtomHandleIter AtomsBegin | ( | ) | const |
Iterator pointing to the beginning of atoms.
AtomHandleIter AtomsEnd | ( | ) | const |
Iterator pointing to the end of atoms.
void AttachObserver | ( | const EntityObserverPtr & | ) |
attach observer
ChainHandleIter ChainsBegin | ( | ) | const |
Iterator pointing to the beginning of the chains.
ChainHandleIter ChainsEnd | ( | ) | const |
Iterator pointing to the end of the chains.
void ClearTransform | ( | ) |
remove transform
EntityHandle Copy | ( | ) | const |
copy entity, effectively duplicating the whole data structure
Alternative atom positions are not handled at all!
EntityView CreateEmptyView | ( | ) | const |
return a (new) empty view of this entity
EntityView CreateFullView | ( | ) | const |
return a (new) full view of this entity
void DeepSwap | ( | EntityHandle & | eh | ) |
deep swaps the implementations, effectively affecting all entity handles that point to either
void DetachObserver | ( | const EntityObserverPtr & | ) |
remove observer
ICSEditor EditICS | ( | EditMode | mode = UNBUFFERED_EDIT | ) | const |
Get editor for the internal coordinate system to manipulate torsions bond lengths and angles between bonds.
XCSEditor EditXCS | ( | EditMode | mode = UNBUFFERED_EDIT | ) | const |
Get editor for external coordinate system to manipulate atom positions.
AtomHandle FindAtom | ( | const String & | chain_name, |
const ResNum & | number, | ||
const String & | atom_name | ||
) | const |
ChainHandle FindChain | ( | const String & | name | ) | const |
Find chain by name.
Find chain within this entity with given name.
ResidueHandle FindResidue | ( | const String & | chain_name, |
const ResNum & | number | ||
) | const |
TorsionHandle FindTorsion | ( | const AtomHandle & | a1, |
const AtomHandle & | a2, | ||
const AtomHandle & | a3, | ||
const AtomHandle & | a4 | ||
) | const |
Search a specific torsion.
The order of atoms is important. For the torsion to exist, it must have been added before via AddTorsion.
AtomHandleList FindWithin | ( | const geom::Vec3 & | pos, |
Real | radius | ||
) | const |
use atom hash to perform fast within lookup
Real GetAngle | ( | const AtomHandle & | a1, |
const AtomHandle & | a2, | ||
const AtomHandle & | a3 | ||
) | const |
Get angle in radians between bonds a1-a2 and a2-a3.
Get angle in radians between bonds a1-a2 and a2-a3.
int GetAtomCount | ( | ) | const |
Get number of atoms of this entity.
To count the atoms of a specific chain or residue, use the respective method of ChainHandle and ResidueHandle.
AtomHandleList GetAtomList | ( | ) | const |
get complete list of atoms
geom::Vec3List GetAtomPosList | ( | bool | ordered_by_index = false | ) | const |
get complete list of atom positions
int GetBondCount | ( | ) | const |
Get number of bonds.
mol::BondHandleList GetBondList | ( | ) | const |
Get list of bonds.
geom::AlignedCuboid GetBounds | ( | ) | const |
geom::Vec3 GetCenterOfAtoms | ( | ) | const |
Get entity's center of atoms (not mass weighted)
Returns the center of all the atoms in an entity. This is similar to GetCenterOfMass(), but the atoms are not mass weighted
geom::Vec3 GetCenterOfMass | ( | ) | const |
Get entity's center of mass (mass weighted)
int GetChainCount | ( | ) | const |
Get number of chains of this entity.
ChainHandleList GetChainList | ( | ) | const |
Get list of chains.
QueryFlags GetDefaultQueryFlags | ( | ) | const |
return default query flags
EntityHandle GetHandle | ( | ) | const |
get this handle
Useful for templated code and duck-typing in Python
geom::Mat4 GetInvTransformationMatrix | ( | ) | const |
DEPRECATED.
Real GetMass | ( | ) | const |
Get entity's mass.
int GetResidueCount | ( | ) | const |
Get number of residues of this entity.
To count the atoms of a chain, use the GetResidueCount()
of ChainHandle
.
ResidueHandleList GetResidueList | ( | ) | const |
get complete list of residues
geom::Transform GetTransform | ( | ) | const |
retrieve transformation of this entity
geom::Mat4 GetTransformationMatrix | ( | ) | const |
DEPRECATED.
bool HasTransform | ( | ) | const |
checks whether a transform has been set
bool IsTransformationIdentity | ( | ) | const |
DEPRECATED.
bool operator!= | ( | const EntityHandle & | ref | ) | const |
bool operator== | ( | const EntityHandle & | ref | ) | const |
ResidueHandleIter ResiduesBegin | ( | ) | const |
Iterator pointing to the beginning of the residues.
The residues are first ordered by chain and then ascending residue number.
ResidueHandleIter ResiduesEnd | ( | ) | const |
Iterator pointing to the end of th residues.
The two iterators returned by ResiduesBegin() and ResiduesEnd() form a half-closed range. It is cheaper to cache the iterator returned by ResiduesEnd() than to call ResiduesEnd() after every loop, i.e. like @code
// e is an instance of EntityHandle for (ResidueHandleIter i=e.ResiduesBegin(), x=e.ResiduesEnd(); i!=x; ++i) { . . . }
EntityView Select | ( | const Query & | q | ) | const |
return view based on a query object
EntityView Select | ( | const String & | query_string | ) | const |
return view based on query String.
EntityView Select | ( | const Query & | q, |
QueryFlags | flags | ||
) | const |
return view based on a query object, specifying behavior flags
EntityView Select | ( | const String & | query_string, |
QueryFlags | flags | ||
) | const |
return view based on query String, specifying behavior flags
void SetDefaultQueryFlags | ( | QueryFlags | flags | ) |
set default query flags these will be used if flags are not explicitely specified as a second argument to a Select call
void SetTransform | ( | const geom::Transform & | t | ) |
set transformation that will affect this entity
void Swap | ( | EntityHandle & | eh | ) |
swaps implementations on the entity handle level
|
related |
create entity
|
friend |
Definition at line 58 of file entity_handle.hh.
|
friend |
Definition at line 57 of file entity_handle.hh.