
Shape TK 3.5.1
================

New features
--------------------------------------------------------------------------------
* The following new methods have been added to  
  :ref:`OEOverlayOptions <OEShape_OEOverlayOptions>`
  to improve flexibility in defining parameters:

    * :ref:`SetShapeFuncType <OEShape_OEOverlayOptions_SetShapeFuncType>`
    * :ref:`GetShapeFuncType <OEShape_OEOverlayOptions_GetShapeFuncType>`
    * :ref:`SetColorFuncType <OEShape_OEOverlayOptions_SetColorFuncType>`
    * :ref:`GetColorFuncType <OEShape_OEOverlayOptions_GetColorFuncType>`
    * :ref:`SetShapeOptions <OEShape_OEOverlayOptions_SetShapeOptions>`
    * :ref:`GetShapeOptions <OEShape_OEOverlayOptions_GetShapeOptions>`
    * :ref:`SetColorOptions <OEShape_OEOverlayOptions_SetColorOptions>`
    * :ref:`GetColorOptions <OEShape_OEOverlayOptions_GetColorOptions>`

* A new overload for the method :ref:`CreateGrid <OEShape_OEHermite_CreateGrid>` has been
  added that takes a transform object as an additional argument that
  is applied after the grid is generated.

Major bug fixes
--------------------------------------------------------------------------------
* Default forcefields in :ref:`OEFlexiOverlapOptions <OEShape_OEFlexiOverlapOptions>`
  now ignore electrostatic interactions, as electrostatics appear to have
  negligible effects on optimized overlaid structures.  Ignoring the electrostatic
  interactions also improves efficiency of optimization for the corresponding
  :ref:`OEFlexiOverlapFunc <OEShape_OEFlexiOverlapFunc>`.

* The default for :ref:`OEOverlapFunc <OEShape_OEOverlapFunc>` in
  :ref:`OEFlexiOverlayOptions <OEShape_OEFlexiOverlayOptions>` now consists of
  ``Shape`` only and no ``Color``.  The default ``Shape score`` used
  is :ref:`Overlap <OEShape_OEScoreType_Overlap>`.


Minor bug fixes
--------------------------------------------------------------------------------
* A mismatch between the Hermite grid and the input molecule has been fixed.

* The maximum value on the Hermite resolution parameter has been increased from 30 to 100.


Documentation changes
--------------------------------------------------------------------------------
The following C++ and Python examples have been added to demonstrate how to use
new preliminary APIs:

* Two new C++ and Python examples have been added to the
  :ref:`chapter_flexi_overlay_examples` 
  section that show flexible overlay optimization of the fit molecules
  against a single reference molecule conformer. 
  
* When using
  :ref:`BestOverlay<OEShape_OEFlexiOverlay_BestOverlay>`, only one
  conformer that has the highest Tanimoto-combo similarity to the reference
  molecule is returned. 
