.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEMolToSTDInChI

.. oe:function:: OEMolToSTDInChI

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

      .. oe:api::

         std::string OEMolToSTDInChI(const OEMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

         OEMolToSTDInChI(mol: Union[OEGraphMol,OEMol,OEQMol]) -> str

   Creates a standard InChI from a molecule.

   .. note::

      |InChIVersionID|

   .. table:: Success rate for **OEMolTo[STD]InChI/OEInChIToMol** to regenerate input structure ``SMILES``

      ============================ ========= =================== ============
      Database                     Size      Number of failures  Success Rate
      ============================ ========= =================== ============
      ChEMBL_23 (OEMolToSTDInChI)  1.7M      ~798K                53 %
      ChEMBL_23 (OEMolToInChI)     1.7M      ~92K                 95 %
      ============================ ========= =================== ============

   The round-trip failures relate to *InChI* structure normalization
   activities (charge, and/or bond rearrangements) that preclude the ability to recover
   an arbitrary molecule in its input form.

   .. seealso::

      * :oe:func:`OEChem::OEMolToInChI` function
      * :oe:func:`OEChem::OEInChIToMol` function
      * :oe:func:`OEChem::OECreateInChI` function
      * :oe:func:`OEChem::OEParseInChI` function
