********************************************************************************
Version 2.1.0
********************************************************************************

OEChem 2.1.0
================================================================================

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

* The :oe:const:`OEB<OEChem::OEFormat::OEB>` format has been
  extended to support MDL enhanced stereogroup information.

* The :oe:const:`OEB<OEChem::OEFormat::OEB>` format has been enhanced
  to support reaction atom-atom mapping and reaction component information.

* The :ref:`OEGroupBase <OEChem_OEGroupBase>` API has been augmented to support reaction
  component information.  In addition, new predicates have been added to
  loop over the new :ref:`OEGroupBase <OEChem_OEGroupBase>` collection types. See
  :oe:meth:`OEChem::OEGroupBase::IsEmpty`,
  :oe:meth:`OEChem::OEGroupBase::GetGroupDefinition`,
  :ref:`OEHasGroupType <OEChem_OEHasGroupType>`,
  :ref:`OEIsRxnComponentGroup <OEChem_OEIsRxnComponentGroup>`,
  :ref:`OEIsReactantGroup <OEChem_OEIsReactantGroup>`,
  :ref:`OEIsProductGroup <OEChem_OEIsProductGroup>`.

* The :oe:const:`SDF<OEChem::OEFormat::SDF>` reader is now
  more tolerant of molfile header lines that exceed the specification
  maximum of 80 characters.  A warning is issued on read and the longer
  lines are truncated to 80 characters on write to prohibit generating files
  that do not meet the format specification.

* New functions for computing weighted RMS deviation between pairs of
  Cartesian coordinates, molecules, and partial molecules have been added.
  See :oe:func:`OEChem::OEWeightedRMSD` for details.

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

* The tag used to identify style data in :oe:const:`OEB<OEChem::OEFormat::OEB>`
  files has been changed.  The old tag was not updated when the data structure
  was modified last year.  As a result,
  :oe:const:`OEB<OEChem::OEFormat::OEB>` files with style data that were
  generated before 2015.Jun cannot be read with more recent toolkits.
  Data with the old tag will be ignored.  Since style data is only used
  internally, we do not anticipate any read problems with
  :oe:const:`OEB<OEChem::OEFormat::OEB>` files generated by our customers.
   
* Functions :oe:func:`OEChem::OEGetFileExtension` and
  :oe:func:`OEChem::OEIsGZip` now recognize capitalized extensions
  (for example, ``.GZ``).

* Several problems with the internal implementation of 
  :oe:const:`OEChem::OEMolBaseType::OEMiniMol` have been fixed.

* A problem in the :oe:const:`SDF<OEChem::OEFormat::SDF>` reader where
  uninitialized memory was being accessed during the perception of V3000
  reaction files has been fixed.

* A problem in the :oe:const:`SDF<OEChem::OEFormat::SDF>` writer relating
  to relative stereochemistry has been fixed.  Previously, the writer
  incorrectly exported an input V3000 format file as a V2000 format output,
  resulting in the incorrect promotion of racemic stereocollection information
  to absolute stereochemistry.

* A problem with the :oe:const:`MOL2<OEChem::OEFormat::MOL2>` reader
  that limited input lines to 80 characters has been fixed.
  The reader now supports 512 character lines for this format.

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

.. oe:language:: c++

   * The :oe:func:`OEChem::OEWriteMolToString` function has been overloaded to
     take a string reference argument into which a molecule is encoded.

.. oe:language:: csharp java python

   * New overloads of ``OEChem::OEWriteMolToString`` in C++ allow more
     efficient encoding of molecules to strings.

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

.. oe:language:: python

  * :ref:`OEWriteMolToBytes <OEChem_OEWriteMolToBytes>` takes advantage of the new
    overloaded versions of the ``OEChem::OEWriteMolToString`` C++
    functions to improve encoding performance.

.. oe:language:: c++ java csharp

  * Python functions ``OEChem::OEWriteMolToBytes`` take advantage of the
    new overloaded versions of the ``OEChem::OEWriteMolToString`` C++
    functions to improve encoding performance.

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

* Examples have been added to the :ref:`SMARTS<section_SMARTS_examples>`
  chapter that illustrate how to match specified and unspecified stereocenters.

* The description of :ref:`oemolistream <OEChem_oemolistream>` formats has been clarified.

OEBio 2.1.0
================================================================================

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

* :oe:func:`OEBio::OEPlaceHydrogens` is a new function that adds hydrogens to
  a molecule and builds hydrogen bonding networks, flipping amide and imidazole
  groups if necessary.

* The following API has been added to customize and improve the perception
  of potential protein-ligand interactions:
 
  * :ref:`OEPerceiveInteractionOptions <OEBio_OEPerceiveInteractionOptions>` class
  * :ref:`OEHalogenBondInteractionHint <OEBio_OEHalogenBondInteractionHint>` class
  * :ref:`OEIsHalogenBondInteractionHint <OEBio_OEIsHalogenBondInteractionHint>` predicate
  * :ref:`OEIsIntermolecularHBondInteractionHint <OEBio_OEIsIntermolecularHBondInteractionHint>` predicate
  * :ref:`OEIsIntramolecularHBondInteractionHint <OEBio_OEIsIntramolecularHBondInteractionHint>` predicate
  * :oe:constns:`OEBio::OEHalogenBondInteractionHintType` namespace (new)
  * :oe:constns:`OEBio::OESaltBridgeInteractionHintType` namespace (extended)
  * :oe:constns:`OEBio::OEHBondInteractionHintType` namespace (extended)

* A variant of the :oe:func:`OEBio::OESplitMolComplex` function enables a more
  efficient two-step process. The function
  :oe:func:`OEBio::OEGetMolComplexFragments`
  analyzes a molecule and returns an :ref:`OEAtomBondSet <OEChem_OEAtomBondSet>`
  vector describing the role of each fragment. Functions
  :oe:func:`OEBio::OECombineMolComplexFragments` and
  :oe:func:`OEBio::OEFilterMolComplexFragments` then use this information
  to create new subset molecules.

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

* The class :ref:`OEMolComplexCategorizer <OEBio_OEMolComplexCategorizer>` now recognizes small
  peptides.

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

* The function :oe:func:`OEBio::OEClearMolComplexSDData` now correctly
  identifies data by tag prefixes.

* The function :oe:func:`OEBio::OEHasCrystalSymmetry` now returns ``false``
  if the molecule has a default ``CRYST1`` record. PDB format rules lead to
  these default records, which should be interpreted to mean the molecule has
  no symmetry record.

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

* The description of the output parameters for the function
  :oe:func:`OEBio::OEExpandCrystalSymmetry` has been improved.

* The :ref:`chapter_protein_prep` chapter has been expanded and an example, 
  :ref:`section_example_oebio_proteinprep`, has been added.

* The file type in the warning associated with the functions
  :oe:func:`OEBio::OESplitMolComplex` and
  :oe:func:`OEBio::OEGetMolComplexComponents` has been clarified.

OEPlatform 2.1.0
================================================================================

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

* Functions :oe:func:`OEPlatform::OESetAllocaThreshold` and
  :oe:func:`OEPlatform::OEGetAllocaThreshold` have been added to
  manage stack memory usage.  Rather than keeping track of stack usage, which
  impacts performance, the new functions set/get the threshold for the
  largest single allocation from the stack.  Above the threshold, memory
  is allocated from the heap.  Although this only indirectly controls total
  stack usage, it is lightweight and can help mitigate stack memory problems.
