.. # split from OEMedChemFunctions.rst:469


.. oe:namespace:: OEMedChem

.. meta::
   :keywords: OEMatchedPairApplyTransforms

.. oe:function:: OEMatchedPairApplyTransforms

   .. oe:language:: c++ java csharp

      .. oe:api::

         OESystem::OEIterBase<OEChem::OEMolBase> *
         OESystem::OEIterBase<OEChem::OEMolBase>* OEMatchedPairApplyTransforms(const OEChem::OEMolBase& mol,
                                                                               OEMatchedPairAnalyzer& mmp,
                                                                               int context = OEMatchedPairContext::Default,
                                                                               unsigned int requireNumPairs = 0u)

   .. oe:language:: python

      .. oe:api:: python

         OEMatchedPairApplyTransforms(mol: Union[OEGraphMol,OEMol,OEQMol],
                                      mmp: OEMatchedPairAnalyzer, context: int,
                                      requireNumPairs: int = 0) -> Iterable[Union[OEGraphMol, OEMol, OEQMol]]

   The :oe:func:`OEMedChem::OEMatchedPairApplyTransforms` function will take the matched pair
   analysis provided by the :ref:`OEMatchedPairAnalyzer <OEMedChem_OEMatchedPairAnalyzer>` engine to generate
   a set of transformations to apply to the input molecule.  The output molecule(s)
   will be annotated with SD data that identifies the original pair of molecules from the matched pair indexing,
   any data associated with those original molecules, and the transformation that resulted in the output molecule.
   The context argument controls the amount of chemistry information that should be used in constructing
   the transformation reaction, see :oe:constns:`OEMedChem::OEMatchedPairContext`.  The ``minMMPThreshold`` argument will only
   apply transformations that meet or exceed the specified number of matched pairs.  A ``minMMPThreshold``
   value of ``0`` will apply transformations regardless of the number of matched pairs associated with them.


