********************************************************************************
Version 2.1.4
********************************************************************************

OEChem TK 2.1.4
================================================================================

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

* Two new overload functions, ``OEChem::OEReadMolFromString`` and
  ``OEChem::OEWriteMolToString``, have been added to specify
  input or output flavors from the
  :oe:constns:`OEChem::OEIFlavor` and :oe:constns:`OEChem::OEOFlavor`
  namespaces.

* A new class, :ref:`OE2DRingDictionaryCreatorOptions <OEChem_OE2DRingDictionaryCreatorOptions>`,
  has been added to customize generating user-defined ring template
  dictionaries.

* A new constructor, :ref:`OE2DRingDictionary <OEChem_OE2DRingDictionary>`, has been added
  that takes an :ref:`OE2DRingDictionaryCreatorOptions <OEChem_OE2DRingDictionaryCreatorOptions>` option
  class as a parameter.

* A new function, :oe:func:`OEChem::OEClear2DRingDictionary`, has been
  added to clear the global user-defined ring dictionary used for 2D
  coordinate generation.

* A new function, :oe:func:`OEChem::OESet2DHydrogenGeom`, has been added
  to assign approximate 2D coordinates to explicit hydrogen atoms.

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

* The ``OEChem::OEReadMolFromString`` and
  ``OEChem::OEWriteMolToString`` functions use internal buffers for
  the encoding or decoding of molecules from bytes.  Previously, depending
  on library load order, internal buffers could be initialized without the
  complete set of binary input/output handlers.  This could result in the
  loss of custom datatypes when translating to or from bytes.
  These internal buffers now are updated during subsequent loads of
  **OpenEye** libraries to ensure that the complete set of custom datatypes
  is handled correctly.

* The implementations of ``OEChem::OEDBMol`` and
  ``OEChem::OEMiniMol`` have been corrected to avoid a potential crash
  after an :oe:meth:`OEChem::OEMolBase::Compress` and
  :oe:meth:`OEChem::OEMolBase::UnCompress` call sequence when the molecule
  contains :ref:`OEGroupBase <OEChem_OEGroupBase>` objects (e.g., reaction component
  information or V3000 enhanced stereo information).  While the
  ``OEChem::OEMiniMol`` supports :ref:`OEGroupBase <OEChem_OEGroupBase>` objects,
  it cannot save and restore following
  :oe:meth:`OEChem::OEMolBase::Compress` and
  :oe:meth:`OEChem::OEMolBase::UnCompress` calls, so this class must never be
  used if :ref:`OEGroupBase <OEChem_OEGroupBase>` information is to be maintained.
  The ``OEChem::OEDBMol`` implementation is the preferred class for
  low memory footprint applications when :ref:`OEGroupBase <OEChem_OEGroupBase>`
  may be present.

* When writing a 2D molecule with explicit hydrogens to an MDL file,
  the coordinates of the stereo hydrogens are now reassigned by
  calling the :ref:`OESet2DHydrogenGeom <OEChem_OESet2DHydrogenGeom>` function
  if they are identical to their parent heavy atom coordinates.
  This ensures that reinterpretation of the MDL file does not
  inadvertently flip stereo configurations.

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

* The algorithm used by :oe:func:`OEChem::OEGenerate2DCoordinates` to
  detect and resolve atom clashes when generating 2D coordinates has
  been improved.

* When calling the :oe:func:`OEChem::OERMSD` function for a multi conformer
  fit molecule, the returned RMSD array will now have a -1.0 value for
  conformation indices that are not valid for the fit molecule.

* The :oe:func:`OEChem::OEAssignAromaticFlags` function now limits the search
  path to 30 bonds when the bond/atom ratio is higher than 1.3.
  As a result, buckyball-like molecules can be processed in reasonable time.

C++-specific changes
--------------------------------------------------------------------------------

* A deprecated overload of the :oe:func:`OEChem::OEPRECompress` function,
  ``OEPRECompress(OEMol &, const OEMCMolBase &)``, has been removed from
  the C++ API.  :oe:func:`OEFastROCS::OEPrepareFastROCSMol` should now be
  used to create molecules optimized for **ROCS**-type calculations.
  The documentation has been updated to reflect this change.

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

* Two new overload functions, :ref:`OEReadMolFromBytes <OEChem_OEReadMolFromBytes>` and
  :ref:`OEWriteMolToBytes <OEChem_OEWriteMolToBytes>`, have been added to specify
  input or output flavors from the :oe:constns:`OEChem::OEIFlavor` and
  :oe:constns:`OEChem::OEOFlavor` namespaces.

* A crash in the Python interpreter due to malformed UTF-8 input character
  sequences has been fixed.

* Binary data now can be safely attached to objects as generic data without
  being truncated at a ``\0`` character.


Java-specific changes
--------------------------------------------------------------------------------

* Two new overload functions, ``OEChem::OEReadMolFromByteArray`` and
  ``OEChem::OEWriteMolToByteArray``, have been
  added to specify input or output flavors from
  the :oe:constns:`OEChem::OEIFlavor` and :oe:constns:`OEChem::OEOFlavor`
  namespaces.

C#-specific changes
--------------------------------------------------------------------------------

* Two new overload functions, :ref:`OEReadMolFromBytes <OEChem_OEReadMolFromBytes>` and
  :ref:`OEWriteMolToBytes <OEChem_OEWriteMolToBytes>`, have been
  added to specify input or output flavors from
  the :oe:constns:`OEChem::OEIFlavor` and :oe:constns:`OEChem::OEOFlavor`
  namespaces.

* A minor issue with the C# ``verify.py`` script that caused the
  validation to halt if one or more toolkit licenses was missing from the
  active license file has been fixed.

OESystem TK 2.1.4
================================================================================

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

* The :ref:`OEColor <OESystem_OEColor>` constructor and
  :oe:meth:`OESystem::OEColor::SetRGBA`
  method now throw warnings for a null pointer.

OEBio TK 2.1.4
================================================================================

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

* A new method, :oe:meth:`OEBio::OEInteractionHintFragment::GetAtom`,
  has been added.

* A new predicate, :ref:`OEIsIntermolecularChelatorInteractionHint <OEBio_OEIsIntermolecularChelatorInteractionHint>`,
  has been added.

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

* The :ref:`OEIsChelatorInteractionHint <OEBio_OEIsChelatorInteractionHint>` predicate has been fixed to
  recognize the
  :oe:const:`OEBio::OEChelatorInteractionHintType::IntramolecularProtein` type.

* The :oe:const:`OEBio::OEHBondInteractionHintType::Clash` type has
  been deprecated and replaced with
  :oe:const:`OEBio::OEHBondInteractionHintType::ClashAcceptorAcceptor` and
  :oe:const:`OEBio::OEHBondInteractionHintType::ClashDonorDonor` types.

* The :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedLigand` type
  has been deprecated and replaced with
  :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedLigandPositive`
  and
  :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedLigandNegative`
  types.

* The :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedProtein`
  type has been deprecated and replaced with
  :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedProteinPositive`
  and
  :oe:const:`OEBio::OESaltBridgeInteractionHintType::UnpairedProteinNegative`
  types.

* The implementation of :oe:const:`OEBio::OEHBondInteractionHintType::Clash`
  has been corrected to use proper geometric constraints in determining these
  unfavorable interactions.  In addition,
  :oe:const:`OEBio::OEHBondInteractionHintType::Clash`
  has been split into
  :oe:const:`OEBio::OEHBondInteractionHintType::ClashDonorDonor` and
  :oe:const:`OEBio::OEHBondInteractionHintType::ClashAcceptorAcceptor`
  to provide more specificity.  These interactions are assigned only after
  other stronger or more favorable interactions have been assessed.
  Finally, hydrogen-bonding interaction clashes will not be assigned to
  groups that could avoid the interaction with a simple hydrogen rotation.
