.. include:: ../../toolkit-substitutions
.. include:: ../substitutions

.. oe:namespace:: OEDepict

.. meta::
   :keywords: OEAddDepictionHydrogens

.. _OEDepict_OEAddDepictionHydrogens:


.. oe:function:: OEAddDepictionHydrogens


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

      .. oe:api::

         bool OEAddDepictionHydrogens(OEChem::OEMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

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

   Adds explicit "depiction" hydrogens to the specified
   :ref:`OEMolBase <OEChem_OEMolBase>`.
   Depiction hydrogens are hydrogens that need to be explicitly drawn
   in a 2D depiction to faithfully represent tetrahedral
   atom stereochemistry or cis/trans bond stereochemistry.

   The :oe:func:`OEDepict::OEAddDepictionHydrogens` function identifies
   all implicit depiction hydrogens (using the
   :oe:func:`OEDepict::OEHasDepictionHydrogens` function), and converts
   them into explicit hydrogens using the
   :oe:func:`OEChem::OEAddExplicitHydrogens` function.
   This function returns true if any depiction hydrogens were
   converted into explicit atoms.

   .. seealso::

      * :oe:func:`OEDepict::OEHasDepictionHydrogens` function
      * :oe:func:`OEDepict::OESuppressNonDepictionHydrogens` function
