OEMedChem TK 1.0.0
================================================================================

Licensing changes
--------------------------------------------------------------------------------

* In preparation for new licensing requirements for **OEMedChem TK**, license
  checks have been added to :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>` constructor.
  Visit https://www.eyesopen.com/contact if you need a license for matched pair activities.

.. _section_releasenotes_OEMedChem_100:

OEMedChem functionalities
--------------------------------------------------------------------------------

This is the first official release of **OEMedChem** functionalities, previously
released in beta form.
An overview of its capabilities is provided below.

Matched molecular pair analysis
--------------------------------------------------------------------------------

A powerful analysis engine and functions support the identification
of matched molecular pairs that differ by both heavy-atom and hydrogen-atom substitutions.
Additionally, the analyzer supports the ability to be saved and
restored to disk or stream.
The analyzer includes the following functions:

- :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>`
- :oe:func:`OEMedChem::OEMatchedPairApplyTransforms`
- :oe:func:`OEMedChem::OEReadMatchedPairAnalyzer`
- :oe:func:`OEMedChem::OEWriteMatchedPairAnalyzer`

- :ref:`OEMatchedPairAnalyzerOptions <OEMedChem_OEMatchedPairAnalyzerOptions>`
- :oe:func:`OEMedChem::OEConfigureMatchedPairIndexOptions`
- :oe:func:`OEMedChem::OESetupMatchedPairIndexOptions`

Functions and classes are provided to allow extraction and inspection of transformations based on
matched molecular pairs found during structure indexing as well as the specific matched pairs
and data associated with those transformations:

- :ref:`OEMatchedPair <OEMedChem_OEMatchedPair>`
- :ref:`OEMatchedPairTransform <OEMedChem_OEMatchedPairTransform>`
- :oe:func:`OEMedChem::OEMatchedPairGetTransforms`

ChEMBL18 solubility data has been indexed with the matched pair analyzer to modify
input structures according to the solubility transforms and to annotate modified structures
with the net change in solubility data from ChEMBL:

- :oe:func:`OEMedChem::OEApplyChEMBL18SolubilityTransforms`

Fragmentation and perception capabilities
--------------------------------------------------------------------------------

The following functions are provided to return perceived regions for fragmentation strategies:

- :oe:func:`OEMedChem::OEGetBemisMurcko`
- :oe:func:`OEMedChem::OEGetFuncGroupFragments`
- :oe:func:`OEMedChem::OEGetRegionTypeName`
- :oe:func:`OEMedChem::OEGetRegionType`
- :oe:func:`OEMedChem::OEGetRingChainFragments`
- :oe:func:`OEMedChem::OEGetRingLinkerSideChainFragments`

Belief theory
--------------------------------------------------------------------------------

Functions are provided to return information for belief theory usage based on [Muchmore-2008]_:

- :oe:func:`OEMedChem::OECalculateComboBelief`
- :oe:func:`OEMedChem::OECalculateETComboBelief`

Similarity
--------------------------------------------------------------------------------

Functions are provided to return the graph-edit similarity used in clustering BROOD hitlists:

- :oe:func:`OEMedChem::OECreateIDString`
- :oe:func:`OEMedChem::OECreateIDStrings`

Complexity measures
--------------------------------------------------------------------------------

Functions are provided to return individual terms that make up the molecular complexity as defined by [Bertz-1981]_:

- :oe:func:`OEMedChem::OEDetermineConnectiveComplexity`
- :oe:func:`OEMedChem::OEDetermineElementalComplexity`
- :oe:func:`OEMedChem::OEDetermineMolecularComplexity`
- :oe:func:`OEMedChem::OEDetermineSymmetryComplexity`
- :oe:func:`OEMedChem::OENormalMolecularComplexity`

Functions are provided to return a ring complexity measure similar to that defined by [Gasteiger-1979]_:

- :oe:func:`OEMedChem::OEDetermineRingComplexity`
- :oe:func:`OEMedChem::OEGetRingValue`

Functions are provided to return a measure of stereo complexity as defined by [Boda-2007]_:

- :oe:func:`OEMedChem::OEDetermineStereoComplexity`
- :oe:func:`OEMedChem::OENormalStereoComplexity`

A function is provided to return a measure of the total molecular complexity, which is a
sum of the provided individual complexity measures:

- :oe:func:`OEMedChem::OETotalMolecularComplexity`

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

* As a result of a minor bug fix in **OEChem TK**,
  :oe:func:`OEMedChem::OEDetermineStereoComplexity`,
  :oe:func:`OEMedChem::OENormalStereoComplexity`, and
  :oe:func:`OEMedChem::OENormalStereoComplexity` functions might return slightly different
  values for molecules containing transition metals, lanthanides, or actinides.

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

* New documentation code snippets for C++, Java, and C# have been added to demonstrate
  matched pair index creation, serialization, and deserialization.

* Examples have been updated to allow explicit specification of the ``mmpMinPairThreshold``
  arguments for :oe:func:`OEMedChem::OEMatchedPairApplyTransforms` and
  :oe:func:`OEMedChem::OEApplyChEMBL18SolubilityTransforms`.

* Several molecular complexity functions that were inadvertently removed
  from the documentation have been re-added.

* The :ref:`oemedchem_examples_matchedpairtransform` example has been modified
  to reduce the amount of output that is typical for a general indexing
  activity.
