.. _section_oechem_releasenotes_190:

********************************************************************************
Version 1.9.0
********************************************************************************

OEChem 1.9.0
================================================================================

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

* Added support for reading the ``V3000`` file format for
  molecules, queries, and reactions. By default, whether to read the
  ``V3000`` format will be detected automatically from the header inside
  ``.sdf``, ``.mol``, and ``.rxn`` files. 

* :ref:`OEGroupBase <OEChem_OEGroupBase>` class added as a container of atoms and
  bonds inside a :ref:`OEMolBase <OEChem_OEMolBase>` to store MDL enhanced
  stereo information. See the :oe:constns:`OEChem::OEGroupType`
  namespace for the different types of enhanced stereo information
  that can be processed. Only the following subset of **OEChem**
  functions handle :ref:`OEGroupBase <OEChem_OEGroupBase>` information at this
  time:

  - :oe:func:`OEChem::OEAddMols`
  - :oe:func:`OEChem::OECount`
  - :oe:func:`OEChem::OEReadMDLFile`
  - :oe:func:`OEChem::OEReadMDLQueryFile`
  - :oe:func:`OEChem::OEReadMDLReactionQueryFile`
  - :oe:func:`OEChem::OESubsetMol`

  By virtue of the above low level reader functions populating
  :ref:`OEGroupBase <OEChem_OEGroupBase>` information,
  :oe:func:`OEChem::OEReadMolecule` from a ``V3000`` file format will
  also populate :ref:`OEGroupBase <OEChem_OEGroupBase>` information on a
  molecule. 

* Adding the following predicates for handling
  :ref:`OEGroupBase <OEChem_OEGroupBase>` objects on molecules.

  - :ref:`OEHasGroupType <OEChem_OEHasGroupType>`
  - :ref:`OEIsMDLStereoGroup <OEChem_OEIsMDLStereoGroup>`
  - :ref:`OEHasAtomInGroup <OEChem_OEHasAtomInGroup>`
  - :ref:`OEHasBondInGroup <OEChem_OEHasBondInGroup>`

* :oe:func:`OEChem::OEAssignZap9Radii` has been updated to use the
  method published in the 2010 Journal of Computer-Aided Molecular
  Design by Nicholls, Wlodek, and Grant. The old behavior can be
  accessed by passing constants found in the
  :oe:constns:`OEChem::OEZap9Version` namespace.

* :ref:`oemolithread <OEChem_oemolithread>` now works with ``CDX`` files.

* :oe:const:`OEChem::OEIFlavor::PDB::FORMALCHARGE` input flavor for PDB
  file reading added. This flavor is provided for advanced users who
  wish to read the formal charge from the file and do their own bond
  and hydrogen perception. It is not yet turned on by default.

* SD data tags and value in ``SDF`` files can now be up to 64
  kilobytes in length, up from the previous limit of just 4 kilobytes. 

* :oe:func:`OEChem::OEMolecularFormula` extended to include hydrogen
  isotopes deuterium (``D``) and tritium (``T``) in the molecular
  formula output. Note, the default behavior has not changed, the
  user is required to pass an additional parameter to enable this
  feature.

* The Amber C-terminal capping residue :oe:const:`OEChem::OEResidueIndex::NME`
  is now supported. Support for the Amber C-terminal
  capping residue `OEChem::OEResidueIndex::NMH` is incomplete.


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

* :oe:func:`OEChem::OESubsetMol` will no longer crash
  non-deterministically when setting the ``RGroup`` parameter to
  ``true``.

* :ref:`OEInterface <OESystem_OEInterface>` had a rare one time initialization
  thread safety bug when dealing with molecule parameters that has
  been fixed. 

* :oe:func:`OEChem::OEGetResidueName` will now handle
  :oe:const:`OEChem::OEResidueIndex::GLH` appropriately. 

* :oe:const:`OEChem::OEMCSType::Approximate` search method will now
  terminate once the :oe:meth:`OEChem::OEMCSSearch::GetMaxMatches`
  limit has been reached. The previous behavior was to keep
  enumerating all possible matches, then choose the first matches up
  to the limit. This significantly speeds up
  :oe:const:`OEChem::OEMCSType::Approximate` searches that results in a
  lot of matches, e.g., matching a molecule onto itself. 

  .. note:: 

     It is highly recommended to call
     :oe:func:`OEChem::OESuppressHydrogens` before trying to perform a
     self match on a molecule. 

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

* :oe:func:`OEChem::OEResidueHydrogens` will now throw an error check
  when attempting to assign a PDB atom name when there are more than
  than 9 hydrogens attached to a single atom.

OESystem 1.9.0
================================================================================

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

.. oe:language:: c++
   
   * :oe:func:`OESystem::OETrimToSigFigs` added to strip string representations
     of decimal numbers to a scientifically reasonable set of digits.  

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

* :ref:`OEInterface <OESystem_OEInterface>` help messages now only print a
  reasonable number of digits when printing floating point
  values.

* :oe:func:`OEChem::OEReadCDXFile` and :oe:func:`OEChem::OEReadMolecule` now 
  preserve stereochemistry when loading ChemDraw CDX files.  Additionally,
  some incorrect warning messages have been removed from the CDX file reader.

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

* Figures added to the documentation of
  :oe:func:`OEChem::OEMDLCorrectBondStereo`,
  :oe:func:`OEChem::OEMDLPerceiveBondStereo`, and
  :oe:func:`OEChem::OEMDLStereoFromBondStereo` to help explain the
  differences between those functions.

OEPlatform 1.9.0
================================================================================

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

* :oe:meth:`OEPlatform::OEFile::AbsPath` fixed to not have a leading ``/``
  if the directory path specified is empty.

OEBio 1.9.0
================================================================================

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

* The method :oe:meth:`OEBio::OEHierResidue::GetAtom` now correctly interprets
  the input :oe:constns:`OEChem::OEPDBAtomName` parameter rather than failing
  to find the requested atom.

OEGrid 1.4.1
================================================================================

.. oe:language:: java

   * :oe:func:`OESystem::OEReadMTZ` is now accessible from Java. 

.. oe:language:: csharp

   * :oe:func:`OESystem::OEReadMTZ` is now accessible from C#. 

.. oe:language:: c++ python

   * Internal build system improvements. 

