
FastROCS TK 1.5.0
================================================================================

* This is an initial public beta release of **FastROCS TK** as part of
  the larger **OpenEye Toolkit** suite. Initial support is being
  limited to 64-bit Linux Python platforms. Please bear with us as we
  work to bring **FastROCS TK** up to the same level of quality as you
  should expect from every **OpenEye** toolkit. 

* The core suite of :ref:`FastROCS TK examples
  <fastrocs_examples_suite>` have been tested and will work in this
  distribution. Note, the examples are present in the Windows and OSX
  distributions, but the following examples only work on 64-bit Linux
  Python platforms:

  - ShapeDatabaseServer.py
  - ShapeDatabaseChunker.py
  - BestShapeOverlay.py
  - karma.py

  As **FastROCS TK** works towards official release, example programs
  will likely change names and be re-designed. We will keep
  compatibility with the following core examples many of the current
  **FastROCS** users depend on:

  - ShapeDatabaseServer.py
  - ShapeDatabaseClient.py
  - ShapeDatabaseIsLoaded.py
  - ShapeDatabaseProxy.py

* ShapeDatabaseServer.py will no longer hang indefinitely whenever the
  gzipped results are requested by the client. 

* ShapeDatabaseServer.py now supports specifying a different color
  force field, including a custom color force through a .cff file. 

* ShapeDatabaseServer.py now supports specifying the hostname to bind
  to.

* BestShapeOverlay.py optimized by using
  :ref:`OEMolDatabase <OEChem_OEMolDatabase>` class.

* The name of **FastROCS TK** python module has changed from
  ``oeshapedatabase`` to ``oefastrocs``. The example scripts have
  already been updated to account for the name change. 

* :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` will be much more efficient
  when the database is in an empty state. 

* :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` will now co-exist with other
  GPU processes, including other instances of
  :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` objects. Previously,
  :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` was very aggressive in the
  amount of GPU memory allocated, even when the data set sizes were
  very small. :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` will now be much
  more frugal with the amount of GPU memory it allocates making it
  possible to use many more :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>`
  simultaneously, provided each dataset is small. 

* :oe:meth:`OEFastROCS::OEShapeDatabase::GetSortedScores` and
  :oe:meth:`OEFastROCS::OEShapeDatabase::GetScores` will now error more
  reliably. Previously, an error could occur, like an out-of-memory
  problem on a GPU, and a partial list of results would be
  returned. This made it very difficult to notice when something was
  wrong, requiring someone to notice the error messages in the server
  log. Now, no results at all will be returned if any problem with the
  search occurs.

* :oe:meth:`OEFastROCS::OEShapeDatabase::GetSortedScores` and
  :oe:meth:`OEFastROCS::OEShapeDatabase::GetScores` APIs have changed
  from strings of shape queries to take actual
  :ref:`OEShapeQueryPublic <OEShape_OEShapeQueryPublic>` objects.

* :oe:meth:`OEFastROCS::OEShapeDatabase::AddMol` will now throw an
  error immediately if there are no atoms or conformers in the molecule. 

.. note:: Supported NVIDIA Driver: 346.* 
 (see :ref:`Supported NVIDIA Drivers <fastrocs_part_installation>` for alternative **FastROCS TK** releases).

