OEMedChem TK 1.0.7
================================================================================

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

* The performance of appending segments of matched pair indices together
  has been significantly improved over previous versions. This activity is
  a common use-case with parallel index creation approaches.

* A new :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::GetMaxMolIdx` method has
  been added to make identifying the largest
  molecule index registered to a matched pair index more convenient.

* A new :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::GetMolecule` method has
  been added to make retrieving a molecule from the
  MMP index more convenient and to eliminate the need to maintain a separate
  :ref:`OEMolDatabase <OEChem_OEMolDatabase>` for this activity.

* A new :oe:func:`OEMedChem::OEApplyChEMBL24SolubilityTransforms`
  function has been added to return modified structures using
  `ChEMBL24 <https://www.ebi.ac.uk/chembl>`_ solubility data. The
  existing :oe:func:`OEMedChem::OEApplyChEMBL18SolubilityTransforms`
  API will be deprecated in future versions.

* A new indexing option,
  :oe:const:`OEMedChem::OEMatchedPairOptions::IndexHSingleCuts`, has
  been added to limit the H-member matched pair index information to
  single-cut transformations only.  The current
  :oe:const:`OEMedChem::OEMatchedPairOptions::IndexHSites` option will
  continue to provide H-member index information for all of single-,
  double-, or triple-cut transformations.
  :oe:const:`OEMedChem::OEMatchedPairOptions::IndexHSingleCuts` takes
  precedence over
  :oe:const:`OEMedChem::OEMatchedPairOptions::IndexHSites` if both
  options are provided.

New features (Preliminary API)
--------------------------------------------------------------------------------

* The following preliminary APIs have been added to provide fast multithreaded
  generation of matched pair indices:

  * :oe:func:`OEMedChem::OECreateMMPIndexFile` function
  * :ref:`OECreateMMPIndexOptions <OEMedChem_OECreateMMPIndexOptions>` option class
  * :ref:`OECreateMMPIndexStatus <OEMedChem_OECreateMMPIndexStatus>` class

* New :oe:func:`OEMedChem::OEReadMMPIndexMolecules` and
  :oe:func:`OEMedChem::OEWriteMMPIndexMolecules` functions have been
  implemented as preliminary APIs to support multithreaded and parallel
  matched pair index creation activities.

* New function overloads to
  :oe:func:`OEMedChem::OEMatchedPairGetTransforms` have been added to
  allow extracting transforms and related matched molecular pairs using 1 or
  more identified site(s) of substitution on a probe structure.

* New free functions and overloads,
  :oe:func:`OEMedChem::OEGetMatchedMolecularPairs`, have been added to
  allow extracting related matched molecular pairs using either a molecule ID or
  a probe structure with one or more identified site(s) of substitution.

API changes
--------------------------------------------------------------------------------

* A public class, :ref:`OEMatchedPairTransform <OEMedChem_OEMatchedPairTransform>`, has
  been altered to remove unnecessary implementation details.  Several
  of the methods exposed were previously inaccessible or unnecessary
  for wrapped language use.  The simplified API retains the common
  methods for interrogating the transforms and matched pairs returned
  from :oe:func:`OEMedChem::OEMatchedPairGetTransforms`. This is
  potentially a breaking API change.  For custom code using the
  removed methods, please contact support@eyesopen.com for details on
  migration activity that might be required.

* The ``OEMedChem::OEIsMCSFragDatabaseFiletype`` function has been
  renamed :oe:func:`OEMedChem::OEIsMCSFragDatabaseFileType` to
  follow **OpenEye Toolkit**'s naming scheme.

* The :oe:meth:`OEMedChem::OEMCSFragDatabase::CoreToMolecules`,
  :oe:meth:`OEMedChem::OEMCSFragDatabase::CoreToMoleculeCount`,
  :oe:meth:`OEMedChem::OEMCSFragDatabase::GetMaxCoreMolecule`,
  :oe:meth:`OEMedChem::OEMCSFragDatabase::GetMaxCoreMoleculeCount`,
  and :oe:meth:`OEMedChem::OEMCSFragDatabase::MoleculeToCores` methods and
  the :oe:func:`OEMedChem::OEMoleculeToCores` function have graduated
  from preliminary API to stable API status for the 2018.Oct release.

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

* The :oe:func:`OEMedChem::OEGetBemisMurcko` function has been
  corrected so that chain bonds between rings are no longer returned
  in the :oe:const:`OEMedChem::OERegionType::Ring` role sets.

* :oe:func:`OEMedChem::OEMatchedPairGetTransforms` has been fixed and
  no longer returns unusual matched pair transforms related to
  group bond-insertion changes.

* A bug that seemed to allow reactions to be added to a matched pair
  index has been fixed so that reaction input is now explicitly
  rejected.  Attempting to add a reaction to the index will now return
  a status of
  :oe:const:`OEMedChem::OEMatchedPairIndexStatus::NoStructure`.

* New options were added to :oe:constns:`OEMedChem::OEMatchedPairIndexStatus`
  to return additional indexing failure conditions.

* :oe:const:`OEMedChem::OEMatchedPairIndexStatus::NoFragmentationBonds`
  may now be returned from
  :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::AddMol` when the input
  structure has no fragmentation bonds, depending on the H-member
  indexing option in use.

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

* A new match pair index example has been added to demonstrate the
  creation of an MMP index via parallel processing using the Python
  `multiprocessing
  <https://docs.python.org/3/library/multiprocessing.html>`_ module.

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

* The MCS fragment database examples and match pair index examples
  have been modified to separate the index creation step from
  database query activities. See the list of currently available
  examples in the :ref:`oemedchem_chapter_examples` section.
