bool OESuppressHydrogens(OEMolBase &mol, bool retainPolar=false)
This function transforms the explicit hydrogens in a molecule into
implicit hydrogens on their parent heavy atom. Any explicit hydrogen
atoms, those with atomic number OEElemNo::H
, are deleted and any
information associated with them, co-ordinates, isotopes, generic
data etc... are lost. In their place, the implicit hydrogen count
field of the heavy atom to which they are bonded is appropriately
incremented. If the ``retainPolar'' flag is true, then hydrogens
on polar atoms, i.e. those for which
OEAtomBase::IsPolarHydrogen
returns true, are left unaffected.
This function returns the value true if any hydrogens were deleted, and returns false if the molecule was left unchanged.