********************************************************************************
Version 2.1.1
********************************************************************************

OEChem 2.1.1
================================================================================

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

* A new functor class, :ref:`OESimilarByRMSD <OEChem_OESimilarByRMSD>`, has been added that
  checks similarity between a pair of conformers based on RMSD.

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

* On Windows, a defect that caused a crash in :oe:func:`OEChem::OEReadMolecule`
  for :oe:const:`OEB<OEChem::OEFormat::OEB>` format or
  :oe:func:`OEChem::OEReadOEBFile` when
  processing large amounts of :oe:const:`OEChem::OEFormat::SDF` or
  :oe:const:`OEChem::OEFormat::PDB` data has been fixed.

* A crash that occurred when explicitly calling
  :oe:meth:`OEChem::oemolostream::Setgz` after opening a file that was
  implicitly gzipped has been fixed.

* Water hydrogens created by :oe:func:`OEChem::OEAddExplicitHydrogens`
  had previously been assigned the incorrect names ``"H 2"`` and ``"H 3"``.
  This has been corrected to give these hydrogens the expected names
  ``"H1"`` and ``"H2"``.
  The :oe:constns:`PDB atom indices<OEChem::OEPDBAtomName>`
  ``OEChem::OEPDBAtomName::H1`` and
  ``OEChem::OEPDBAtomName::H2`` can be used to refer to them.
  The constant ``OEChem::OEPDBAtomName::H`` has been deprecated.

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

* The algorithm used by the :oe:func:`OEChem::OEPerceiveBondOrders` function
  for detecting sp2 hybridized planar ring systems has been improved.

* For certain complex ring systems, the function
  :oe:func:`OEChem::OECreateSmiString` previously attempted to write a SMILES
  with more than 99 ring closures and output an invalid SMILES.  It now throws
  a warning and returns an empty string.

* If the function :oe:func:`OEChem::OECreateSmiString` cannot generate a
  valid SMILES for a molecule, a molecule title will no longer be output.

* When extracting ring templates for depiction, the
  :oe:meth:`OEChem::OE2DRingDictionary` class's normalization process
  no longer rejects long or short bonds.  This allows the creation of
  non-regular ring templates.

* The :oe:meth:`OEChem::OECenter` overload for :ref:`OEMCMolBase <OEChem_OEMCMolBase>`
  now optionally accepts an array which, when present, returns the
  translations applied for each conformer during the centering operation.
  The additional overload does not affect any existing usage.

* The :oe:meth:`OEChem::OESymmetryNumber` overload that works with
  :ref:`OEMCMolBase <OEChem_OEMCMolBase>` had previously not properly calculated the
  symmetry numbers for all conformers.  This has been fixed.

Java-specific changes
--------------------------------------------------------------------------------

* The Java ``verify`` script has been updated to correctly identify
  a **Szybki TK** license.

* The Java ``verify`` script has been updated to return an error status if
  there was a problem when generating a subset jar.

C#-specific changes
--------------------------------------------------------------------------------

* The Python-based C# ``verify`` script has been modified to run correctly with
  either Python 2 or Python 3.

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

* Documentation for :oe:meth:`OEChem::OECenter` and other molecular geometry
  functions has been improved.

OEBio 2.1.1
================================================================================

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

* A new scoring system, ``MMFF-NIE`` ("MMFF Neighbor Interaction
  Energies"), has been added to improve optimizing hydrogen bonding
  networks and avoiding clashes in the function
  :oe:func:`OEBio::OEPlaceHydrogens`.  This physics-based scoring system
  includes Coulombic
  and Van der Waals terms from ``MMFF94``, including MMFF partial charges.
  Interactions are scored between moveable functional groups 
  (see :ref:`OEPlaceHydrogensMoverClass <OEBio_OEPlaceHydrogensMoverClass>`) as well as
  between moveable functional groups and non-moving neighboring background
  atoms. The optimizer has also been improved to be much more memory-efficient.

* :oe:func:`OEBio::OEPlaceHydrogens` now samples waters more densely by default.
  A new constant, :oe:const:`OEBio::OEPlaceHydrogensWaterProcessing::Focused`,
  can be used to revert to the more limited sampling. Waters are processed
  individually, in order, starting at the molecular surface and moving outward,
  after all other moveable functional groups have been optimized.

* :oe:func:`OEBio::OEPlaceHydrogens` now detects bad clashes more accurately.

* :oe:func:`OEBio::OEPlaceHydrogens` now deprotonates certain acidic groups
  (e.g., SH) in the presence of a metal. In addition, imidazoles can now be
  doubly deprotonated when between two metals.  A new constant,
  :oe:const:`OEBio::OEPlaceHydrogensMoverClass::AroN`, has been
  added to describe aromatic nitrogens that can be deprotonated by metals.

* :oe:func:`OEBio::OEPlaceHydrogens` now recognizes neutral carboxylic acids.
  Hydrogen positions are sampled on both oxygens.

* :oe:func:`OEBio::OEPlaceHydrogens` now includes alternate location codes
  in atom descriptions.

* Two new methods,
  :oe:meth:`OEBio::OEPlaceHydrogensOptions::SetMaxSubstateCutoff`
  and :oe:meth:`OEBio::OEPlaceHydrogensOptions::GetMaxSubstateCutoff`,
  have been
  added to control how many substates the optimizer will consider in a single
  step.  This prevents calculations from running long
  because of overly dense networks.

* Class :ref:`OEPlaceHydrogensOptions <OEBio_OEPlaceHydrogensOptions>` objects can now be compared for
  equivalence and non-equivalence.

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

* Previously, :oe:func:`OEBio::OEPlaceHydrogens` was limited to processing
  1,024 moveable functional groups.  This limitation has been removed.

* :oe:func:`OEBio::OEPlaceHydrogens` has been improved for adding
  explicit hydrogens to molecules with multiple alternate locations when
  :oe:meth:`OEBio::OEPlaceHydrogensOptions::SetAltsMustBeCompatible`
  is set to ``true``, issuing a warning when it fails rather than halting.

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

* A description of the :oe:func:`OEBio::OEPlaceHydrogens`
  scoring system ``MMFF-NIE`` in the documentation for
  :oe:meth:`OEBio::OEPlaceHydrogensDetails::Describe` has been added and
  includes a link from the :ref:`chapter_protein_prep` example.

* The :ref:`section_example_oebio_proteinprep` example has been modified to
  cover the expanded range of options in water processing as well as the
  maximum number of optimization substates. It also now repairs bonding
  mistakes when the command line option ``-alt compare`` is used to retain
  all alternates
  by calling the method :oe:meth:`OEBio::OEAltLocationFactory::GetSourceMol`.
  This is a recommended approach for other workflows that read
  :oe:const:`OEChem::OEFormat::PDB` files and
  retain all alternate location atoms.

OEPlatform 2.1.1
================================================================================

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

* The :ref:`OEFile <OEPlatform_OEFile>` API has been augmented to support large
  (>2Gb) files on Windows.

Java-specific changes
--------------------------------------------------------------------------------

* The SWIG Java wrapper no longer creates finalizers for **OpenEye** objects
  that do not own memory: ``OEBase``, ``OEAtomBase``, ``OEBondBase``,
  ``OEConfBase``, and ``OEGroupBase``.  Previously, the SWIG wrapper created
  empty finalizers, which resulted in garbage collection bottlenecks for
  processes that used a lot of objects (e.g., looping over atoms and bonds in
  a protein).  This fix improves overall throughput for Java toolkit programs.

OESystem 2.1.1
================================================================================

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

* The :oe:meth:`OEMath::OEGeom2DRotate` method previously assumed inputs
  with 3-dimensional coordinates.  It now assumes 2-dimensional coordinates.

* The :oe:meth:`OEMath::OEGeom2DTranslate` method previously assumed inputs
  with 3-dimensional coordinates.  It now assumes 2-dimensional coordinates.

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

* Documentation for the public 2D and 3D geometry functions has been improved.
