
********************************************************************************
Version 3.0.0.6
********************************************************************************

.. _section_oechem_releasenotes_3006:

OEChem TK 3.0.0.6
================================================================================

* A memory leak while reading string generic data in Python has been fixed.

OESystem TK 3.0.0.6
================================================================================

* When reading and writing large :ref:`OERecord <OEDataFlow_OERecord>`, sometimes memory
  usage would spike briefly due to temporary copies of data. The memory usage has been 
  optimized to reduce these spikes.

********************************************************************************
Version 3.0.0.5
********************************************************************************

.. _section_oechem_releasenotes_3005:


OEChem TK 3.0.0.5
================================================================================

* Added the ability to perceive chirality without including nitrogen atoms that could undergo nitrogen inversion.
  See :oe:func:`OEChem::OEPerceiveChiral` for details.

* Added a method to clear chiral perception before calling the perception function with a different flag.
  See :oe:func:`OEChem::OEClearChiralPerception` for details.

* The performance of converting large proteins to the JSON format has been improved.


OESystem TK 3.0.0.5
================================================================================

* Fixed an issue which allowed OERange objects to be created with a low value greater than the high value.

* The ``readonly`` flag on molecule fields was not being enforced properly in the Python API.
  Attempting to use a read-only field to set a molecule on an OERecord now raises an exception.

* Uninitialized OERange values stored on records were turning into None values on retrieval via the Python API.
  This has been fixed.

* In the Python API, the OERecord.get_fields method would return None values for fields whose types had not been imported.
  This has been fixed.

* Values of NaN and Infinity were causing errors when they appeared in JSON objects being read by any toolkit.
  This has been fixed.


OEGrid TK 3.0.0.5
================================================================================

* An issue causing some MTZ files to be read with the wrong space group has been fixed.


********************************************************************************
Version 3.0.0
********************************************************************************

.. _section_oechem_releasenotes_300:

OEChem TK 3.0.0
================================================================================

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

* A new set of Preliminary API classes has been added as part of the extended
  set of :ref:`OEParameter <OESystem_OEParameter>` and :ref:`OEOptions <OESystem_OEOptions>` classes:

  * :ref:`OEMolParameter <OEChem_OEMolParameter>`
  * :ref:`OEMolReaderParameter <OEChem_OEMolReaderParameter>`
  * :ref:`OEMolWriterParameter <OEChem_OEMolWriterParameter>`
  * :ref:`OEPredicateParameter <OEChem_OEPredicateParameter>`
  * :ref:`OESimpleAppOptions <OEChem_OESimpleAppOptions>`

* A new functor, :ref:`OEIsTermHeavyAtom <OEChem_OEIsTermHeavyAtom>`, has been added that identifies terminal
  heavy atoms.

* A new function, :oe:func:`OEChem::OEOverlayConfsByRMSD`, has been added that overlays all
  conformers of an :ref:`OEMCMolBase <OEChem_OEMCMolBase>` molecule on the first conformer
  to minimize RMSD.

* The molecule database implementation of :ref:`OESubSearchDatabase <OEChem_OESubSearchDatabase>`
  now loads scenes into memory using multiple threads.

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

* The full molecule-based multi-conformer :oe:func:`OEChem::OERMSD` calculation
  now returns ``false`` when the automorphism flag is set to ``true`` and no match can
  be identified between the reference target molecule (i.e., when no RMSD value can be
  calculated).

* An issue with using deleted atom pointers as templates for creating
  or recreating new atoms based on the deleted atom template has been fixed.  Previously, the newly
  created atom instance would be marked as a deleted atom.

* An issue that caused molecule SMILES string generation to erroneously output reaction information
  if :oe:constns:`OEChem::OERxnRole` information was present on atoms has been fixed.  Reaction
  information should only be added to the SMILES output if :oe:meth:`OEChem::OEMolBase::IsRxn` is ``true``.

* :oe:const:`OEChem::OERxnRole::Agent` and :oe:const:`OEChem::OERxnRole::Catalyst`
  enums have long had the same value, making them indistinguishable if applied to reaction atoms.
  The enum values have been changed to make them unique.  Formats (e.g., OEB) that support importing and exporting this information can now distinguish and retain this information.

* Some of the extraneous warnings about planar stereocenter geometry have been
  reduced via more rigorous checking of the stereocenter environment during structure file reading.

OEBio TK 3.0.0
================================================================================

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

* The following new methods have been added to the :ref:`OEInteractionHint <OEBio_OEInteractionHint>`
  class to access the calculated geometries of the interactions by the
  :oe:func:`OEBio::OEPerceiveInteractionHints` function:

  * :oe:meth:`OEBio::OEInteractionHint::HasCalculatedGeometry`
  * :oe:meth:`OEBio::OEInteractionHint::GetCalculatedGeometry`
  * :oe:meth:`OEBio::OEInteractionHint::GetCalculatedGeometries`

* A new function, :oe:func:`OEBio::OETransformDesignUnit`, has been added to
  transform :ref:`OEDesignUnit <OEBio_OEDesignUnit>` objects.

OESystem TK 3.0.0
================================================================================

New features
--------------------------------------------------------------------------------
* A set of preliminary APIs for **OERecord** and its associated classes has been added to
  **OEChem TK**. **OERecord** is a data container for storing and transmitting
  strongly typed data and its associated metadata.
  The API set includes the following classes and functions:

  * :ref:`OERecord <OEDataFlow_OERecord>`
  * :ref:`OEField <OEDataFlow_OEField>`
  * :ref:`OEFieldBase <OEDataFlow_OEFieldBase>`
  * :ref:`OEFieldMeta <OEDataFlow_OEFieldMeta>`
  * :ref:`OERange <OEDataFlow_OERange>`
  * :ref:`OEWriteRecord <OEDataFlow_OEWriteRecord>`
  * :ref:`OEReadRecord <OEDataFlow_OEReadRecord>`
  * :ref:`OERecordToBytes <OEDataFlow_OERecordToBytes>`
  * :ref:`OERecordFromBytes <OEDataFlow_OERecordFromBytes>`

* A new set of preliminary APIs has been added to combine the concepts of
  :ref:`OEParameter <OESystem_OEParameter>` with :ref:`OEOptions <OESystem_OEOptions>`.  These new APIs
  provide an interface for configuring :ref:`OEOptions <OESystem_OEOptions>` directly from the command
  line, making it easier to write command line applications.
  The new API set includes the following:

  * :ref:`OEBoolParameter <OESystem_OEBoolParameter>`
  * :ref:`OEConstParameter <OESystem_OEConstParameter>`
  * :ref:`OEDoubleParameter <OESystem_OEDoubleParameter>`
  * :ref:`OEFloatParameter <OESystem_OEFloatParameter>`
  * :ref:`OEIntParameter <OESystem_OEIntParameter>`
  * :ref:`OEMultiParameter <OESystem_OEMultiParameter>`
  * :ref:`OEPODParameter <OESystem_OEPODParameter>`
  * :ref:`OEPointerParameter <OESystem_OEPointerParameter>`
  * :ref:`OEStringParameter <OESystem_OEStringParameter>`
  * :ref:`OEUIntParameter <OESystem_OEUIntParameter>`
  * :ref:`OEOptions <OESystem_OEOptions>`
  * :oe:func:`OESystem::OEConfigureItf`
  * :oe:func:`OESystem::OEConfigureOpts`
  * :oe:func:`OESystem::OEUpdateOpts`

* A new overload for :oe:meth:`OESystem::OEDots::Update` has been added that takes a
  character as an argument to display in lieu of ``.``.

OEPlatform TK 3.0.0
================================================================================

* Minor internal improvements have been made.

OEGrid TK 3.0.0
================================================================================

* Minor internal improvements have been made.
