Spruce TK 0.9.1
================================================================================

New features
--------------------------------------------------------------------------------

.. note::

   **Spruce TK** now requires a specific license. For information on **Spruce TK**
   licensing, please visit https://www.eyesopen.com/contact.

* The :ref:`OESecondaryStructureSuperposition <OESpruce_OESecondaryStructureSuperposition>` class can
  now use ligand constraints initialized in the
  :ref:`OESuperpositionOptions <OESpruce_OESuperpositionOptions>` option class when handled by
  the following new methods:

  * :oe:meth:`OESpruce::OESuperpositionOptions::SetLigandConstraints`
  * :oe:meth:`OESpruce::OESuperpositionOptions::HasLigandConstraints`
  * :oe:meth:`OESpruce::OESuperpositionOptions::GetLigandConstraints`
  * :oe:meth:`OESpruce::OESuperpositionOptions::ClearLigandConstraints`

* New :oe:func:`OESpruce::OEExtractBioUnits` high-level functions have been added to
  extract biological assemblies, replacing the ``OEExtractBioUnitsFromRef``  and
  ``OEExtractBioUnitsFromPDBRemarks`` functions.

* The :ref:`OESecondaryStructureSuperposition <OESpruce_OESecondaryStructureSuperposition>` class now can be
  initialized with the :ref:`OESuperpositionOptions <OESpruce_OESuperpositionOptions>` option class.

* The :oe:constns:`OESpruce::OESuperpositionType` namespace now contains an
  entry for the :oe:const:`SSE <OESpruce::OESuperpositionType::SSE>`
  superposition method. The default superpositioning method is now
  :oe:const:`OESpruce::OESuperpositionType::Global`.

* New :ref:`OESStructural Superposition Transform <OESpruce_OEStructuralSuperposition_Transform>`  and
  :ref:`OESecondaryStructureSuperposition Transform <OESpruce_OESecondaryStructureSuperposition_Transform>` methods
  have been added to transform a molecule based on superpositioning.

* New :ref:`OESStructural Superposition operator bool <OESpruce_OEStructuralSuperposition_Transform>`  and
  :ref:`OESecondaryStructureSuperposition operator bool <OESpruce_OESecondaryStructureSuperposition_operator_bool>` methods
  have been added to validate objects.

API changes
--------------------------------------------------------------------------------

* The constructor of the :ref:`OEStructuralSuperposition <OESpruce_OEStructuralSuperposition>` class
  has been changed.

* The low-level ``OEExtractBioUnitsFromRef`` and ``OEExtractBioUnitsFromPDBRemarks``
  functions have been removed.

Major bug fixes
--------------------------------------------------------------------------------

* A bug that caused an issue with extracting biological assemblies has been fixed
  in the low-level biological assembly factory class.

* Biological assembly extraction for large proteins has been improved for
  memory and CPU usage.

Minor bug fixes
--------------------------------------------------------------------------------

* Superposition methods for using :ref:`OETrans <OEChem_OETrans>` instead of
  raw double pointers for rotation matrices and translation vectors have been
  improved.

* A bug that caused an issue with extracting biological assemblies if they had a
  blank REMARK line in the PDB file has been fixed.
