OE3DToAtomStereo¶
bool OE3DToAtomStereo(OEMolBase &mol)
Set the stereochemistry at the chiral atoms of a molecule, as
specified by the molecule’s 3D coordinates. The affected atoms are
those with a ‘chiral’ atom property of true, as perceived by a call
to OEPerceiveChiral, or set manually by the user
calling the OEAtomBase.SetChiral method. If no
chirality has been perceived on the molecule,
OEPerceiveChiral will be called inside this
function.
This function will return false immediately, if the dimension of
the molecule is not found to be 3.
The OE3DToAtomStereo function throws a warning
and returns false at the end, if the geometry of any of the chiral atoms
of the given molecule is not tetrahedral i.e. if the atom stereo
can not be determined from the coordinates.
After stereochemistry is set
SetPerceived is called with
the OEPerceived_AtomStereo flag set to
true. Subsequent calls to OE3DToAtomStereo will
return true immediately as the value of
HasPerceived is checked on
entry. Stereochemistry can be forced to be reperceived by setting the
OEPerceived_AtomStereo flag to false.