
.. include:: ../substitutions

.. oe:namespace:: OEProton

.. meta::
   :keywords: OEGetUniqueProtomer

.. oe:function:: OEGetUniqueProtomer

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

      .. oe:api::

         bool OEGetUniqueProtomer(OEChem::OEMolBase& dst,
                                  const OEChem::OEMolBase& mol)
         bool OEGetUniqueProtomer(OEChem::OEMCMolBase& dst,
                                  const OEChem::OEMCMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

         OEGetUniqueProtomer(dst: Union[OEGraphMol,OEMol,OEQMol],
                             mol: Union[OEGraphMol,OEMol,OEQMol]) -> bool
         OEGetUniqueProtomer(dst: OEMol, mol: OEMol) -> bool

   This function will attempt to produce a single protomer that can be used to generate
   a canonical representation of all tautomers of this molecule. All charge states or tautomer
   representations of a molecule should generate the same unique tautomer.

   .. note::

      The unique protomer is NOT necessarily the low energy tautomer, or a scientifically reasonable
      tautomer.  It is a tautomer useful for generating canonical hash strings. The unique protomer
      can be used to generate single or multiple protomers suitable for visualization by passing then
      through the :oe:func:`OEProton::OEGetReasonableTautomers` functions.

   .. seealso::

      * :oe:func:`OEProton::OEGetReasonableTautomers` function
