********************************************************************************
Version 2.1.2
********************************************************************************

OEChem TK 2.1.2
================================================================================

New features
--------------------------------------------------------------------------------

* A new function, :oe:func:`OEChem::OEGetSmiStringOrder`, has been added to
  retrieve the atoms of a molecule in the order that they are encoded in the
  :term:`SMILES` string for that molecule.

* New methods :oe:meth:`OEChem::OELibraryGen::SetClearCoordinates` and
  :oe:meth:`OEChem::OEUniMolecularRxn::SetClearCoordinates` have been
  added to clear the coordinates of generated products.

Minor bug fixes
--------------------------------------------------------------------------------

* The function :oe:func:`OEChem::OECount` has been fixed to return the number
  of substructure search matches. An extra parameter has been added to control
  whether the count of unique or non-unique matches is returned.

* The following functions have been fixed to properly handle multi-conformer
  molecules with no active conformation:

  * :oe:meth:`OEChem::OEMolBase::SetDimension`
  * :oe:meth:`OEChem::OEMolBase::GetDimension`
  * :oe:meth:`OEChem::OEMolBase::SetEnergy`
  * :oe:meth:`OEChem::OEMolBase::GetEnergy`

* Several problems with the internal implementation of
  :oe:const:`OEChem::OEMolBaseType::OEMiniMol` have been fixed.  Perception
  flags are now cleared correctly when deleting atoms or bonds.  Coordinates
  are no longer lost when a molecule is swept.

* The :oe:func:`OEChem::OEGenerate2DCoordinates` function now clears MDL
  bond stereo that can be re-perceived by calling the
  :oe:func:`OEChem::OEMDLPerceiveBondStereo` function.

* The :oe:meth:`OEChem::OESubSearch::Init` method now checks that the given
  query molecule is valid. In case of an invalid molecule a warning is thrown
  and the method returns ``false``.

Python-specific changes
--------------------------------------------------------------------------------

* The message for the ``ValueError`` exception raised when trying to attach
  an unrecognized type to an **OpenEye** object as generic data has been
  clarified.

Documentation changes
--------------------------------------------------------------------------------

*  The documentation for the following APIs has been improved:

   * :oe:func:`OEChem::OEAddMols` function
   * :oe:func:`OEChem::OEWriteConstMolecule` function
   * :ref:`OEWriteMolecule <OEChem_OEWriteMolecule>` function
   * :oe:func:`OEChem::OEParseSmiles` function
   * :oe:func:`OEChem::OESubsetMol` function
   * :oe:constns:`OEChem::OEPDBAtomName` namespace

OEBio TK 2.1.2
================================================================================

New features
--------------------------------------------------------------------------------

* A new method, :oe:meth:`OEBio::OEInteractionHintContainer::DeleteInteraction`,
  has been added.

* The set of water orientations sampled by
  :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>`
  is now strictly based on local donor/acceptor interactions instead
  of the more generic quaternion sampling used previously.

* The following methods have been added to
  :oe:cls:`OEPlaceHydrogensOptions<OEBio::OEPlaceHydrogensOptions>` to
  control the optimization of conformations of moveable functional groups by
  :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>`:

  * :oe:meth:`SetBypassPredicate<OEBio::OEPlaceHydrogensOptions::SetBypassPredicate>`
  * :oe:meth:`SetFlipPredicate<OEBio::OEPlaceHydrogensOptions::SetFlipPredicate>`
  * :oe:meth:`SetNoFlipPredicate<OEBio::OEPlaceHydrogensOptions::SetNoFlipPredicate>`
  * :oe:meth:`GetBypassPredicate<OEBio::OEPlaceHydrogensOptions::GetBypassPredicate>`
  * :oe:meth:`GetFlipPredicate<OEBio::OEPlaceHydrogensOptions::GetFlipPredicate>`
  * :oe:meth:`GetNoFlipPredicate<OEBio::OEPlaceHydrogensOptions::GetNoFlipPredicate>`

* The new method :oe:meth:`OEBio::OEPlaceHydrogensMoverNote::IsRestrained`
  indicates whether a given moveable functional group has been restrained.

* Extended chelation interactions to cases where a protein is chelating a
  ligand metal.

* For interaction hints between any two atoms, implement a perception
  precedence as follows: ``Chelation`` > ``Charge`` > ``Hydrogen-bonding``.

* Added chelation perception to protein intramolecular interaction hints.
  See :oe:const:`OEBio::OEChelatorInteractionHintType::IntramolecularProtein`.

Major bug fixes
--------------------------------------------------------------------------------

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` results have been
  significantly improved after fixing a bug related to the treatment of
  certain non-moving background atoms.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` no longer fails
  with a segmentation fault when encountering an H-bond where there
  is a missing covalent bond. It also no longer fails in certain cases when
  adding explicit hydrogens.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` now uses a more concise
  definition of moveable groups and no longer fails due to matching atoms
  multiple times.

* The MMFF-NIE scoring system used by
  :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` now works with elements
  such as :oe:const:`Mn<OEChem::OEElemNo::Mn>` that are not parameterized
  in the MMFF94 force field.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` now generates correct
  hydrogen geometry on carboxylic acid (COOH) groups.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` no longer orients
  phenolic hydrogens at high angles to the ring plane.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` generates improved
  orientations for amines deprotonated upon chelating a metal.

Minor bug fixes
--------------------------------------------------------------------------------

* The ordering of :oe:cls:`moveable groups<OEBio::OEPlaceHydrogensMoverNote>`
  associated with a cluster in an
  :oe:cls:`OEPlaceHydrogensDetails<OEBio::OEPlaceHydrogensDetails>` object
  is now consistent across operating systems and platforms.

* :oe:func:`OEPlaceHydrogens<OEBio::OEPlaceHydrogens>` now produces fewer
  warning messages.

* Improved specificity of OEAcceptor definitions for interaction hint
  perception.
  
