.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEPerceiveResidues

.. oe:function:: OEPerceiveResidues

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

      .. oe:api::

         void OEPerceiveResidues(OEMolBase& mol,
                                 unsigned int stable = OEPreserveResInfo::None)

   .. oe:language:: python

      .. oe:api:: python

         OEPerceiveResidues(mol: Union[OEGraphMol,OEMol,OEQMol], stable: int) -> None

   Recognizes the protein and nucleic acid chains of a molecule and set
   the residue information for each atom appropriately.  The stable
   parameter is a bit-mask defined in the
   :oe:constns:`OEChem::OEPreserveResInfo` namespace that indicates if the
   residue numbers, residue names, or chain ID's should be preserved
   during the perception routine.  By default, no prior information is
   preserved.

