
FastROCS TK 2.1.0
================================================================================

*Fall 2020*

New features
--------------------------------------------------------------------------------
* **FastROCS TK** now requires a minimum NVIDIA Driver version of 450.x.
  See :ref:`section_supported_gpus_drivers` for more details.
* **FastROCS TK** now requires a minimum GPU compute capability of 3.5. See :ref:`section_supported_gpus` for more details.
* :ref:`OEShapeQuery <OEShape_OEShapeQuery>` objects now have limited support for use as
  queries with the :oe:meth:`OEFastROCS::OEShapeDatabase::GetScores`
  and :oe:meth:`OEFastROCS::OEShapeDatabase::GetSortedScores` database searching methods.
* Support has been dropped for database files that are gzipped (e.g. ``oeb.gz``
  in the **FastROCS TK** examples). ``.oeb`` and ``.oez`` are still supported.
* A new database type, :oe:const:`OEFastROCS::OEShapeDatabaseType::Sitehopper`,
  has been added that runs Sitehopper calculations using fastrocs. Note that a
  Sitehopper license is required to run a Sitehopper calculation. Please visit https://www.eyesopen.com/contact or your account manager for a license.

Major bug fixes
--------------------------------------------------------------------------------
* Previously, GPU memory limits were being reached for routine searches when
  using :oe:constns:`OEFastROCS::OEFastROCSOrientation::InertialAtHeavyAtoms`
  with :oe:meth:`OEFastROCS::OEShapeDatabaseOptions::SetColorOptimization` set to true,
  causing the color calculation to default to the CPU. The improved alternative starts
  algorithm handles any number of starts without reaching GPU memory limits.

  .. warning::

     Performance will be affected by using large numbers (> 10) of alternative
     starts.

* Previously, the :ref:`section_example_fastrocs_shapeclustering` example suffered
  some performance degradation. This has now been fixed thanks to a performance bug
  fix in :oe:func:`OEShape::OESelfShape`. The script should now perform at its normal speed,
  ~10x that of the previous release.

Minor bug fixes
--------------------------------------------------------------------------------
* A warning is now thrown if users attempt to use a custom color forcefield that has either a non-Gaussian
  functional form or interactions between different color types.

Python specific changes
--------------------------------------------------------------------------------
* ``SimplePythonScript.py`` has been renamed ``SimpleFastROCSSearch.py`` in
  :ref:`Tutorial 1: Inertial At Heavy Atoms Alternative Starts<tutorial1_InertialAtHeavyAtoms_section>`.

* :oe:func:`OEChem::OEPreserveRotCompress` has been added to the molecule input
  stream in the ``SimplePrepScript.py`` script used in :ref:`tutorial_database_prep`.

Java specific changes
--------------------------------------------------------------------------------
* ``SimpleJavaScript.java`` has been renamed ``SimpleFastROCSSearch.java`` in
  :ref:`Tutorial 1: Inertial At Heavy Atoms Alternative Starts<tutorial1_InertialAtHeavyAtoms_section>`.

* :oe:func:`OEChem::OEPreserveRotCompress` has been added to the molecule input
  stream in the ``SimplePrepScript.java`` script used in :ref:`tutorial_database_prep`.

C++ specific changes
--------------------------------------------------------------------------------
* ``simplecppscript.cpp`` has been renamed ``simplefastrocssearch.cpp`` in
  :ref:`Tutorial 1: Inertial At Heavy Atoms Alternative Starts<tutorial1_InertialAtHeavyAtoms_section>`.

* :oe:func:`OEChem::OEPreserveRotCompress` has been added to the molecule input
  stream in the ``simpleprepscript.cpp`` script used in :ref:`tutorial_database_prep`.

Documentation changes
--------------------------------------------------------------------------------
* :ref:`tutorial_database_prep` now has an additional step explaining
  :oe:func:`OEChem::OEPreserveRotCompress`.



