OEDocking TK 1.4.1
================================================================================

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

* Two new result classes, :ref:`OESinglePoseResult <OEDocking_OESinglePoseResult>` and
  :ref:`OEPositResults <OEDocking_OEPositResults>`, have been added that better report
  :ref:`OEPosit <OEDocking_OEPosit>`-generated pose results.

* A new class, :ref:`OEPoseOptimizer <OEDocking_OEPoseOptimizer>`, has been added that optimizes
  an already generated pose to reduce clashes.

* A new method, :oe:meth:`Dock<OEDocking::OEPosit::Dock>`, has been introduced
  that provides greater flexibility in reporting the generated pose results.
  The ``OEDocking::OEPosit::DockMultiConformerMolecule`` method is now deprecated.

* Two new methods, :oe:meth:`AddReceptor<OEDocking::OEPosit::AddReceptor>` and
  :oe:meth:`ClearReceptors<OEDocking::OEPosit::ClearReceptors>`, have been added to the
  :ref:`OEPosit <OEDocking_OEPosit>` class that enable using multiple receptors
  in a single calculation.

* A new function, :oe:meth:`OEDocking::OEHasClash`, has been added that
  allows clash detection.

* The following new methods have been added to the :ref:`OEPositOptions <OEDocking_OEPositOptions>`
  class that enable working with multiple receptors as well as further refinement of generated
  poses:

  * :oe:meth:`GetAllowedClashType<OEDocking::OEPositOptions::GetAllowedClashType>`
  * :oe:meth:`SetAllowedClashType<OEDocking::OEPositOptions::SetAllowedClashType>`
  * :oe:meth:`GetMinProbability<OEDocking::OEPositOptions::GetMinProbability>`
  * :oe:meth:`SetMinProbability<OEDocking::OEPositOptions::SetMinProbability>`
  * :oe:meth:`GetPoserCacheCount<OEDocking::OEPositOptions::GetPoserCacheCount>`
  * :oe:meth:`SetPoserCacheCount<OEDocking::OEPositOptions::SetPoserCacheCount>`
  * :oe:meth:`GetPoseRelaxMode<OEDocking::OEPositOptions::GetPoseRelaxMode>`
  * :oe:meth:`SetPoseRelaxMode<OEDocking::OEPositOptions::SetPoseRelaxMode>`

* A new namespace, :oe:constns:`OEDocking::OEAllowedClashType`, has been added
  that defines constants for various allowed clash types.

* A new namespace, :oe:constns:`OEDocking::OEPoseRelaxMode`, has been added
  that defines if and when a relaxation should be performed.

* A new constant, :oe:const:`OEDocking::OEDockingReturnCode::NoValidNonClashPoses`, has been added
  that indicates that no nonclashing poses are found.

* A new function, :oe:meth:`OEDocking::OEDockingReturnCodeGetName`, has been added that
  converts :oe:constns:`OEDocking::OEDockingReturnCode` to a meaningful string.

* A new function, :oe:meth:`OEDocking::OEPositMethodGetName`, has been added that
  returns the name of an :oe:constns:`OEDocking::OEPositMethod` in a string format.

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

* A rare crash that occurred during docking calculations in
  :oe:meth:`OEDock::DockMultiConformerMolecule<OEDocking::OEDock::DockMultiConformerMolecule>`
  has been fixed.

* :ref:`OEPosit <OEDocking_OEPosit>` no longer fails to generate poses due to unspecified stereo
  in the input molecule.

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

* :oe:meth:`OEDocking::OEMakeReceptor` now returns an empty receptor molecule when it fails.

* :oe:meth:`OEDocking::OEGetEstimatedPositProbability` no longer crashes when a
  failure occurs during conformer generation.

Documentation changes
--------------------------------------------------------------------------------

* Two new examples have been added in the sections, :ref:`section_example_oedocking_PoseMolsMultiReceptor`
  and :ref:`section_example_oedocking_PoseMolsProteinFlex`, that demonstrate new POSIT
  features for working with multiple receptors and for further refining generated poses,
  respectively.

* Docking examples have been updated for better coding practices that
  check the return code status of docking and print out any errors.
