This module defines classes for handling residues.
Instances of this class point to atoms with same residue numbers (and insertion codes) and are generated by HierView class. Following built-in functions are customized for this class:
Indexing Residue instances by atom name (str()), e.g. "CA" returns an Atom instance.
Return index of the coordinate set.
Return active coordinate set label.
Return a copy of alternate location indicators. Alternate location indicators can be used in atom selections, e.g. 'altloc A B', 'altloc _'.
Return a copy of anisotropic temperature factors.
Return a copy of standard deviations for anisotropic temperature factors.
Return atom with given name, None if not found. Assumes that atom names in the residue are unique. If more than one atoms with the given name exists, the one with the smaller index will be returned.
Return associated atom group.
Return a copy of β-values (or temperature factors). β-values can be used in atom selections, e.g. 'beta 555.55', 'beta 0 to 500', 'beta 0:500', 'beta < 500'.
Return coordinate set labels.
Return a copy of partial charges. Partial charges can be used in atom selections, e.g. 'charge 1', 'abs(charge) == 1', 'charge < 0'.
Return a copy of chain identifiers. Chain identifiers can be used in atom selections, e.g. 'chain A', 'chid A B C', 'chain _'. Note that chid is a synonym for chain.
Return a copy of chain indices. Chain indices are assigned to subsets of atoms with distinct pairs of chain identifier and segment name. Chain indices start from zero, are incremented by one, and are assigned in the order of appearance in AtomGroup instance. Chain indices can be used in atom selections, e.g. 'chindex 0'.
Return a copy of coordinates from the active coordinate set.
Return coordinate set(s) at given indices, which may be an integer or a list/array of integers.
Return a copy of data associated with label, if it is present.
Return data labels. For which='user', return only labels of user provided data.
Return type of the data (i.e. data.dtype) associated with label, or None label is not used.
Return a copy of element symbols. Element symbols can be used in atom selections, e.g. 'element C O N'.
Return flag labels. For which='user', return labels of user or parser (e.g. hetatm) provided flags, for which='all' return all possible Atom Flags labels in addition to those present in the instance.
Return a copy of atom flags for given label, or None when flags for label is not set.
Return a copy of fragment indices. Fragment indices are assigned to connected subsets of atoms. Bonds needs to be set using AtomGroup.setBonds() method. Fragment indices start from zero, are incremented by one, and are assigned in the order of appearance in AtomGroup instance. Fragment indices can be used in atom selections, e.g. 'fragindex 0', 'fragment 1'. Note that fragment is a synonym for fragindex.
Return a copy of insertion codes. Insertion codes can be used in atom selections, e.g. 'icode A', 'icode _'.
Return a copy of the indices of atoms.
Return a copy of masses. Masses can be used in atom selections, e.g. '12 <= mass <= 13.5'.
Return a copy of names. Names can be used in atom selections, e.g. 'name CA CB'.
Return a copy of occupancy values. Occupancy values can be used in atom selections, e.g. 'occupancy 1', 'occupancy > 0'.
Return a copy of radii. Radii can be used in atom selections, e.g. 'radii < 1.5', 'radii ** 2 < 2.3'.
Return a copy of residue indices. Residue indices are assigned to subsets of atoms with distinct sequences of residue number, insertion code, chain identifier, and segment name. Residue indices start from zero, are incremented by one, and are assigned in the order of appearance in AtomGroup instance. Residue indices can be used in atom selections, e.g. 'resindex 0'.
Return a copy of residue names. Residue names can be used in atom selections, e.g. 'resname ALA GLY'.
Return a copy of residue numbers. Residue numbers can be used in atom selections, e.g. 'resnum 1 2 3', 'resnum 120A 120B', 'resnum 10 to 20', 'resnum 10:20:2', 'resnum < 10'. Note that resid is a synonym for resnum.
Return a copy of secondary structure assignments. Secondary structure assignments can be used in atom selections, e.g. 'secondary H E', 'secstr H E'. Note that secstr is a synonym for secondary.
Return a copy of segment indices. Segment indices are assigned to subsets of atoms with distinct segment names. Segment indices start from zero, are incremented by one, and are assigned in the order of appearance in AtomGroup instance. Segment indices can be used in atom selections, e.g. 'segindex 0'.
Return a copy of segment names. Segment names can be used in atom selections, e.g. 'segment PROT', 'segname PROT'. Note that segname is a synonym for segment.
Return a copy of serial numbers (from file). Serial numbers can be used in atom selections, e.g. 'serial 1 2 3', 'serial 1 to 10', 'serial 1:10:2', 'serial < 10'.
Return a copy of types. Types can be used in atom selections, e.g. 'type CT1 CT2 CT3'.
Return True if data associated with label is present.
Return True if flags associated with label are present.
Yield atoms.
Yield copies of coordinate sets.
Return number of atoms, or number of atoms with given flag.
Return number of coordinate sets.
Return atoms matching selstr criteria. See select module documentation for details and usage examples.
Set coordinates at index active.
Set alternate location indicators. Alternate location indicators can be used in atom selections, e.g. 'altloc A B', 'altloc _'.
Set anisotropic temperature factors.
Set standard deviations for anisotropic temperature factors.
Set β-values (or temperature factors). β-values can be used in atom selections, e.g. 'beta 555.55', 'beta 0 to 500', 'beta 0:500', 'beta < 500'.
Set partial charges. Partial charges can be used in atom selections, e.g. 'charge 1', 'abs(charge) == 1', 'charge < 0'.
Set chain identifiers. Chain identifiers can be used in atom selections, e.g. 'chain A', 'chid A B C', 'chain _'. Note that chid is a synonym for chain.
Set coordinates in the active coordinate set.
Update data associated with label.
| Raises AttributeError: | |
|---|---|
| when label is not in use or read-only | |
Set element symbols. Element symbols can be used in atom selections, e.g. 'element C O N'.
Update flag associated with label.
| Raises AttributeError: | |
|---|---|
| when label is not in use or read-only | |
Set insertion codes. Insertion codes can be used in atom selections, e.g. 'icode A', 'icode _'.
Set masses. Masses can be used in atom selections, e.g. '12 <= mass <= 13.5'.
Set names. Names can be used in atom selections, e.g. 'name CA CB'.
Set occupancy values. Occupancy values can be used in atom selections, e.g. 'occupancy 1', 'occupancy > 0'.
Set radii. Radii can be used in atom selections, e.g. 'radii < 1.5', 'radii ** 2 < 2.3'.
Set residue names. Residue names can be used in atom selections, e.g. 'resname ALA GLY'.
Set residue numbers. Residue numbers can be used in atom selections, e.g. 'resnum 1 2 3', 'resnum 120A 120B', 'resnum 10 to 20', 'resnum 10:20:2', 'resnum < 10'. Note that resid is a synonym for resnum.
Set secondary structure assignments. Secondary structure assignments can be used in atom selections, e.g. 'secondary H E', 'secstr H E'. Note that secstr is a synonym for secondary.
Set segment names. Segment names can be used in atom selections, e.g. 'segment PROT', 'segname PROT'. Note that segname is a synonym for segment.
Set serial numbers (from file). Serial numbers can be used in atom selections, e.g. 'serial 1 2 3', 'serial 1 to 10', 'serial 1:10:2', 'serial < 10'.
Set types. Types can be used in atom selections, e.g. 'type CT1 CT2 CT3'.