.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEUncolorMol

.. oe:function:: OEUncolorMol

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

      .. oe:api::

         bool OEUncolorMol(OEChem::OEMolBase& uncoloredcmol,
                           const OEChem::OEMolBase& inputmol,
                           unsigned uncolortype = OEUncolorStrategy::Default)
         bool OEUncolorMol(OEChem::OEMCMolBase& uncoloredcmol,
                           const OEChem::OEMCMolBase& inputmol,
                           unsigned uncolortype = OEUncolorStrategy::Default)
         bool OEUncolorMol(OEChem::OEMolBase& moltouncolor,
                           unsigned uncolortype = OEUncolorStrategy::Default)
         bool OEUncolorMol(OEChem::OEMCMolBase& moltouncolor,
                           unsigned uncolortype = OEUncolorStrategy::Default)

   .. oe:language:: python

      .. oe:api:: python

         OEUncolorMol(uncoloredcmol: Union[OEGraphMol,OEMol,OEQMol],
                      mol: Union[OEGraphMol,OEMol,OEQMol], uncolortype: int) -> bool
         OEUncolorMol(uncoloredcmol: OEMol, mol: OEMol, uncolortype: int) -> bool
         OEUncolorMol(moltouncolor: Union[OEGraphMol,OEQMol], uncolortype: int) -> bool
         OEUncolorMol(moltouncolor: OEMol, uncolortype: int) -> bool

   The :oe:func:`OEChem::OEUncolorMol` function will remove chemical
   features from the output structure according to the
   :oe:constns:`OEChem::OEUncolorStrategy`.  The default strategy
   is :oe:const:`OEChem::OEUncolorStrategy::RemoveDimension` and
   :oe:const:`OEChem::OEUncolorStrategy::BemisMurcko`.

   For the function overloads that operate directly on the input molecule, the function returns ``true`` if
   uncoloring modifications were applied to the structure and ``false`` otherwise.
