.. _section_examples_summary_enumeratetautomers:

Enumerating Tautomers
=========================================================

This following example shows a fast informatics technique using tautomer
enumeration which is capped at 200 states per molecule. Formal
charge of each input molecule is removed first, and then tautomers are
enumerated. The tautomers are saved to the output file after setting a favorable
ionization state at neutral pH.

Command Line Interface
----------------------

A description of the command line interface is shown as follows:

.. oe:language:: c++

   .. code-block:: console

      prompt> enumeratetautomers <mol-infile> <mol-outfile>

.. oe:language:: python

   .. code-block:: console

      prompt> python getreasonabletautomers.py <mol-infile> <mol-outfile>

.. oe:language:: java

   .. code-block:: console

      prompt> java EnumerateTautomers <mol-infile> <mol-outfile>

.. oe:language:: csharp

   .. code-block:: console

      prompt> EnumerateTautomers <mol-infile> <mol-outfile>

Code
--------------------------------------------------------------------------------

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

         :download:`getreasonabletautomers.py <../../../../wrappers/python/examples/quacpac/getreasonabletautomers.py>`

      .. literalinclude:: ../../../../wrappers/python/examples/quacpac/getreasonabletautomers.py

   .. only:: oepdf

      .. oe:source:: getreasonabletautomers.py
         :language: python

.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

         :download:`getreasonabletautomers.cpp <../../../../sublibs/tklibs/quacpac/examples/getreasonabletautomers.cpp>`

   .. only:: oepdf

      .. oe:source:: getreasonabletautomers.cpp
         :language: c++

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

         :download:`GetReasonableTautomers.java <../../../../wrappers/java/examples/openeye/examples/oequacpac/GetReasonableTautomers.java>`

   .. only:: oepdf

      .. oe:source:: GetReasonableTautomers.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

         :download:`GetReasonableTautomers.cs <../../../../wrappers/csharp/Csharp-Examples/OEQuacPac/GetReasonableTautomers.cs>`

   .. only:: oepdf

      .. oe:source:: GetReasonableTautomers.cs
         :language: csharp

.. seealso::

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