********************************************************************************
Version 2.0.7
********************************************************************************

OEChem 2.0.7
================================================================================


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

* :oe:func:`OEChem::OEGetPathLength` function's performance has been
  significantly improved.

* The APIs of the functions for accessing
  anisotropic B-factor parameters :oe:func:`OEChem::OEGetAnisou` and
  :oe:func:`OEChem::OESetAnisou` have been expanded for easier use
  in wrapped languages.
  The predicate :ref:`OEHasAnisou <OEChem_OEHasAnisou>` and the container object
  :ref:`OEAnisoUij <OEChem_OEAnisoUij>` have been added to support this functionality.

* The ability to request bond stereomark corrections to reduce
  the number of stereo-center correction warnings when reading MDL format files
  has been added.
  For more information, see :oe:func:`OEChem::OEMDLStereoFromBondStereo` function,
  :oe:const:`OEChem::OEIFlavor::SDF::FixBondMarks`,
  :oe:const:`OEChem::OEIFlavor::MDL::FixBondMarks`, and
  :oe:const:`OEChem::OEIFlavor::RDF::FixBondMarks` constants.

* 41 new ring templates have been added to the built-in ring dictionary.

  .. list-table:: **Example of the new 2D ring templates**

     * - **Carbon Skeleton**

     * - .. image:: ../../oechemtk/images/releasenotes-2.0.7/toolkits-2016-Jun-CarbonSkeletonTemplates.*
            :width: 400

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

* :oe:const:`OEChem::OEMCSType::Approximate` method for calculating the
  :ref:`maximum-common-substructure <section_patternmatch_mcss>` of two molecules
  will no longer leak memory.
  This memory leak was introduced in the
  :ref:`2015.Oct<toolkit_release_highlights_2015_Oct>` release.

* The following functions and methods will no longer crash when used after
  :oe:meth:`OEChem::oemolithread::open<OEChem::oemolstreambase::open>` or
  :oe:meth:`OEChem::oemolothread::open<OEChem::oemolstreambase::open>`, but
  will fail and return ``false``:

  - :oe:func:`OEChem::OEReadMolecule`
  - :oe:func:`OEChem::OEWriteMolecule`
  - :oe:meth:`OEChem::oemolthreadbase::PutMol`
  - :oe:meth:`OEChem::oemolthreadbase::GetMol`
  - :oe:meth:`OEChem::oemolthreadbase::PeekMol`

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

* The following problems have been fixed for reading V3000 MDL files:

  * :oe:func:`OEChem::OEReadMDLQueryFile` function has been
    generalized to more reliably identify a V3000 header and dispatch to
    the correct reader.

  * A parsing error for V3000 MDL files with an atom list has been fixed.

  * An issue with atom lists in V3000 format that resulted
    in the export of invalid atom symbols has been fixed.
    Atom lists will now export as "L" but
    will lose the original atom list information.
    Query features are not yet supported for molecule writing.

* A new warning will be issued for any V3000 MDL files that contain
  SCSR template information. This information is currently ignored.

* A new warning will be issued for any MDL files that contain
  Sgroup information or Rgroup definition. This information is currently ignored.

* An issue that occurred when valid cis/trans bond stereo were being converted
  to ``double either`` bonds in MDL reaction files has been corrected.
  This problem was introduced in the
  :ref:`2015.Oct<toolkit_release_highlights_2015_Oct>` release.

* The function to access anisotropic B-factor parameters
  :oe:func:`OEChem::OEGetAnisou` now sets all the parameters to ``0`` if no
  data is associated with the given atom, rather than leaving the parameters
  in an uninitialized state.
  The new predicate :ref:`OEHasAnisou <OEChem_OEHasAnisou>` can be used to determine if
  an atom has these parameters.

* :ref:`OEMCSSearch <OEChem_OEMCSSearch>` constructor no longer throws a warning when
  initialized with a molecule that has up-to-date ring perception information.

* :oe:func:`OEChem::OEAssignAromaticFlags` function now invalidates the
  hybridization perception flag since different aromaticity models affect
  the recorded hybridization values.

* Atom stereochemistry is more thoroughly examined and may result in multiple
  marks to the stereocenter(s) and/or marks to ring bond(s) for
  :oe:func:`OEChem::OEMDLStereoFromBondStereo` activity to reduce the number
  of ``Stereochemistry corrected ...`` warnings on re-read of the exported
  structure.

  .. list-table::

     * - .. image:: ../../oechemtk/images/releasenotes-2.0.7/OEMDLStereoFromBondStereo-2.*
            :width: 450


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

* Minor corrections to the :oe:constns:`OEChem::OEPerceived` namespace have been
  made.

OEBio 2.0.7
================================================================================

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

* :oe:func:`OEBio::OEPerceiveInteractionHints` function has been added to perceive
  possible ligand-protein interactions (contact, clash, hydrogen bond, salt-bridge,
  chelator, and aromatic ring stacking).

  The following classes and namespaces have been introduced to handle the new
  interaction types:

  * :ref:`OEClashInteractionHint <OEBio_OEClashInteractionHint>` class and corresponding
    :ref:`OEIsClashInteractionHint <OEBio_OEIsClashInteractionHint>` predicate

  * :ref:`OESaltBridgeInteractionHint <OEBio_OESaltBridgeInteractionHint>` class and corresponding
    :oe:constns:`OEBio::OESaltBridgeInteractionHintType` namespace and
    :ref:`OEIsSaltBridgeInteractionHint <OEBio_OEIsSaltBridgeInteractionHint>` predicate

  * :ref:`OEStackingInteractionHint <OEBio_OEStackingInteractionHint>` class and corresponding
    :oe:constns:`OEBio::OEStackingInteractionHintType` namespace and
    :ref:`OEIsStackingInteractionHint <OEBio_OEIsStackingInteractionHint>` predicate

* :oe:func:`OEBio::OEGetActiveSiteInteractionHintTypes` function has been added to
  return the interaction types perceived
  by the new :oe:func:`OEBio::OEPerceiveInteractionHints` function.

* :ref:`OECrystalSymmetryParams <OEBio_OECrystalSymmetryParams>` class has been added, along with
  overloaded versions of :oe:func:`OEBio::OEGetCrystalSymmetry` and
  :oe:func:`OEBio::OESetCrystalSymmetry` functions taking an
  :ref:`OECrystalSymmetryParams <OEBio_OECrystalSymmetryParams>` object.
  This is the recommended API to use in the wrapped languages.


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

* :oe:meth:`OEBio::OEMolComplexCategorizer::SetMaxPeptideResidues` method
  now properly sets the maximum number of residues that can be considered
  a peptide by :ref:`OEMolComplexCategorizer <OEBio_OEMolComplexCategorizer>`.

* Lower-case chain IDs are now supported by
  :oe:func:`OEBio::OESplitMolComplex` and related functions.

* :oe:func:`OEBio::OERMSD` now checks whether the
  match stored in the given :ref:`OESequenceAlignment <OEBio_OESequenceAlignment>` object is
  valid prior to attempting to calculate RMSD.

* An uninitialized memory problem that occurred when
  :oe:func:`OEBio::OEGetAlignment` failed to perceive an acceptable alignment
  has been fixed.

.. _oebio_fragment_network_deprecation:

Deprecated OEFragmentNetwork and related API
--------------------------------------------------------------------------------

The following warning will be thrown when using the above deprecated APIs:

.. warning::

   "Warning: OEFragmentNetwork is deprecated. Use OEInteractionHintContainer instead."

================================================= ===============================================================
Deprecated class                                  Replaced by
================================================= ===============================================================
`OEFragmentNetwork`                               :ref:`OEInteractionHintContainer <OEBio_OEInteractionHintContainer>`
`OEFragment`                                      :ref:`OEInteractionHintFragment <OEBio_OEInteractionHintFragment>`
`OEFragmentConnection`                            :ref:`OEInteractionHint <OEBio_OEInteractionHint>`
`OEFragmentConnectionTypeBase`                    :ref:`OEInteractionHintTypeBase <OEBio_OEInteractionHintTypeBase>`
`OEFragmentContactInteraction`                    :ref:`OEContactInteractionHint <OEBio_OEContactInteractionHint>`
`OEFragmentHBondInteraction`                      :ref:`OEHBondInteractionHint <OEBio_OEHBondInteractionHint>`
`OEFragmentChelatorInteraction`                   :ref:`OEChelatorInteractionHint <OEBio_OEChelatorInteractionHint>`
`OEComponentTypeBase`                             :ref:`OEInteractionHintComponentTypeBase <OEBio_OEInteractionHintComponentTypeBase>`
`OELigandComponentType`                           :ref:`OELigandInteractionHintComponent <OEBio_OELigandInteractionHintComponent>`
`OEProteinComponentType`                          :ref:`OEProteinInteractionHintComponent <OEBio_OEProteinInteractionHintComponent>`
================================================= ===============================================================

============================================= ===============================================================
Deprecated predicate                          Replaced by
============================================= ===============================================================
`OEHasConnection`                             :oe:constns:`OEBio::OEHasInteractionHint`
`OEHasConnectionType`                         :oe:constns:`OEBio::OEHasInteractionHintType`
`OEHasResidueConnection`                      :oe:constns:`OEBio::OEHasResidueInteractionHint`
`OEIsChelatorInteraction`                     :oe:constns:`OEBio::OEIsChelatorInteractionHint`
`OEIsHBondInteraction`                        :oe:constns:`OEBio::OEIsHBondInteractionHint`
`OEIsInterConnection`                         :oe:constns:`OEBio::OEIsInterInteractionHint`
`OEIsIntraConnection`                         :oe:constns:`OEBio::OEIsIntraInteractionHint`
============================================= ===============================================================


==================================================== ==============================================================================================
Deprecated function                                  Replaced by
==================================================== ==============================================================================================
`OEIsValidActiveSite(OEFragmentNetwork)`             :oe:func:`OEIsValidActiveSite(OEInteractionHintContainer)<OEBio::OEIsValidActiveSite>`
`OEGetConnections(OEMolBase,OEFragmentNetwork)`      :oe:func:`OEGetInteractions(OEMolBase,OEInteractionHintContainer)<OEBio::OEGetInteractions>`
`OEGetConnections(OEAtomBase,OEFragmentNetwork)`     :oe:func:`OEGetInteractions(OEAtomBase,OEInteractionHintContainer)<OEBio::OEGetInteractions>`
==================================================== ==============================================================================================


============================================= ===============================================================
Deprecated namespace                          Replaced by
============================================= ===============================================================
`OEFragmentHBondType`                         :oe:constns:`OEBio::OEHBondInteractionHintType`
`OEFragmentChelatorType`                      :oe:constns:`OEBio::OEChelatorInteractionHintType`
============================================= ===============================================================


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

* A link has been added from the :ref:`OEResidue <OEChem_OEResidue>` API documentation
  back to the :ref:`section_biopolymer_residues` section to better clarify details
  about residue data.

* A note has been added to the :oe:meth:`OEChem::OEResidue::IsHetAtom` documentation
  concerning heterogen atoms being distinguished by ``HETATM`` records in a PDB file.

* Java and C# versions of examples
  :ref:`section_example_oebio_splitmolcomplex` and
  :ref:`section_example_oebio_splitmolcomplexfrags`
  have been fixed.

* :ref:`section_example_oebio_printinteractions` example has
  been updated to use the new :ref:`OEInteractionHintContainer <OEBio_OEInteractionHintContainer>`
  class and corresponding API.


OESystem 2.0.7
================================================================================

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

* :oe:func:`OEMath::OEGeom3DRotate` template math function can now
  be used with :ref:`OEHalfFloat <OEPlatform_OEHalfFloat>` coordinate types.

OEPlatform 2.0.7
================================================================================

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

* ``OELIMITEDSTACK`` macro define value can now be controlled from
  compiler flags like ``-DOELIMITEDSTACK=0``. This allows projects to use the C++
  header files when compiling **OpenEye** C++ code
  for use with **OpenEye** Java toolkits.

  For more information on compiling custom **OpenEye** C++ code for use by
  **OpenEye** Java toolkit projects, see
  https://github.com/oess/oejava_extension.

