.. include:: ../substitutions

.. oe:namespace:: OEProton

.. meta::
   :keywords: OEGetReasonableTautomers

.. _OEProton_OEGetReasonableTautomers:

.. oe:function:: OEGetReasonableTautomers

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

      .. oe:api::

         OESystem::OEIterBase<OEChem::OEMolBase>* OEGetReasonableTautomers(const OEChem::OEMolBase& mol,
                                                                           const OETautomerOptions& opts = OETautomerOptions(),
                                                                           bool pKaNorm = true)
         OESystem::OEIterBase<OEChem::OEMCMolBase>* OEGetReasonableTautomers(const OEChem::OEMCMolBase& mol,
                                                                             const OETautomerOptions& opts = OETautomerOptions(),
                                                                             bool pKaNorm = true)

   .. oe:language:: python

      .. oe:api:: python

         OEGetReasonableTautomers(mol: Union[OEGraphMol,OEQMol],
                                  opts: OETautomerOptions = OETautomerOptions(),
                                  pKaNorm: bool = True) -> Iterable[Union[OEGraphMol, OEMol, OEQMol]]
         OEGetReasonableTautomers(mol: OEMol,
                                  opts: OETautomerOptions = OETautomerOptions(),
                                  pKaNorm: bool = True) -> Iterable[OEMol]

   This function takes a const input molecule that is to be tautomerized and the tautomers are
   returned as an iterator over molecules. The function is overloaded to handle both
   single (:ref:`OEMolBase <OEChem_OEMolBase>`) and multi-conformer (:ref:`OEMCMolBase <OEChem_OEMCMolBase>`)
   molecules. Aromaticity must be perceived on the input molecule before calling this function.

   *mol*
      The molecule being tautomerized.

   *opts*
      The :ref:`OETautomerOptions <OEProton_OETautomerOptions>` object that stores
      properties that influence tautomerization process.

   *pKaNorm*
     This parameter determines whether to apply pKa normalization.
     If ``true`` the ionization state of each tautomer will be assigned to a predominate state at pH~7.4.

   .. oe:source:: EnumerateTautomersWithOptions.cpp
      :language: c++
      :noindent:
      :frag:     SNIPPET-EnumerateTautomersWithOptions
      :caption:  Example of tautomerizing a molecule

   .. oe:source:: EnumerateTautomersWithOptions.py
      :language: python
      :noindent:
      :frag:     SNIPPET-EnumerateTautomersWithOptions
      :caption:  Example of tautomerizing a molecule

   .. oe:source:: EnumerateTautomersWithOptions.java
      :language: java
      :noindent:
      :frag:     SNIPPET-EnumerateTautomersWithOptions
      :caption:  Example of tautomerizing a molecule

   .. oe:source:: EnumerateTautomersWithOptions.cs
      :language: csharp
      :noindent:
      :frag:     SNIPPET-EnumerateTautomersWithOptions
      :caption:  Example of tautomerizing a molecule

   .. seealso::

      * :oe:func:`OEProton::OEEnumerateTautomers` function
      * :oe:func:`OEProton::OEGetReasonableProtomer` function
      * :oe:func:`OEProton::OEGetReasonableProtomers` function
      * :ref:`section_examples_summary_enumeratetautomers` code example
