

Shape TK 3.6.0
================================================================================

New features
--------------------------------------------------------------------------------
* :ref:`OEFlexiOverlapFunc <OEShape_OEFlexiOverlapFunc>` and 
  :ref:`OEFlexiOverlay <OEShape_OEFlexiOverlay>` have been updated to 
  allow users to use a 
  Shape Query as the reference system.  This allows
  :ref:`OEFlexiOverlapFunc SetupRef <OEShape_OEFlexiOverlapFunc_SetupRef>` and
  :ref:`OEFlexiOverlay SetupRef <OEShape_OEFlexiOverlay_SetupRef>` to
  accept a Shape Query.

* A new method, :ref:`SetupFlex <OEShape_OEOverlapFuncBase_SetupFlex>`,
  has been added.  This method can be used to set up overlap calculation functions when
  molecules are expected to be flexible and their self overlaps 
  are not fixed to the initial value.

* A new method, :ref:`SortedOverlay <OEShape_OEOverlay_SortedOverlay>`,
  has been added as an alternative to :ref:`Overlay <OEShape_OEOverlay_Overlay>`.
  This method provides a desired number of top hit results instead of all
  of the hits and is especially suitable when working with molecules
  with excessive numbers of conformers.

* Two additional control flags, :ref:`GetRigidOverlay <OEShape_OEFlexiOverlayOptions_GetRigidOverlay>` and
  :ref:`SetRigidOverlay <OEShape_OEFlexiOverlayOptions_SetRigidOverlay>`, have been added to
  the :ref:`OEFlexiOverlayOptions <OEShape_OEFlexiOverlayOptions>` class. 
  These flags indicate if rigid overlay optimization between the fit molecule 
  conformers and the reference system should be performed prior to the flexible 
  optimization.

Major bug fixes
--------------------------------------------------------------------------------
* An issue in :ref:`OEFlexiOverlay <OEShape_OEFlexiOverlay>` 
  that caused a TanimotoCombo value greater than 2.0 when a molecule was 
  flexibly fitted against itself has been fixed.

Minor bug fixes
--------------------------------------------------------------------------------
* The default value for the ``color`` function in 
  :ref:`OEFlexiOverlapOptions <OEShape_OEFlexiOverlapOptions>` during
  :ref:`OEFlexiOverlay <OEShape_OEFlexiOverlay>` has been changed from
  ``none`` to ``exact``.  This ensures that color overlaps are reported
  when flexible optimization is performed with default parameters.

* An issue has been fixed with :ref:`OEFlexiOverlay <OEShape_OEFlexiOverlay>`
  that was causing shape Tanimoto to be occasionally reported as larger than 1.0
  after a flexible optimization.

* The legal range of values for the color score multiplier 
  has been added to the 
  :ref:`OEFlexiOverlapOptions <OEShape_OEFlexiOverlapOptions>` and 
  :ref:`OEOverlayOptions <OEShape_OEOverlayOptions>` option classes.

* :ref:`OEColorFFParameter <OEShape_OEColorFFParameter>` 
  now allows users to select `explicitmillsdeannorings` properly
  as the color force field.

* The acceptable ranges for the number of optimization iteration 
  steps have been defined for 
  :ref:`OEFlexiOverlayOptions <OEShape_OEFlexiOverlayOptions>` and 
  :ref:`OEOverlayOptions <OEShape_OEOverlayOptions>`.

* Newer implementation of Hermite code had limits on lambda
  parameters of the expansion. In rare cases, these were affecting the lambda parameter
  search (Newton optimization stepping outside the limits). Removing the limits fixed the previous problems with
  finding lambda parameters.

.. WIP * Default contour values
  for shape representation have been adjusted for visual representation of large
  proteins.
