.. # split from OEBioFunctions.rst:766

.. include:: ../substitutions

.. oe:namespace:: OEBio

.. meta::
   :keywords: OESwapAIEResidueAtoms

.. oe:function:: OESwapAIEResidueAtoms

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

      .. oe:api::

         bool OESwapAIEResidueAtoms(OEChem::OEMolBase& mol, OEHierResidue& res)
         bool OESwapAIEResidueAtoms(OEChem::OEMCMolBase& mol,
                                    OEHierResidue& res)
         bool OESwapAIEResidueAtoms(OEChem::OEMolBase& mol,
                                    OEChem::OEAtomBase* atom,
                                    unsigned assume = OEAssumption::Default)
         bool OESwapAIEResidueAtoms(OEChem::OEMCMolBase& mol,
                                    OEChem::OEAtomBase* atom,
                                    unsigned assume = OEAssumption::Default)

   .. oe:language:: python

      .. oe:api:: python

         OESwapAIEResidueAtoms(mol: Union[OEGraphMol,OEQMol],
                               res: OEHierResidue) -> bool
         OESwapAIEResidueAtoms(mol: OEMol, res: OEHierResidue) -> bool
         OESwapAIEResidueAtoms(mol: Union[OEGraphMol,OEQMol], atom: OEAtomBase,
                               assume: int) -> bool
         OESwapAIEResidueAtoms(mol: OEMol, atom: OEAtomBase, assume: int) -> bool

   The function name :oe:func:`OEBio::OESwapAIEResidueAtoms` stands 
   for ``Swap Ambiguous Isoelectronic Residue Atoms``. 
   This high-level function allows a
   user to easily swap the residues in an atom which may not be fully
   specified by the crystallographic densities. The residues which are
   effected by this function include ASP, ASN, ASX, GLU, GLN, GLX,
   HIS, HIP, HID and HIE.

   The 'assume' argument is a bitmask that indicates whether the
   algorithm can assume that the molecule has perceived residues, has
   PDB ordered atoms, or as bonded residues 
   (see the :oe:constns:`OEBio::OEAssumption` namespace for more information).

