.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEPerceiveSymmetry

.. oe:function:: OEPerceiveSymmetry

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

      .. oe:api::

         bool OEPerceiveSymmetry(OEMolBase &, bool includeH = true,
                                 bool automorph = false)

   .. oe:language:: python

      .. oe:api:: python

         OEPerceiveSymmetry(mol: Union[OEGraphMol,OEMol,OEQMol],
                            includeH: bool = True, automorph: bool = False) -> bool

   Set the structural symmetry class of each atom of the given molecule.
   Symmetry classes are numbered sequentially from one up to the maximum
   number of atoms in the molecule for totally asymmetric molecules.
   The assigned symmetry class for each atom may be retrieved using the
   :oe:meth:`OEChem::OEAtomBase::GetSymmetryClass` method.

   The 'includeH' parameter is used to specify whether implicit hydrogens
   should be considered distinct from explicit hydrogens.
   Normally, a molecule will have all hydrogens either implicitly represented or
   explicitly represented so this option shouldn't affect symmetries.

