.. include:: ../../toolkit-substitutions

.. oe:namespace:: OEBioisostere

.. _OEBioisostere_OEGenerateConformers:

.. oe:function:: OEGenerateConformers

   .. attention::

      |PRELIMINARY-API|

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

      .. oe:api::

         bool OEGenerateConformers(OEChem::OEMCMolBase& mol,
                                   bool rotorOffset = false)

   .. oe:language:: python

      .. oe:api:: python

         OEGenerateConformers(mol: OEMol, rotorOffset: bool = False) -> bool

   Generates conformers for the specified fragment molecule.
   Method returns `true` if conformer generation was successful.

   The overload with the ``rotorOffset`` enables rotor offset compression
   during conformer generation, as described in
   :ref:`SetRotorOffset<OEConfGen_OETorDriveOptions_SetRotorOffset>`.
   For fragment conformer generation, this can only be turned on when
   generating conformers specifically for use with 
   :ref:`OEDBWriter<OEBioisostere_OEDBWriter>`. Due to subtleties
   with fragment conformer generation, rotor offset compression
   may otherwise lead to undesired behavior. ``rotorOffset`` is `false`
   by default.
