********************************************************************************
Version 2.1.5
********************************************************************************

OEChem TK 2.1.5
================================================================================

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

* New :oe:func:`OEChem::OEHasExplicitHydrogenExpression` and
  :oe:func:`OEChem::OEHasImplicitHydrogenExpression` functions have been added.

* The :oe:func:`OEChem::OEPrepareSearch` function now takes a parameter that determines
  whether to adjust the hydrogen of a target molecule based on the presence or absence
  of implicit and explicit hydrogens on the query molecule of the substructure
  search.

* Both :oe:func:`OEChem::OEGetSubtree` and :oe:func:`OEChem::OEGetSmallestSubtree` functions
  now take an optional max depth parameter that allows partial traversal of
  subtrees.
  For example, the parameter allows identification of the subtree of a proline residue without traversing back
  onto the main chain. Similarly, it is possible to get the subtree of a cysteine residue
  involved in a disulfide without traversing across the disulfide bond and back on the main chain.

* Two new constants, :oe:const:`OEChem::OEIFlavor::MDL::SuppressImp2ExpENHSTE` and
  :oe:const:`OEChem::OEOFlavor::MDL::SuppressImp2ExpENHSTE`,
  have been added with related MDL input and output formats (e.g., SDF, RDF)
  to allow suppression of explicit MDL stereogroup generation for implied
  stereocollection membership. By default, marked stereocenters not explicitly included in
  stereocollections are added to their implied stereocollection membership based on the chiral flag setting.

* A new :oe:const:`OEChem::OEGroupType::UserDefined` type has been added
  to :ref:`OEGroupBase <OEChem_OEGroupBase>` to support serialization and deserialization
  via the ``OEB`` format.

* A new :ref:`OEIsBridgeHead <OEChem_OEIsBridgeHead>` functor has been added to identify bridge
  head atoms in a molecule.

* A new :oe:func:`OEChem::OERingBondCount` function has been added that returns
  the number of bonds connected to an atom that are part of a ring.

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

* The FASTA reader has been fixed to support reading multiline FASTA strings.

* Generic data attached to :ref:`OEGroupBase <OEChem_OEGroupBase>` is no longer
  lost when the molecule is copied.

* Generic data attached to :ref:`OEGroupBase <OEChem_OEGroupBase>` is no longer
  lost when the molecule is added to another molecule by invoking the
  :oe:func:`OEChem::OEAddMols` function.

* Relative stereo (e.g., 1,4-disubstituted cyclohexanes) information is now preserved
  on input, ensuring that the conformers generated will respect the input stereochemistry.
  Previously, such relative stereocenters would be cleared during activities to
  clear other illegally marked stereochemistry.

* The V3000 MDL format readers called by :oe:func:`OEChem::OEReadMolecule` now support
  noncontiguous object indices.  It previously had been assumed that such indices
  were contiguous, but recent third-party writers have demonstrated that this assumption
  is no longer valid.

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

* The :oe:func:`OEChem::OEGenerate2DCoordinates` function now returns ``false`` when it
  fails to generate coordinates that are consistent with the atom/bond stereo of a
  molecule.

* A memory corruption issue in the InChI generation code that previously required a check
  for hydrogen isotopes beyond ``[3H]`` will no longer generate InChI for these
  unrealistic hydrogen isotopes.

* Malformed SD bond lines that lacked both atom endpoints had previously been ignored.
  :oe:func:`OEChem::OEReadMolecule` now fails for these types of format errors.

* :ref:`OEUniMolecularRxn <OEChem_OEUniMolecularRxn>` internal validations have been relaxed to allow
  reaction transformations that create a bond between two separate fragments.

* :oe:func:`OEChem::OEGetHybridization` has been repaired to return
  :oe:const:`OEChem::OEHybridization::sp3d` and :oe:const:`OEChem::OEHybridization::sp3d2`
  for high valence halogens.  Previously, this
  function had only returned :oe:const:`OEChem::OEHybridization::sp3` for these cases.

* :oe:func:`OEChem::OEUncolorMol` has been augmented to remove stereogroups when stripping
  atom stereochemistry.  Additionally, a new option,
  :oe:const:`OEChem::OEUncolorStrategy::RemoveGroupStereo`, has been added to support
  the explicit stripping of stereogroups.

* :ref:`OEAnd <OESystem_OEAnd>` and :ref:`OEOr <OESystem_OEOr>` have been augmented to support
  using :ref:`OEGroupBase <OEChem_OEGroupBase>` types to allow a more complex selection
  of MDL stereogroup types via custom predicates.

* A new copy constructor and new assignment operator have been added to
  :ref:`OERotMatrix <OEChem_OERotMatrix>`.

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

* Type comparisons between ``OEBase`` and non-``OEBase`` objects have been fixed
  to ensure that an exception is longer thrown.

* A new ``__str__()`` function has been added to :ref:`OEResidue <OEChem_OEResidue>` to provide
  a convenient string representation.

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

* A new ``OELibExtractor.GetTmpDirName()`` method has been added to
  return the temporary directory used for the extraction of native
  libraries from the JarFile and the extraction lock file. This
  directory location can potentially be used to clean up extraction
  locks that have been left behind due to inadvertent or explicit Java
  process kill activities.

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

* The documentation for :oe:const:`OEChem::OESMILESFlag::Hydrogens` has been clarified.

* The porphyrin footnote in the aromaticity table in the
  :ref:`Aromaticity Perception<chapter_aromaticity>`
  section has been clarified.

OEBio TK 2.1.5
================================================================================

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

* The following APIs have been added to perform Ramachandran analyses on protein
  structures:

  * :ref:`OERamachandranAnalysis <OEBio_OERamachandranAnalysis>` class
  * :oe:func:`OEBio::OEGetRamachandranTypeName` and :oe:func:`OEBio::OEGetRamachandranCategoryName`
    functions
  * :oe:constns:`OEBio::OERamaType` and  :oe:constns:`OEBio::OERamaCategory`
    namespaces

* A new :oe:const:`OEBio::OERotamerLibrary::Richardson_2016` constant has been added
  to provide rotamers from the ultimate rotamer library [Hintze-2016]_  .
  This new rotamer library is now the default.

* The following atom predicates have been added to identify RNA atoms:

  * :ref:`OEIsNucleicAcidBase <OEBio_OEIsNucleicAcidBase>`
  * :ref:`OEIsNucleicAcidSugar <OEBio_OEIsNucleicAcidSugar>`
  * :ref:`OEIsNucleicAcidPhosphate <OEBio_OEIsNucleicAcidPhosphate>`

* A new :oe:func:`OEBio::OESetRotamer` overload has been added that takes a residue atom.

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

* It is now possible to set an alternative rotamer on proline residues.

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

* **OEBio TK** now depends on **OEGrid TK**. As result,
  CMake files might need to be modified to reflect this library dependency.

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

* The Java wrapping of the following predicates has been fixed:

  * :ref:`OEIsCationPiInteractionHint <OEBio_OEIsCationPiInteractionHint>`
  * :ref:`OEIsCovalentInteractionHint <OEBio_OEIsCovalentInteractionHint>`
  * :ref:`OEIsIntermolecularChelatorInteractionHint <OEBio_OEIsIntermolecularChelatorInteractionHint>`

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

* The C# wrapping of the following predicates has been fixed:

  * :ref:`OEIsCationPiInteractionHint <OEBio_OEIsCationPiInteractionHint>`
  * :ref:`OEIsCovalentInteractionHint <OEBio_OEIsCovalentInteractionHint>`
  * :ref:`OEIsIntermolecularChelatorInteractionHint <OEBio_OEIsIntermolecularChelatorInteractionHint>`

OEPlatform TK 2.1.5
================================================================================

* Minor internal improvements have been made.

OESystem TK 2.1.5
================================================================================

* The :oe:func:`OESystem::OEWriteSettings` function now takes a 4th argument
  that specifies the name of an optimized parameter set for **OpenEye**'s
  applications.
