

Shape TK 3.9.0
================================================================================

New Features
--------------------------------------------------------------------------------

* The :ref:`SetupRef<OEShape_OEOverlay_SetupRef>` method in 
  :ref:`OEOverlay<OEShape_OEOverlay>` now accepts molecules containing only color
  atoms. Accordingly, any molecule containing only color atoms or an
  :ref:`OEShapeQuery<OEShape_OEShapeQuery>` containing only color Gaussians
  can now be used as a reference for overlay optimization.

* The :ref:`SetupRef<OEShape_OEOverlapFuncBase_SetupRef>` method in 
  :ref:`OEOverlapFunc<OEShape_OEOverlapFunc>` now accepts molecules and
  :ref:`OEShapeQuery<OEShape_OEShapeQuery>` containing just color components.

* A new class, :ref:`OEHermiteOverlay <OEShape_OEHermiteOverlay>`, and a corresponding options class,
  :ref:`OEHermiteOverlayOptions <OEShape_OEHermiteOverlayOptions>`, are introduced, enabling
  overlays using the Hermite expansion approach. Three types of reference and database molecule
  representations are supported: Hermite vector, molecule, and scalar grid. Consequently, grid/grid
  overlays are enabled by using these classes.

* The grid-to-Gaussians fit algorithm, to add Gaussians in an :ref:`OEShapeQuery<OEShape_OEShapeQuery>`
  using :ref:`AddShapeGaussians<OEShape_OEShapeQuery_AddShapeGaussians>` and 
  :ref:`AddColorGaussians<OEShape_OEShapeQuery_AddColorGaussians>`,
  has been improved for better representation of the grid by the generated Gaussians.
  With the introduction of the modified algorithm, some of the associated options in
  :ref:`OEShapeQueryOptions <OEShape_OEShapeQueryOptions>` are no longer relevant and have been
  removed from the class API. The following functions have been removed:


  * ``GetDuplicateDistance`` and ``SetDuplicateDistance``
  * ``GetMaxNumGaussians`` and ``SetMaxNumGaussians``


* A new overload has been added for :ref:`Transform <OEShape_OEBestOverlayScore_Transform>` that enables
  transformation of a scalar grid by the rigid transformation in 
  :ref:`OEBestOverlayScore<OEShape_OEBestOverlayScore>`.

* A new overload has been added for :ref:`Setup<OEShape_OEStarts_Setup>` that enables
  setting up :ref:`OEStarts<OEShape_OEStarts>` with known fit symmetry.

* The following new methods have been added to :ref:`OEHermite <OEShape_OEHermite>` to
  enhance usability:

  * :ref:`NumCoefficients<OEShape_OEHermite_NumCoefficients>`
  * A new overload for :ref:`GetCoefficients<OEShape_OEHermite_GetCoefficients>`

Minor Bug Fixes
--------------------------------------------------------------------------------

* An issue related to :ref:`Init <OEShape_OEColorForceField_Init>`
  was causing intermittent slowdown in some API calls, especially in CUDA-enabled builds. This has been fixed.

