OEMedChem TK 1.0.3
================================================================================

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

* A new class, :ref:`OEMCSFragDatabase <OEMedChem_OEMCSFragDatabase>`, has been implemented
  that supports an MCS fragmentation approach for returning Tanimoto and
  Tversky MCS similarity scores from a query against an indexed set of input
  structures.
  This approach is similar to the :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>`
  and the API is functionally equivalent to the
  :ref:`OEFPDatabase <OEGraphSim_OEFPDatabase>` API for ease of use. Because the indexing
  phase of the input structures can be time-consuming, new functions
  to capture and reload the MCS fragmentation index are provided as
  :oe:func:`OEMedChem::OEReadMCSFragDatabase` and
  :oe:func:`OEMedChem::OEWriteMCSFragDatabase`.

* A new options class, :ref:`OEMCSFragDatabaseOptions <OEMedChem_OEMCSFragDatabaseOptions>`,
  has been added to control the indexing phase of
  :ref:`OEMCSFragDatabase <OEMedChem_OEMCSFragDatabase>` usage.

* A new constant,
  :oe:const:`MCSFrags<OEMedChem::OEMatchedPairAnalyzerFileType::MCSFrags>`,
  has been added to support :ref:`OEMCSFragDatabase <OEMedChem_OEMCSFragDatabase>`
  serialization and may be returned by
  :oe:func:`OEMedChem::OEGetMatchedPairAnalyzerFileType`.

* Two new functions,
  :oe:func:`OEMedChem::OEConfigureMCSFragDatabaseOptions` and
  :oe:func:`OEMedChem::OESetupMCSFragDatabaseOptions`, have been added
  to allow configuration of indexing parameters from the command line for
  :ref:`OEMCSFragDatabaseOptions <OEMedChem_OEMCSFragDatabaseOptions>`.

* A new function, :oe:func:`OEMedChem::OEMCSFragDatabaseCoreQuery`, has been
  added to annotate MCS fragment SMILES cores returned from
  :oe:meth:`OEMedChem::OEMCSFragDatabase::GetSortedScores` and
  :ref:`OEMCSMolSimScore <OEMedChem_OEMCSMolSimScore>` with SMARTS qualifiers.
  This allows more restrictive and meaningful mapping highlights to be applied
  for depicting similarity hit results.

* The :ref:`OEMCSFragDatabase <OEMedChem_OEMCSFragDatabase>` class now supports
  user-customization
  of the similarity score returned by implementing a class derived from
  :ref:`OEMCSSimFuncBase <OEMedChem_OEMCSSimFuncBase>`.  Two concrete implementations of
  scoring functions, :ref:`OEMCSTanimotoSim <OEMedChem_OEMCSTanimotoSim>` and
  :ref:`OEMCSTverskySim <OEMedChem_OEMCSTverskySim>`, have been added.

* The indexing performance of :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>`
  has been significantly improved.  While this is highly
  dependent on the input structures and the requested indexing parameters,
  the provided default indexing settings with a drug-like
  set of structures show an indexing improvement of ~25%.

* A new overloaded function,
  :oe:func:`OEMedChem::OEIsMatchedPairAnalyzerFileType`, has been added to
  simplify the validation of matched pair index files.  The now unnecessary
  :oe:func:`OEMedChem::OEIsReadableMatchedPairAnalyzer` and
  :oe:func:`OEMedChem::OEIsWriteableMatchedPairAnalyzer` functions have
  been deprecated.

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

* New documentation has been added for the
  :ref:`OEMCSFragDatabase <OEMedChem_OEMCSFragDatabase>` API
  and the ancillary support functions, classes, and constants.
