
.. _section_oemedchem_releasenotes_094:

OEMedChem TK 0.9.4
================================================================================

Beta-API changes
--------------------------------------------------------------------------------
* The :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::AddMol` return value
  has been changed. Negative return values no longer indicate a duplicate record ID
  in the index, but instead return various status values to indicate
  specific details of an indexing failure.

  .. note:: The interpretation of return values from this method in user-coded scripts may need to be altered.

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

* The indexing of structures now supports the specification
  of a zero or positive integer record ID to be used for referencing the input
  structures. This simplifies cross-referencing to externally maintained
  or managed data structures. For example, see changes to following:

  - :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>`
  - :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::AddMol`
  - :oe:meth:`OEMedChem::OEMatchedPairAnalyzer::IsIndexed`
  - :oe:constns:`OEMedChem::OEMatchedPairIndexStatus`
  - :oe:func:`OEMedChem::OEMatchedPairIndexStatusName`
  - :oe:func:`OEMedChem::OEMatchedPairIndexStatusType`

* Prioritization of matched pair index nodes is now performed based on the
  size of the MCS for the indexed pair(s).  This results in a significant reduction
  of redundant and less interesting transformations extracted from the index.
  The ChEMBL solubility data was reanalyzed with this optimization and results in
  approximately 1/3 fewer (redundant) transformations to be applied via
  :oe:func:`OEMedChem::OEApplyChEMBL18SolubilityTransforms`.

* A function has been provided to allow extraction and inspection
  of transformations based on the matched molecular pairs found during
  indexing as well as the specific matched pairs and data associated with those
  transformations.  For example, see changes to the following:

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

* A new overload of :oe:func:`OEMedChem::OEMatchedPairGetTransforms` now provides the ability
  to retrieve related transformations and matched molecular pairs based on a
  probe molecule.  The probe molecule is fragmented based on the analyzer
  indexing strategy; matched pair index nodes that have common cores to
  the provided probe are used to retrieve related matched pair transformations.

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

* Stereoisomers are now indexed properly by :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>`.
  Previously, stereoisomers were incorrectly considered duplicates and were rejected during indexing.

* The perceived regions from
  :oe:func:`OEMedChem::OEGetRingChainFragments` and
  :oe:func:`OEMedChem::OEGetRingLinkerSideChainFragments`
  are based on the heavy atoms in the molecule. If the molecule contains explicit
  hydrogen atoms, those atoms will be returned in the same perception set(s)
  as their alpha-heavy atom neighbors.  The documentation for these functions has been
  altered to reflect the new behavior as well as noting the requirement of
  the :oe:func:`OEChem::OEFindRingAtomsAndBonds` perception activity prior to use of these functions.

* A crash in :oe:func:`OEMedChem::OETotalMolecularComplexity` for highly bridged ring systems
  has been fixed. An issue that caused :oe:func:`OEMedChem::OEDetermineSymmetryComplexity` to
  crash when the required call to :oe:func:`OEChem::OEPerceiveChiral` had not
  been performed on the input molecule has also been fixed.

* The complexity computation functions have been altered to verify that the required perceptions
  have been performed.  Due to the ``const`` arguments to these functions, the perceptions cannot
  be performed internally and will now throw an error if the perception state is out of date
  for the provided input molecule. The functions affected are:

  * :oe:func:`OEMedChem::OEDetermineRingComplexity`
  * :oe:func:`OEMedChem::OEDetermineSymmetryComplexity`
  * :oe:func:`OEMedChem::OEDetermineStereoComplexity`
  * :oe:func:`OEMedChem::OENormalStereoComplexity`
  * :oe:func:`OEMedChem::OETotalMolecularComplexity`

Documentation fixes
--------------------------------------------------------------------------------

* New examples have been added to demonstrate the new API functions.

* New examples have been added for C++, Python, Java, and C#.

* Minor naming changes to constants for the beta matched pair API were made for consistency.

* Minor fixes have been made to the complexity function documentation to reflect the correct API points.

