.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEAtomGetResidue

.. oe:function:: OEAtomGetResidue

   .. oe:language:: c++ java csharp

      .. oe:api::

         const OEResidue& OEAtomGetResidue(const OEAtomBase* atm)

   .. oe:language:: python

      .. oe:api:: python

         OEAtomGetResidue(atm: OEAtomBase) -> OEResidue

   This function is used to retrieve the :ref:`OEResidue <OEChem_OEResidue>`
   associated with an :ref:`OEAtomBase <OEChem_OEAtomBase>`.  The
   :ref:`OEResidue <OEChem_OEResidue>` class is used to store information used in
   biopolymer processing, *e.g.* proteins and nucleic acids, on a per-atom
   basis.

   .. seealso::

      * :ref:`OEResidue <OEChem_OEResidue>` class
      * :oe:func:`OEChem::OEHasResidue` function
      * :oe:func:`OEChem::OEAtomSetResidue` function
