********************************************************************************
Version 2.1.3
********************************************************************************

OEChem TK 2.1.3
================================================================================

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

* The :term:`InChI` code has been updated to the v1.05 source released on
  January 27, 2017.  This code is available from the
  `InChI Trust <http://www.inchi-trust.org/downloads/>`_
  and was validated against
  `eMolecules <https://www.emolecules.com/info/products-data-downloads.html>`_
  and
  `ChEMBL_23 <https://www.ebi.ac.uk/chembl/downloads>`_
  public structure sources.

* :term:`InChI` is now a fully supported read/write format for chemical
  structures.  New public API points have been added to support this format:
  :oe:func:`OEChem::OEMolToSTDInChI`, :oe:func:`OEChem::OEMolToSTDInChIKey`,
  :oe:func:`OEChem::OEInChIToMol`, and :oe:func:`OEChem::OEParseInChI`.

.. warning::

  The standard InChI format includes chemical normalization activity that
  results in round-trip structure alterations to a very high percentage of
  structures when unnormalized or when arbitrary input chemistry is used.
  Even the output of :oe:func:`OEChem::OEMolToInChI`, which generates a
  nonstandard InChI and attempts to minimize structure normalizations, results
  in many changes to input chemical structures.

* :ref:`OEInChIOptions <OEChem_OEInChIOptions>` now supports relative stereo and
  racemic stereo :term:`InChI` output as well as control of the timeout
  condition.

* The default output flavor for writing :term:`InChI` or :term:`InChIKey` via
  :oe:func:`OEChem::OEWriteMolecule` has been changed to include the molecule
  title as well as the InChI information to synchronize behavior with
  other output formats.  Since the InChI identifiers never include white space,
  there should be no ambiguity for separating the InChI information from the
  title. If there are third-party readers that have problems with the title,
  the following output flavor bits are now available to control whether the
  title is added to the output: :oe:const:`OEChem::OEOFlavor::INCHI::Title` and
  :oe:const:`OEChem::OEOFlavor::INCHIKEY::Title`.

* An overload of :oe:func:`OEChem::OEShortestPath` has been added to take an
  atom predicate and return the shortest path between atoms that are not
  excluded by the predicate.

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

* :oe:func:`OEChem::OEParseSmiles` no longer throws an "Unable to
  Kekulize SMILES" warning in quiet mode (see also
  :ref:`OEParseSmilesOptions <OEChem_OEParseSmilesOptions>`).

* :oe:func:`OEChem::OEDeleteEverythingExceptTheFirstLargestComponent`
  has been reimplemented using :ref:`OEDetermineComponents <OEChem_OEDetermineComponents>` and
  no longer returns ``true`` for one-component molecules with explicit
  hydrogens.

* :oe:func:`OEChem::OEWriteMolecule` and :oe:func:`OEChem::OEWriteConstMolecule`
  now return the new :oe:const:`OEChem::OEWriteMolReturnCode::NoConformer`
  constant in cases when a multi-conformer molecule is being written
  without any conformer.

* :oe:func:`OEChem::OEGetSmiStringOrder` now has both a ``const`` and
  a ``non-const`` version.

* :oe:func:`OEChem::OEGetSmiStringOrder` could crash for structures
  that were modified by deleting atoms.  This has been fixed.

* The :oe:const:`OEChem::OESMILESFlag::AllBonds` flavor flag had been missing
  from the :oe:constns:`OEChem::OEOFlavor` namespace and has been added to the
  :oe:constns:`OEChem::OEOFlavor::SMI`, :oe:constns:`OEChem::OEOFlavor::ISM`,
  :oe:constns:`OEChem::OEOFlavor::CAN` and :oe:constns:`OEChem::OEOFlavor::USM`
  namespaces.

OESystem TK 2.1.3
================================================================================

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

* A new parameter has been added to the constructor of
  :ref:`OEDots <OESystem_OEDots>` that enables changing the "processed" label in
  the output lines.

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

* The function :oe:func:`OESystem::OEGetTag` and method
  :oe:meth:`OESystem::OEBase::GetData` could segfault when called with a
  null ``char *`` argument in C++ or with an empty argument in the wrapped
  languages.  These have been fixed.

OEBio TK 2.1.3
================================================================================

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

* :oe:func:`OEBio::OESetupSplitMolComplexOptions` now has
  two additional parameters, ``siteOverride`` and ``modelOverride``, that
  make it easier to configure filters while iterating over binding sites
  and/or model numbers. The new constant
  :oe:const:`OEBio::OESplitMolComplexParam::DoNotOverride`
  is used control the behavior of these constants.

* A new atom predicate, :ref:`OEIsWater <OEBio_OEIsWater>`, has been added.

* Two new methods, :oe:meth:`OEBio::OEInteractionHint::GetDetails` and
  :oe:meth:`OEBio::OEInteractionHint::SetDetails`, have been added.

* Two new interaction hint types have been added to interaction perceptions:
  :ref:`OECovalentInteractionHint <OEBio_OECovalentInteractionHint>` and
  :ref:`OECationPiInteractionHint <OEBio_OECationPiInteractionHint>`.  When covalent interactions
  are present, nearby clash interactions are no longer perceived.

* The :ref:`OECrystalSymmetryParams <OEBio_OECrystalSymmetryParams>` class now stores the Z-value
  parsed from the ``CRYST1`` line of a PDB file.

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

* :oe:cls:`OEBio::OEAltLocationFactory::GetGroups` no longer crashes on Windows
  in cases where no alternate location group exists.

* Calling the function :oe:func:`OEBio::OEBuildUnitCell` on protein molecules
  had previously consumed large amounts of memory and, as a result, would
  often crash.  This issue has been addressed, and the performance of the
  function has been improved for molecules of small or medium size.

* Interaction perception for anionic carbonyl groups has been fixed.

* :oe:func:`OEBio::OEIsValidActiveSite` now takes into account the non-default
  parameter ligand component type.

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

* An example in :ref:`section_example_oebio_proteinprep` has been modified
  to work properly when splitting a ligand from a binding site other
  than the first one.

OEGrid TK 1.6.0
================================================================================

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

* :oe:func:`OESystem::OEMaskGridByMolecule` no longer segfaults for an empty
  molecule or for a molecule without 2D coordinates.  It now throws a warning
  and returns ``false``.

* On Windows, UTF8 file and directory names are now correctly supported for
  toolkit file I/O operations.

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

* The following methods are now wrapped correctly as ``constCall``:

  * :oe:meth:`OEChem::OEIsRxnComponentGroup::operator()`
  * :oe:meth:`OEChem::OEIsReactantGroup::operator()`
  * :oe:meth:`OEChem::OEIsProductGroup::operator()`

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

* Read/write examples have been added to demonstrate the use of the
  :term:`InChI` structure format.

* Examples of using the preferred :oe:func:`OEChem::OEMolToSTDInChI` and
  :oe:func:`OEChem::OEMolToSTDInChIKey` API points when creating standard
  :term:`InChI` strings have been updated.

* Examples have been updated to now use
  :oe:func:`OEChem::OEDeleteEverythingExceptTheFirstLargestComponent`
  rather than the deprecated function
  :oe:func:`OEChem::OETheFunctionFormerlyKnownAsStripSalts`.

* The classes :ref:`OENearestNbrs <OEChem_OENearestNbrs>` and :ref:`OENbrs <OEChem_OENbrs>`,
  function :oe:func:`OEChem::OEGetNearestNbrs`, and namespace
  :oe:constns:`OEChem::OENearestNbrsMethod` have been documented.
