.. include:: ../substitutions

.. oe:namespace:: OEDepict

.. meta::
   :keywords: OESuppressNonDepictionHydrogens

.. _OEDepict_OESuppressNonDepictionHydrogens:


.. oe:function:: OESuppressNonDepictionHydrogens


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

      .. oe:api::

         bool OESuppressNonDepictionHydrogens(OEChem::OEMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

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

   The :oe:func:`OEDepict::OESuppressNonDepictionHydrogens` function
   suppresses all non-essential hydrogens of the molecule.
   Only the following hydrogens will be kept:

   * hydrogens with (non-zero) isotopic mass
   * hydrogens that are necessary to faithfully represent tetrahedral atom
     stereochemistry or cis/trans bond stereochemistry
     (defined by the :oe:func:`OEDepict::OEHasDepictionHydrogens` function).

   .. list-table::
      :widths: 200 200
      :header-rows: 1

      * - Before
        - After

      * - .. image:: ../images/OESuppressNonDepictionHydrogens-before.*
        - .. image:: ../images/OESuppressNonDepictionHydrogens-after.*


   .. seealso::

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

