.. _section_omega_modes:


OMEGA Sampling Modes
--------------------

**OMEGA** provides a set of predefined sampling modes, each tuned for a specific downstream
application. Selecting the right mode ensures that the output ensemble is appropriately sized and
shaped for the intended use case: not too sparse to miss binding-relevant geometries, but
not so dense as to be computationally unaffordable in the downstream step.
All modes except ``macrocycle`` (see the :ref:`Macrocycle Conformations section <section_macrocycle>`)
share the same underlying torsion driving (TD)
algorithm described in :ref:`Torsion Driving in Omega <chapter_omegatheory>`, but they differ in the default values of key
parameters such as the maximum number of conformers, energy window, and RMS pruning threshold.

.. figure:: ../images/modes_in_omega.png
   :align: center
   :alt: OMEGA sampling modes and relative sampling depth for downstream applications; see text for details.


   **Figure 1.** The torsion driving sampling modes in **OMEGA**.


The ``classic`` mode is the default mode. This allows a maximum of 200 conformations for a molecule.
These conformers represent a gas-phase ensemble. The  ``fastrocs``  and ``rocs`` modes are tailored toward
effective use in shape-based virtual screening applications: **FastROCS** and **ROCS**, with a
maximum of 10 and 50 conformations, respectively. The ``pose`` mode is designed for docking
with **OEDocking** (FRED/HYBRID) and allows up to 800 conformations for molecules with eight or more rotors.
The ``dense`` mode is designed for free-energy or solvation calculations with **Freeform** and generates
large ensembles (up to 20,000 conformations) with a tight RMS pruning threshold and a wide energy window
to provide thorough coverage of accessible conformational space.


Each of these modes not only has its own set of default parameters for ensemble slicing that are 
optimized for the intended downstream application, but the Thompson sampling strategy is also tailored 
for each mode, based on the typical flexibility of the molecule and the maximum number of conformers generated in that mode.


Choosing a Mode
^^^^^^^^^^^^^^^

The table below summarizes the recommended mode for common downstream applications:

.. list-table::
   :header-rows: 1
   :widths: 25 35 80

   * - Mode
     - Downstream Application
     - Key Characteristic
   * - ``classic``
     - General purpose
     - Gas-phase ensemble with balanced defaults
   * - ``fastrocs``
     - FastROCS GPU screening
     - Compact ensemble (up to 10 confs)
   * - ``rocs``
     - ROCS shape screening
     - Moderately sized, representative ensemble (up to 50 confs)
   * - ``pose``
     - OEDocking (FRED/HYBRID)
     - Wide energy window for bioactive conformers, up to 800 confs for flexible molecules
   * - ``dense``
     - Freeform free energy
     - Very dense ensemble with solvation scoring
