.. _omega_gpuomega:

********************************************************************************
GPU-Omega
********************************************************************************

**GPU-Omega** refers to the CUDA-enabled GPU implementation of **OMEGA**. **GPU-Omega** takes
advantage of a GPU during torsion driving for accelerated conformer generation. To
make use of **GPU-Omega** conformer generation, please follow the guidelines below.

Prerequisites
--------------------------------------------------------------------------------

.. include:: ../../../common/gpu_prereq.rst

.. _section_gpuomega_app_usage:

Usage
--------------------------------------------------------------------------------
* **GPU-Omega** accelerates the torsion driving component of conformer generation in **OMEGA** and is
  available through the `-useGPU` flag.

  .. code-block:: bash

   prompt> oeomega classic -in drugs.mol2 -out drugs.oeb.gz -useGPU true

  The `-useGPU` true flag will engage **GPU-Omega** for accelerated torsion driving using a GPU if one is present on
  the system.

* By default, if a GPU is detected at runtime, torsion driving will be carried
  out on the GPU. To turn this feature off and run on the CPU, set the flag `-useGPU` to false.

* **GPU-Omega** uses the default mmff94smod_NoEstat force field. If attempting to use an alternative
  force field, conformer generation will fall back to the CPU. As a result of this, **GPU-Omega** is not
  compatible with the default settings of the **OMEGA** ``dense`` sampling mode. To take advantage of a GPU
  with ``dense`` sampling mode, set `-searchff` to `mmff94smod_NoEstat`.

* **GPU-Omega** does *not* support the distance geometry method of torsion driving, and therefore
  is incompatible with the ``macrocycle`` mode.
