.. include:: ../../toolkits/toolkit-substitutions

******************************
Release Highlights 2022.1
******************************



Enhanced Stereo Information Support
====================================

The 2022.1 release adds support for enhanced stereochemistry designations in molecules,
defining relationships between stereocenters. Enhanced stereochemistry
information on any molecule is honored by :ref:`OEFlipper <oeconfgen_OEFlipper>`
during stereo enumeration when asked to do so by setting appropriate options. Enhanced
stereochemistry support has also been extended to both the :ref:`OMEGA <chapter_omega>` and
the :ref:`chapter_flipper` applications.

Support for :term:`CXSMILES` as a valid molecular input format via :ref:`OEFormat <oechem_OEFormat>`
has been added.  :term:`CXSMILES` is specifically
intended to support the import of `Enamine <https://enamine.net>`_ download structure files
containing enhanced stereochemistry designations. While many other features are possibly
provided in the :term:`CXSMILES` appendix information, only the enhanced stereochemistry group
information is supported at this time.   Please contact support@eyesopen.com with specific needs
for additional :term:`CXSMILES` features to allow prioritization in future releases.

**OMEGA** and **Flipper** applications can now accept molecule files in :term:`CXSMILES` format.

.. figure:: images/2022-Spr/enhanced_stereo.png
   :width: 200pt
   :align: center

   **Molecule with enhanced stereo designation. Molecule has 16 stereoisomers when
   stereocenters are treated independently, and only 4 stereoisomers when the
   enhanced stereo is enabled**

Sheffield Solvation Model for Proteins
=======================================

The simple two parameter Sheffield Solvation Model (as introduced by Grant et al (\ [Grant-2007]_ \)
for calculating the electrostatic component of molecular solvation energy, is a semi-empirical model
that performs well for small molecules and requires little computational resource. This model does
not work well for macromolecules like proteins and complexes, where many of the atoms are hidden or
only partially exposed to the solvent.

A modified three parameter Sheffield Solvation Model is parameterized and implemented in this release,
where solvent exposure is treated by correcting the effective atomic radii with the introduction of
a third additional parameter. The new model is available as part of the
:ref:`OESheffield <OESheff_OESheffield>` API in the **OEFF toolkit**. The model is also available for use
through the :ref:`OEFixedProteinLigandOptimizer <OESz_OEFixedProteinLigandOptimizer>` and the
:ref:`OEFlexProteinLigandOptimizer <OESz_OEFlexProteinLigandOptimizer>` APIs in the **SZYBKI toolkit**, and the :ref:`OptLigandInDU`
and :ref:`OptimizeDU` applications in **SZYBKI**.

Electrostatic solvation energies for protein conformers are calculated using both the new Sheffield
Solvation Model and the Poisson–Boltzmann (PB) model, and the difference in solvation energies between
conformers of the same protein is compared between the two models. A set of 232 NMR proteins and peptide
structures were used for this study that produced 41491 solvation energy differences between pairs of
conformations. The results are compared in the image below.

.. figure:: images/2022-Spr/protein_confs_sheffield_pb.png
   :width: 600pt
   :align: center

   **Comparison between Sheffield and PB of differential Electrostatic solvation energies between protein conformers**

Spruce Filter and Design Unit Validation
=========================================

New functionality for pre-processing inputs and validation of the
output ``Design Units`` has been added to **Spruce TK** in the form of two preliminary API classes, :ref:`OESpruceFilter <chapter_sprucetk_sprucefilter>` and
:ref:`OEValidateDesignUnit <chapter-sprucetk-validate-design-unit>`.
These classes are also used by the **SPRUCE** application to check and fix, if possible, inputs and to validate the resulting outputs.

OESpruceFilter performs a standardization and a filter check on input structures to use before prepping
this structure in **SPRUCE**. It automatically checks and fixes invalid component names, invalid residue
states,and  invalid metal bonds. It also checks for invalid CRYST1 from the header file, low overlap between
the electron density map and the structure, invalid sequence alignment, blank Chain IDs, and invalid
alternate locations. If the structure does not pass these tests, Spruce Filter will fail the structure.

The OEValidateDesignUnit function performs a check on the design units generated by
**SPRUCE**. It will report if the provided DU contains partial side chains, missing loops, implicit
hydrogens, incorrect partial charges, termini that are not capped properly, heavy atoms overlapping
with each other, and broken chains.


Multistate Heuristic pKa Model
===============================

The multistate heuristic pKa model is an extension of the existing pKa model in **OpenEye** software.
The existing model generates only one probable ionization state based on pKa estimated from
about 80 rules. With the development of this multistate pKa model, we are enhancing the
implementation with many more unique functional patterns in the form of pKa rules, identified
from OpenEye's internal pKa database, allowing generation of all ionization states possible
at physiological pH.

The model described herein uses SMARTS-based heuristics to assess the pKa of acidic or basic
functional groups of molecules. For all atoms of a query molecule, pKa is assessed as it belongs
to one of three classes: Acidic (pKa < 6.4), Basic (pKa > 8.4), and Neutral (6.4 < pKa < 8.4).
According to the assessed pKa class for each atom, it is either ionized and/or un-ionized at
pH 7.4. Any group with Acidic or Basic pKa range will result in one state, ionized or un-ionized
and a group with Neutral pKa range will result in both states, ionized and un-ionized. Based
on how many such functional groups there are in the molecule, and how many states are generated
for them, multiple molecules can be generated for all possible combinations of all possible
ionization states of acid/base groups.

The multistate heuristic pKa model is currently only available in the **Quacpac TK** as preliminary
API classes :ref:`OEMultistatepKaModel <OEProton_OEMultistatepKaModel>` and :ref:`OEMultistatepKaModelOptions <OEProton_OEMultistatepKaModelOptions>`.

Supported Platforms
=================================================================================

  ===========  =======================
  OS           Versions
  -----------  -----------------------
  Linux        RHEL7/8, Ubuntu18/20
  Windows      Win10, Win11
  macOS        10.15, 11, 12
  ===========  =======================

Related Application Versions
=================================================================================

  ==============  ===========
  Application     Version
  --------------  -----------
  AFITT           2.6.1
  BROOD           3.1.7
  EON             2.3.7
  OEDOCKING       4.1.2
  OMEGA           4.1.3
  PICTO           4.5.4
  pKa-Prospector  1.1.7
  QUACPAC         2.2.0
  ROCS            3.4.4
  SiteHopper      1.2.1
  SPRUCE          1.5.0
  SZMAP           1.6.4
  SZYBKI          2.5.0
  VIDA            5.0.2
  ==============  ===========

General Notices
=================================================================================

* Support for macOS 12 has been added.  Support for macOS 10.14 has been dropped.

* This is the last release to support macOS 10.15.

* Support for Windows 11 has been added for this release.

* This is the last release to support Ubuntu 18.04. Support for Ubuntu 22.04 will be added in the next release.




