
Szybki TK 2.9.0
================================================================================

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


* A new class, :ref:`OEOELigandChargeOptions<OESz_OELigandChargeOptions>`,
  has been added that provides options related to ligand charge assignment. The following classes
  now derive from :ref:`OEOELigandChargeOptions<OESz_OELigandChargeOptions>`,
  enabling greater flexibility in ligand charge assignment:

  * :ref:`OEProteinLigandOptOptions<OESz_OEProteinLigandOptOptions>`
  * :ref:`OETorsionScanOptions<OESz_OETorsionScanOptions>`
  * :ref:`OEBoundEntropyOptions<OESz_OEBoundEntropyOptions>`
  * :ref:`OELigandEntropyOptions<OESz_OELigandEntropyOptions>`

* The default optimization type has been changed to :ref:`PoseCartesian <OESz_OEOptimizationType_PoseCartesian>`
  in both :ref:`OEFixedProteinLigandOptimizer<OESz_OEFixedProteinLigandOptimizer>` and 
  :ref:`OEFlexProteinLigandOptimizer<OESz_OEFlexProteinLigandOptimizer>`.

* The following two new constants have been added to the :ref:`OESzybkiReturnCode <OESz_OESzybkiReturnCode>` namespace:
  
  * :ref:`AromaticRingDev<OESz_OESzybkiReturnCode_AromaticRingDev>`: refers to failure due to excessive aromatic distortion.
  * :ref:`OptimizerFailed<OESz_OESzybkiReturnCode_OptimizerFailed>`: refers to the optimizer failing to find a solution.

* The following class methods now take an optional predicate describing residues that
  should be considered as part of the protein target during optimization:

  * :ref:`SetProtein<OESz_OEFixedProteinLigandOptimizer_SetProtein>` in :ref:`OEFixedProteinLigandOptimizer<OESz_OEFixedProteinLigandOptimizer>`
  * :ref:`Optimize<OESz_OEFlexProteinLigandOptimizer_Optimize>` in :ref:`OEFlexProteinLigandOptimizer<OESz_OEFlexProteinLigandOptimizer>`
  * :ref:`Energy<OESz_OEFlexProteinLigandOptimizer_Energy>` in :ref:`OEFlexProteinLigandOptimizer<OESz_OEFlexProteinLigandOptimizer>`

* The following new preliminary API classes have been added, enabling optimization
  of a ligand with torsion constraints:

  * :ref:`OELigandEnergy <OESz_OELigandEnergy>`
  * :ref:`OELigandOptOptions <OESz_OELigandOptOptions>`
  * :ref:`OELigandOptResults <OESz_OELigandOptResults>`
  * :ref:`OETorConstraintOptimizer <OESz_OETorConstraintOptimizer>`
  * :ref:`OETorConstraintOptOptions <OESz_OETorConstraintOptOptions>`

Major Bug Fixes
--------------------------------------------------------------------------------

* :ref:`OEFixedProteinLigandOptimizer<OESz_OEFixedProteinLigandOptimizer>` and 
  :ref:`OEFlexProteinLigandOptimizer<OESz_OEFlexProteinLigandOptimizer>` no longer fail
  to optimize with the :ref:`ExcessiveOverlap<OESz_OESzybkiReturnCode_ExcessiveOverlap>` error code
  prematurely.

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

* :ref:`OEFreeFormConfOptions<OESz_OEFreeFormConfOptions>` now sets the
  :ref:`latest Sage force field<OESz_OEForceFieldType_SAGE_OPENFF>` as the default.

* An issue has been fixed in :ref:`OETorsionScan <OESz_OETorsionScan>` where scanning using the option
  :ref:`SetUseInternalCoord <OESz_OETorsionScanOptions_SetUseInternalCoord>` set to ``true`` would occasionally produce 
  large unphysical energies at certain angles.
