Spruce TK 1.4.0
================================================================================

*Fall 2021*

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

* A new method, :ref:`SetForceCapping <OESpruce_OECapBuilderOptions_SetForceCapping>`, has been added
  to enable capping even if it will result in a clash.

* Two new methods, :ref:`SetBuildTails <OESpruce_OELoopBuilderOptions_SetBuildTails>` and
  :ref:`GetBuildTails <OESpruce_OELoopBuilderOptions_GetBuildTails>`, have been added
  to set and get an option that
  controls whether to build tails when there is missing residues at the N- and C- termini.

* :ref:`SiteHopper <OESpruce_OESuperposeMethod_SiteHopper>` is now a supported superposition method in
  :ref:`OESuperpose <OESpruce_OESuperpose>`, and can be set using the SetMethod method of :ref:`OESuperpose <OESpruce_OESuperpose>`.

* All Options classes have been modified to derive from :ref:`OEOptions <OESystem_OEOptions>`. This affects classes:

  * :ref:`OEDesignUnitEnumerateSitesOptions <OESpruce_OEDesignUnitEnumerateSitesOptions>`
  * :ref:`OEProtonateDesignUnitOptions <OESpruce_OEProtonateDesignUnitOptions>`
  * :ref:`OEDesignUnitBuildOptions <OESpruce_OEDesignUnitBuildOptions>`
  * :ref:`OEDesignUnitPrepOptions <OESpruce_OEDesignUnitPrepOptions>`
  * :ref:`OEDesignUnitSplitOptions <OESpruce_OEDesignUnitSplitOptions>`
  * :ref:`OEBioUnitExtractionOptions <OESpruce_OEBioUnitExtractionOptions>`
  * :ref:`OEMakeDesignUnitOptions <OESpruce_OEMakeDesignUnitOptions>`
  * :ref:`OEPlaceHydrogensOptions <OEBio_OEPlaceHydrogensOptions>`

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

* An issue causing capping a nonstandard residue to fail has been fixed.

* An issue causing covalent ligands to have their covalent bond broken when
  there were alternate locations in the structure, has been fixed.

* An issue causing side-chains to either not be built or being built in
  non-optimal configurations has been fixed.

* An issue with pockets identifying liganded sites in
  :ref:`OEMakeDesignUnitFromPocket <OESpruce_oemakedesignunitfrompocket>` not generating a proper
  design unit with a ligand bound in the identified site has been fixed.


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

* An issue causing the warning message 'Truncated cap due to clash' to appear when
  :ref:`SetAllowTruncate <OESpruce_OECapBuilderOptions_SetAllowTruncate>` is `False` has been fixed.

* An issue caused by Heuristic score offset being added before comparing to original 
  structure therefore unable to pick the more energy favorable conformation has been fixed.

* An issue causing the gap finding code to mis-identify gaps in the protein 
  structure due to residues with missing backbone atoms has been fixed.
  The function now removes these residues prior to gap detection inside 
  :ref:`OEBuildLoops <OESpruce_OEBuildLoops>`.

* An issue caused by malformed ``PDB`` Header data, specifically with regards to
  REMARK 300 sections, has been fixed.




