
.. _section_oedocking_releasenotes_3505:

OEDocking TK 3.5.0.5
================================================================================

* The OEZ file format now correctly persists receptor information.

.. _section_oedocking_releasenotes_350:

OEDocking TK 3.5.0
================================================================================

As part of the integration of **OEToolkits** and **OEApplications** into a single
release, the version number of **OEDocking TK** has been upgraded to 3.5.0 to make
it consistent  with that of the **OEDocking** applications suite.

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

* Two new methods, :oe:meth:`OEDocking::OEPositOptions::SetExcludeSelf` and
  :oe:meth:`OEDocking::OEPositOptions::GetExcludeSelf`, have been added to
  simplify cross-docking validation experiments with :ref:`OEPosit <OEDocking_OEPosit>`.

* A new method, :oe:meth:`OEDocking::OEPosit::RankReceptors`, has been added that
  can rank receptors when posing with multiple receptors.

* The method :oe:meth:`OEDocking::OEMakeReceptor` has been overloaded to take
  an :ref:`OEDesignUnit <OEBio_OEDesignUnit>` object as input.

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

* Memory management for :oe:meth:`OEDocking::OEPosit::Dock` has been improved to
  handle up to 100 receptors when posing with multiple receptors.

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

* The following methods now return ``bool`` instead of a ``void``:

  * :oe:meth:`OEDocking::OEPositOptions::SetAllowedClashType`
  * :oe:meth:`OEDocking::OEPositOptions::SetFullConformationSearch`
  * :oe:meth:`OEDocking::OEPositOptions::SetIgnoreNitrogenStereo`
  * :oe:meth:`OEDocking::OEPositOptions::SetMinProbability`
  * :oe:meth:`OEDocking::OEPositOptions::SetPoserCacheCount`
  * :oe:meth:`OEDocking::OEPositOptions::SetPoseRelaxMode`

* :oe:meth:`OEDocking::OEPosit::Dock` now fails gracefully when a single atom
  ligand is passed for posing.

* :oe:func:`OEDocking::OEMakeBoxMolecule` now sets the output molecule as 3D.


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

* The :ref:`PoseMolsMultiReceptor<section_example_oedocking_PoseMolsMultiReceptor>`
  example has been updated.

* An example has been added to the :ref:`Receptors<chapter_receptor>`
  section showing how to convert an :ref:`OEDesignUnit <OEBio_OEDesignUnit>`
  object to a receptor.
