
Shape TK 3.10.0
================================================================================

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

* When using the :ref:`Overlay<OEShape_OEOverlay_Overlay>`
  method in :ref:`OEOverlay<OEShape_OEOverlay>` for overlay optimization, any of the inertial start
  methods now automatically trigger an additional :ref:`as-is<OEShape_OEAsIsStarts>` start
  if the optimization results in similarity measures less than the original similarity.
  This improves the default behavior of :ref:`Overlay<OEShape_OEOverlay_Overlay>` for
  some calculations.

* The following modifications have been made to :ref:`OEOverlapPrepOptions<OEShape_OEOverlapPrepOptions>`
  to provide more flexibility in assigning color atoms during the :ref:`Prep<OEShape_OEOverlapPrep_Prep>` process
  in :ref:`OEOverlapPrep<OEShape_OEOverlapPrep>`:

    * Two new methods, :ref:`SetRemoveColor<OEShape_OEOverlapPrepOptions_SetRemoveColor>`
      and :ref:`GetRemoveColor<OEShape_OEOverlapPrepOptions_GetRemoveColor>`, have been added
      to enable removal or reassignment of color atoms.
    * The new methods :ref:`AddDuplicateSmarts<OEShape_OEOverlapPrepOptions_AddDuplicateSmarts>`,
      :ref:`GetDuplicateSmarts<OEShape_OEOverlapPrepOptions_GetDuplicateSmarts>`, and
      :ref:`ClearDuplicateSmarts<OEShape_OEOverlapPrepOptions_ClearDuplicateSmarts>` have been added
      to enable duplicate color atom removal based on provided SMARTS patterns.
    * Duplicate color atom removal is now more robust in keeping the central atoms instead 
      of the first atom that it encounters and in placing the remaining atoms appropriately 
      (at the center of corresponding clusters).
    * Defaults for :ref:`SetRemoveDuplicate<OEShape_OEOverlapPrepOptions_SetRemoveDuplicate>`
      and :ref:`SetDuplicateDistance<OEShape_OEOverlapPrepOptions_SetDuplicateDistance>`
      have been changed from ``False`` and `0.001` to ``True`` and `0.0`, respectively. This improves
      robustness but keeps the default behavior unchanged.

* A new method, :ref:`SetupFrame<OEShape_OEStarts_SetupFrame>`, has been added to :ref:`OEStarts<OEShape_OEStarts>`
  that simplifies setting up a reference frame for calculating the starts.


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

* The overlay optimization in :ref:`OEHermiteOverlay<OEShape_OEHermiteOverlay>`
  with the :ref:`OEAsIsStarts<OEShape_OEAsIsStarts>` start option has been updated to use Hermite
  expansions around the center of mass to prevent inconsistent overlaps when objects are
  far from the origin.

* Overlay optimization with the :ref:`Overlay<OEShape_OEOverlay_Overlay>`
  method in :ref:`OEOverlay<OEShape_OEOverlay>` now captures the fit conformer
  self-overlap and color scores more accurately during the optimization.
