.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OESetMCSExhaustiveSearchTruncationLimit

.. oe:function:: OESetMCSExhaustiveSearchTruncationLimit

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

      .. oe:api::

         void OESetMCSExhaustiveSearchTruncationLimit(unsigned int limit)

   .. oe:language:: python

      .. oe:api:: python

         OESetMCSExhaustiveSearchTruncationLimit(limit: int) -> None

   Sets the number of unique partial substructures that can be traversed
   during the :oe:const:`exhaustive<OEChem::OEMCSType::Exhaustive>`
   MCS search.
   If this limit is reached than the :oe:const:`exhaustive<OEChem::OEMCSType::Exhaustive>`
   MCS search throws a "MCS search truncated" waning and terminates returning the
   maximum common substructures identified prior to reaching this limit.

   .. warning::

      Use this function with caution.
      Reducing the default limit will result in terminating the exhaustive MCS searches
      prematurely thereby preventing them from locating the maximum common substructure(s).
      Increasing this limit can result in significantly increasing the execution time
      in case of complex or large molecule pairs.

   .. seealso::

      * :oe:func:`OEChem::OEGetMCSExhaustiveSearchTruncationLimit` function
      * :ref:`OEMCSSearch <OEChem_OEMCSSearch>` class.
      * :ref:`section_patternmatch_mcss` section

