OEChem TK 3.1.1
================================================================================

*July 2021*

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

* OEZ has been made the default file format for storing molecules in :ref:`OERecord <OEDataFlow_OERecord>` objects.

* Two new functions, :oe:func:`OEChem::OECalcPMI` and :oe:func:`OEChem::OEGetRadiusOfGyration`, have been added. The
  first calculates the principal moment of inertia (PMI) for a molecule, and the second calculates the radius of gyration for
  that molecule using a previously calculated PMI.

* :term:`InChI` has been updated to ``v1.06``.  A new option to :ref:`OEInChIOptions <OEChem_OEInChIOptions>` supports generation of nonstandard
  :term:`InChI` strings with pseudoatoms present.

* Atom/bond SMARTS expressions can now be used as generic data for SMARTS queries.

* The function :oe:func:`OEChem::OEApplyStateFromRef` now transfers stereo/chiral information from the reference state molecule.

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

* The function :oe:func:`OEChem::OEPerceiveResidues` has been enhanced to properly recognize
  ACE (acetyl) and NME (N-methyl) capping groups,
  which used to cause unexpected behaviors.
  Recognition of the NHE and FOR capping groups has also been improved.

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

* An issue that caused a crash in the :oe:func:`OEChem::OEPDBOrderAtoms` function when
  running with preserveResOrder=True and molecules that do not have chain IDs has been fixed.

* An issue that caused :oe:func:`OEChem::OEApplyStateFromRef` to return redundant matches
  when doing partial matching with long hydrocarbon chains has been fixed.

* An issue that caused :oe:func:`OEChem::OEDetermineConnectivity` to break all bonds
  between atoms with wrong valences (possibly resulting in a
  broken backbone) has been fixed. It now tries to break the bonds between
  non-adjacent residues first and, if the valences of involved atoms are still wrong, all bonds.

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

* Added documentation for the functions :oe:func:`OEChem::OEGetSoleNeighbor`, :oe:func:`OEChem::OEGetSoleBond`,
  :oe:func:`OEChem::OEGetSoleDoubleBond`, and :oe:func:`OEChem::OEGetSoleSingleBond`.

OEBio TK 3.1.1
================================================================================

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

* Two new constructors have been added to the :ref:`OEDesignUnit <OEBio_OEDesignUnit>` class.
  These constructors are intended to be used with prepared molecules. The two APIs are for liganded or apo-structures, where in the latter case
  site-residues indicating the binding site are required.

* Predicate versions of :oe:func:`OEBio::OEIsStandardProteinResidue` and
  :oe:func:`OEBio::OEIsStandardNucleicAcidResidue` have
  been added as :ref:`OEIsStandardAminoAcid <OEBio_OEIsStandardAminoAcid>` and :ref:`OEIsStandardNucleicAcid <OEBio_OEIsStandardNucleicAcid>`, respectively.

* The :ref:`OEReceptor <OEBio_OEReceptor>` class now stores a predicate that can be used to subset an :ref:`OEDesignUnit <OEBio_OEDesignUnit>` class component.  For example,
  a specific water molecule in the solvent component that should be used when generating the receptor grid and during docking.

* The function :oe:func:`OEBio::OESubsetDesignUnit` and the method :oe:meth:`OEBio::OEDesignUnit::GetComponents` now take a predicate
  that will subset the component(s) they hit in the design unit.

* The functions :oe:func:`OEBio::OESubsetDesignUnit` and :oe:func:`OEBio::OEUpdateDesignUnit`
  will now clear the stored OEReceptor
  if the targetMask and targetPredicate of the receptor match the content being updated or subsetted away.

* Non-const methods for :ref:`GetCustomConstraints <OEBio_OEReceptor_GetCustomConstraints>`,
  :oe:meth:`OEBio::OEReceptor::GetProteinConstraints`, and
  :ref:`GetConstraintFeatures <OEBio_GetConstraintFeatures>` have been
  added giving access to edit constraint features.

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

* Nitriles (C#N) are now recognized as hydrogen bond acceptors in interaction hint perception.

* Hydrogen bonds to moeities that are also interacting as saltbridges are now properly perceived.

* Amide NH atoms are now properly counted as as UnpairedLigandDonor when appropriate.

* The default for :oe:meth:`OEBio::GetMaxCationPiAngle<OEBio::OEPerceiveInteractionOptions::GetMaxCationPiAngle>` was reduced to from 50 to 40 degrees.

* The default for :oe:meth:`OEBio::SetMaxNonIdealAcceptorAngle<OEBio::OEPerceiveInteractionOptions::GetMaxNonIdealAcceptorAngle>` was increased from 70 to 90 degrees.

* The default for :oe:meth:`OEBio::GetMaxNonIdealDonorAngle<OEBio::OEPerceiveInteractionOptions::GetMaxNonIdealDonorAngle>` was increased from 50 to 70 degrees.

* Several intra molecular interaction types are now properly perceived with
  :oe:func:`OEBio::OEPerceiveInteractionHints`

OESystem TK 3.1.1
================================================================================

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

* An issue that caused the string format method on the :ref:`OEFieldType <OEDataflow_OEFieldType>` for
  ``double`` to be converted to ``int`` has been fixed.  The format method
  now writes with a precision of 12.

* An issue that caused the string format method on the :ref:`OEFieldType <OEDataflow_OEFieldType>`  for
  ``double`` to add a .0 after a ``NaN`` has been fixed.

* An issue that caused the string format method on the :ref:`OEFieldType <OEDataflow_OEFieldType>`  for
  ``string`` and ``JSON`` to be elided if longer than 100 characters has been fixed.

* An issue with metadata flags not getting properly updated when a field with new metadata
  was set on an existing field has been fixed.

OEPlatform TK 3.1.1
================================================================================

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

* `ZSTD <https://facebook.github.io/zstd/>`_ has been updated to version 1.4.9, resulting in improvements in compression
  and decompression performance for the OEZ file format.

OEGrid TK 3.1.1
================================================================================

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

* :ref:`OEScalarGrid <OESystem_OEScalarGrid>` now preserves
  :oe:constns:`OESystem::OEGridType` through I/O.

OEMath TK 3.1.1
================================================================================

Minor internal improvements have been made.









