********************************************************************************
Version 1.8.0
********************************************************************************

OEChem 1.8.0
================================================================================

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

* :oe:func:`OEChem::OERMSD` and its many related overloaded functions have been optimized
  using recent algorithms from the literature.  The algorithm now solves a
  quaternion-based characteristic polynomial (Theobald-2005).  For typical 
  cases, this new algorithm runs 3-5 times faster than the prior algorithm for 
  calculating either an optimum RMSD with or without an overlay transformation.

.. oe:language:: c++

   * C++ comparison operators (=, !=, <, <=, >, >=)  have been created for 
     :ref:`OEResidue <OEChem_OEResidue>` objects, allowing OEResidues to be compared to
     each other directly, used for sorting, and as keys in a std::map.

* A new PDB input flavor, :oe:const:`OEChem::OEIFlavor::PDB::SecStruct` has been
  created, to control perception of protein secondary structure from PDB files.
  This flavor is on by default when using :oe:func:`OEChem::OEReadMolecule`.
  When this flavor is on, secondary structure is automatically perceived using 
  :oe:func:`OEBio::OEPerceiveSecondaryStructure`.  Otherwise, secondary 
  structure information is taken from HELIX and SHEET records in a PDB file.


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

* :oe:func:`OEChem::OEAssignAromaticFlags` performance is significantly
  improved for molecules with a large number of rings, such as
  buckyballs. Since :oe:func:`OEChem::OEAssignAromaticFlags` is called
  when reading from every file format **OEChem** supports this solves
  problems where **OEChem** would appear to hang indefinitely trying
  to read certain molecules. :oe:func:`OEChem::OEAssignAromaticFlags`
  will now automatically adjust the maximum path considered for
  aromaticity perception based upon the following heuristics:

  * If a molecule has more than 15 rings, than the maximum
    path considered for aromaticity is 50. 

  * If a molecule has more than 30 rings and is potentially a
    buckyball, than the maximum path considered for aromaticity is 30.

  In the case of buckyballs and other fused ring systems of 5 and 6
  membered rings, this change has no effect other than to
  significantly improve the speed of the perception.

* Isomeric canonical smiles improved in the following ways: 

  * Performance improvement to isomeric canonical smiles generation by
    not performing the more expensive isomeric canonical smiles
    generation on disconnected components that do not contain stereo
    information.

  * Very complex ring system corner case fixed that would cause
    isomeric canonical smiles generation to run for longer than was
    required leading to slightly different isomeric canonical smiles. 

.. oe:language:: python
   
   * Fixed possible inter-process race condition that could occur
     while importing openeye libraries in Python due to duplicate
     temporary file names.

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

* :oe:func:`OEChem::OEBuildMDLQueryExpressions` fixed to properly
  evaluate expressions with zero charge as a valid atom property. 

* :oe:func:`OEChem::OEMDLStereoFromBondStereo` no longer throws a
  spurious platform dependent warning about '''Stereochemistry
  corrected on atom number # of #''' when the 2D atom coordinates
  around a tetrahedral center were all 90 degrees from each other.

* :oe:func:`OEChem::OEParseSmiles` no longer crashes when passed a
  ``NULL`` pointer as a string.

* :oe:meth:`OEChem::oemolistream::GetReadFailureCt` now returns a
  non-garbage number. The internal counter was not always properly
  initialized to ``0``, requiring the user to first call
  :oe:meth:`OEChem::oemolistream::ResetReadFailureCt` to get meaningful
  results.

* :oe:func:`OEChem::OEAssignAromaticFlags` now resets all atom
  aromaticity flags to ``false`` if no rings are found in the
  molecule. 

* :oe:meth:`OEChem::oemolistream::seek` and
  :oe:meth:`OEChem::oemolistream::tell` now works as expected for
  ``MOL2`` files. This was accomplished by making
  :oe:func:`OEChem::OEReadMol2File` robust enough to not care whether
  ``@<TRIPOS>MOLECULE`` was encountered, and continue to read the rest
  of the molecule regardless of its existence. Additional checks are
  now done on subsequent lines to ensure the file is indeed in the
  ``MOL2`` format.

* :oe:func:`OEChem::OEResidueHydrogens` has been fixed to remove a possible
  buffer overflow. 

* :oe:func:`OEChem::OEResidueHydrogens` now preserves assigned atom names
  for UNL residues.

* :ref:`OEAltLocationFactory <OEBio_OEAltLocationFactory>` constructors now correctly processes
  the value of the constructor option
  :oe:const:`OEBio::OEAltLocFactOption::TrustInputBonds`
  rather than always trusting input bonds.

OEBio 1.8.0
================================================================================

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

* Several new functions have been added for the perception and handling of 
  protein secondary structural elements:

  - :oe:func:`OEBio::OEPerceiveSecondaryStructure`
  - :oe:func:`OEBio::OEGetSecondaryStructureName`
  - :oe:func:`OEBio::OEGetSecondaryStructureID`
  - :oe:func:`OEBio::OEGetSecondaryStructureStrandID`
  - :oe:func:`OEBio::OEGetSecondaryStructureType`
  - :oe:func:`OEBio::OESecondaryStructurePacked`
  - :ref:`OEHasSecondaryStructure <OEBio_OEHasSecondaryStructure>`

  Sheets, helices, and turns are
  perceived using the method of Kabsch & Sander **1983**, and are stored
  in atoms' :ref:`OEResidue <OEChem_OEResidue>` records.  Secondary structure perception
  is performed by default when reading PDB files, but can be controlled
  with a new PDB input flavor, :oe:const:`OEChem::OEIFlavor::PDB::SecStruct`.
 
  
OEGrid 1.4.0
================================================================================

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

* :oe:func:`OESystem::OEReadMTZ` has been added.  This allows reading
  of standard MTZ crystallographic data files where the default
  MTZ column names from popular refinement packages were used.


OESystem 1.8.0
================================================================================

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

* :oe:meth:`OESystem::OEColorGradientBase::GetColorAt` fixed to
  correctly round color components after interpolation. 

* `OESystem::OEGeom3DGetOverlayRotTrans` renamed from
  ``OEGeomGetOverlayRotTrans`` and argument order changed to mimic
  other 3D geometry functions.

* The following :ref:`OEColor <OESystem_OEColor>` functions and methods will
  automatically clamp color values to the range [0,255] and [0.0, 1.0]
  for integers and floating point numbers respectively: 

  * :oe:meth:`OEColor constructors<OESystem::OEColor::Constructors>`
  * :oe:meth:`OESystem::OEColor::SetR`
  * :oe:meth:`OESystem::OEColor::SetG`
  * :oe:meth:`OESystem::OEColor::SetB`
  * :oe:meth:`OESystem::OEColor::SetA`
  * :oe:func:`OESystem::OEColorCreate`
  * :oe:func:`OESystem::OEColorSet`

  A warning will be thrown to ``OEThrow`` if a clamping occurs.

* Valgrind warning silenced caused by mismatching ``new []`` and
  ``delete`` in OEChem's :ref:`small object memory
  allocator<section_memorymanagement>`. The proper ``delete []`` is
  now used though no real issue was observed by this bug in
  production. 

* :ref:`OEInterface<chapter_oechem_interface>` no longer returns duplicate
  and confusing error messages by properly respecting the
  ``error_level`` argument in all failure conditions instead of using
  ``OEThrow.Error``.

* ``operator-=`` and ``operator+=`` now function properly for negative
  numbers for :ref:`OEPredIter <OESystem_OEPredIter>` and :ref:`OEConcatIter <OESystem_OEConcatIter>`.


OEPlatform 1.8.0
================================================================================

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

* ``OEPlatform::OEMallocaPtr::IsValid`` added to provide a more
  straightforward way of testing whether the held pointer is
  ``NULL``. 

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

* :ref:`OEThreadLocal <OEPlatform_OEThreadLocal>` will now properly destroy thread
  local variables upon thread termination for Visual Studio 2005 and
  later. 

* :oe:meth:`OEPlatform::oeostream::operator\<<` fixed to not crash when
  writing out a ``double`` that needs more than 80 characters to fully
  represent it. 

* ``OEPlatform::oeistream::pushline`` method removed as it was a
  hack to implement ``MOL2`` file reading since the molecule delimiter
  comes at the beginning of the next
  molecule. :oe:meth:`OEPlatform::oeistream::getline` was the only
  other :ref:`oeistream <OEPlatform_oeistream>` method that was aware of a
  ``pushline`` call. See the release note about the improvements to
  :oe:func:`OEChem::OEReadMol2File` that justify the removal of this
  method.

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

* :oe:func:`OEPlatform::OEGetIPAddress` should be more robust for
  grabbing the IP address, not returning the loopback interface or
  inactive interfaces. 

* :ref:`OEDirectoryScan <OEPlatform_OEDirectoryScan>` fixed to actually work on
  Windows. 

* :ref:`OEThread <OEPlatform_OEThread>` no longer has a copy constructor or
  ``operator=`` as these were dangerous and undefined. 

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

* The following chapters have been updated to new 2D depictions using
  the *OEDepict 2.x* library:

  * :ref:`Ring Perception<chapter_ring>` chapter
  * :ref:`Aromaticity Perception<chapter_aromaticity>` chapter
  * :ref:`Connectivity Perception<chapter_connectivity>` chapter
  * :ref:`Stereochemistry Perception<chapter_stereochemistry>` chapter
  * :ref:`Pattern Matching<chapter_patternmatch>` chapter
  * :ref:`Design Decisions<chapter_designdecisions>` chapter
  * :ref:`Periodic Table Functions<chapter_periodictable>` chapter

* :oe:func:`OEChem::OE3DToInternalStereo` documentation clarified to
  specify how it behaves in the absence of 3D coordinates.

* :ref:`Substructure Search<section_patternmatch_sss>` section fixed
  to more accurately reflect that subgraph uniqueness does not
  actually consider differences in matched bonds.
