# OEResidue¶

class OEResidue


The OEResidue class is used to attach biopolymer information to each OEAtomBase object. This class contains a number of fields specific to processing macromolecules, such as proteins and nucleic acids. Each atom may be annotated with a unique OEResidue, hence OEResidue objects are not shared between different atoms. If the fields of an OEResidue associated with a single atom are updated, only that atom is affected.

Note

See section Biopolymer Residues for a detailed description of the data stored in an OEResidue.

## Constructors¶

OEResidue()


Default constructor.

OEResidue(const OEResidue &rhs)


Copy constructor.

## operator=¶

OEResidue &operator=(const OEResidue &rhs)


Assignment operator that copies the data of the ‘rhs’ OEResidue object into the right-hand side OEResidue object.

## operator bool¶

operator bool() const


Determines whether any field of an OEResidue has a non-default value.

## GetAlternateLocation¶

char GetAlternateLocation() const


Returns the ‘alternate location’ property of an atom in a residue. The ‘alternate location’ property may be set using the OEResidue.SetAlternateLocation method.

## GetBFactor¶

float GetBFactor() const


Returns the crystallographic ‘b-factor’ property of an atom in a residue. The ‘b-factor’ property may be set using the OEResidue.SetBFactor method.

## GetChainID¶

char GetChainID() const


Returns the ‘chain identifier’ property of a residue. The ‘chain identifier’ property may be set using the OEResidue.SetChainID method.

## GetFragmentNumber¶

int GetFragmentNumber() const


Returns the ‘fragment number’ property of a residue. Fragment numbers are integer indices that define connected components of a macromolecule. When reading from a PDB file, the first atom is placed in fragment number 1. Each time a TER, END or ENDM record is encountered within a single connection table, the fragment number is incremented. Similarly, when writing a PDB file, a TER record is written between any consecutive pair of atoms with different fragment numbers. The fragment number property may be set using the OEResidue.SetFragmentNumber number property.

## GetInsertCode¶

char GetInsertCode() const


Returns the ‘insertion code’ of a residue. Insertion codes are single character suffixes used to distinguish insertions when using a standardized residue numbering system. By default, this property contains a single space character, ' '. The insertion code property of a residue may be set using the OEResidue.SetInsertCode method.

## GetModelNumber¶

int GetModelNumber() const


Returns the ‘model number’ property of a residue. For NMR or molecular dynamics files, the model number contains the index of the NMR model or dynamics time-step within a file. The ‘model number’ property may be set using the OEResidue.SetModelNumber method.

## GetName¶

const char *GetName() const


Returns the ‘residue name’ property of a residue. The ‘residue name’ property may be set using the OEResidue.SetName method.

## GetOccupancy¶

float GetOccupancy() const


Returns the crystallographic ‘occupancy’ property of an atom in a residue. The default value is 1.0. The ‘occupancy’ property may be set using the OEResidue.SetOccupancy method.

## GetResidueNumber¶

int GetResidueNumber() const


Returns the ‘residue number’ property of a residue. The ‘residue number’ property may be set using the OEResidue.SetResidueNumber method.

## GetSecondaryStructure¶

int GetSecondaryStructure() const


Returns the protein ‘secondary structure’ property of a residue. The default value is zero. The ‘secondary structure’ property of a residue may be set using the OEResidue.SetSecondaryStructure method.

## GetSerialNumber¶

int GetSerialNumber() const


Returns the ‘atom serial number’ property of an atom in a residue. The ‘atom serial number’ property may be set using the OEResidue.SetSerialNumber method.

## IsHetAtom¶

bool IsHetAtom() const


Returns the ‘hetero atom’ property of an atom in a residue. The ‘hetero atom’ property may be set using the OEResidue.SetHetAtom method.

Note

A ‘hetero atom’ is distinguished from a ‘standard atom’ in a PDB file by using the record type HETATM rather than ATOM.

## SetAlternateLocation¶

bool SetAlternateLocation(char v)


Sets the ‘alternate location’ property of an atom in a residue. The default value is a space character. The ‘alternate location’ property of an atom in a residue may be retrieved using the OEResidue.GetAlternateLocation method.

## SetBFactor¶

bool SetBFactor(float v)


Sets the crystallographic ‘b-factor’ property of an atom in a residue. The default value is 0.0. The ‘b-factor’ property of an atom in a residue may be retrieved using the OEResidue.GetBFactor method.

## SetChainID¶

bool SetChainID(char v)


Sets the ‘chain identifier’ property of a residue. The default value is a space character. The ‘chain identifier’ property of a residue may be retrieved using the OEResidue.GetChainID method.

## SetFragmentNumber¶

bool SetFragmentNumber(int v)


Sets the fragment number property of a residue. Fragment numbers are integer indices that define the connected components of a macromolecule. When reading from a PDB file, the first atom is placed in fragment number 1. Each time a TER, END or ENDM record is encountered within a single connection table, the fragment number is incremented. Similarly, when writing a PDB file, a TER record is written between any consecutive pair of atoms with different fragment numbers. The default value is zero. The ‘fragment number’ property of a residue may be retrieved using the OEResidue.GetFragmentNumber method.

## SetHetAtom¶

bool SetHetAtom(bool v)


Set the ‘hetero atom’ property of an atom in a residue. The default value is false. The ‘hetero atom’ property of an atom in a residue may be retrieved using the OEResidue.IsHetAtom method.

## SetInsertCode¶

bool SetInsertCode(char v)


Sets the ‘insertion code’ of a residue. Insertion codes are single character suffices used to distinguish insertions when using a standardized residue numbering system. By default, this property contains a single space character ' '. The ‘insertion code’ property of a residue may be retrieved using the OEResidue.GetInsertCode method.

## SetModelNumber¶

bool SetModelNumber(int v)


Sets the model number property of a residue. For NMR or molecular dynamics files, the model number contains the index of the NMR model or dynamics time-step within a file. The default value is zero. The ‘model number’ property of a residue may be retrieved using the OEResidue.GetModelNumber method.

## SetName¶

bool SetName(const char *v)
bool SetName(const std::string &v)


Sets the ‘residue name’ property of a residue. The default value is MOL. The ‘residue name’ property of a residue may be retrieved using the OEResidue.GetName method.

## SetOccupancy¶

bool SetOccupancy(float v)


Sets the crystallographic ‘occupancy’ property of an atom in a residue. The default value is 1.0. The ‘occupancy’ property of an atom in a molecule may be retrieved using the OEResidue.GetOccupancy method.

## SetResidueNumber¶

bool SetResidueNumber(int v)


Sets the ‘residue number’ property of a residue. The default value is 1. The ‘residue number’ property of a residue may be retrieved using the OEResidue.GetResidueNumber method.

## SetSecondaryStructure¶

bool SetSecondaryStructure(int v)


Sets the protein ‘secondary structure’ property of a residue. The default value is zero. The ‘secondary structure’ property of a residue may be retrieved using the OEResidue.GetSecondaryStructure method.

## SetSerialNumber¶

bool SetSerialNumber(int v)


Sets the ‘atom serial number’ property of an atom in a residue. The default value is zero. The ‘atom serial number’ property may be retrieved using the OEResidue.GetSerialNumber method.