
.. _section_szybki_releasenotes_181:

Szybki TK 1.8.1
================================================================================

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

* :ref:`OENewtonOpt <OEOpt_OENewtonOpt>` added for Newton-Raphson optimization.

* :ref:`OESzybkiOptions <OESz_OESzybkiOptions>` class added for setting all options
  of the :ref:`OESzybki <OESz_OESzybki>` object during construction.  All new
  functionality, starting from the mentioned above Newton-Raphson
  optimization, will only be available through the
  :ref:`OESzybkiOptions <OESz_OESzybkiOptions>` class. All the
  :ref:`OESzybki <OESz_OESzybki>` methods with the same name as their
  :ref:`OESzybkiOptions <OESz_OESzybkiOptions>` counterpart are deprecated and will
  be removed in Szybki TK.

* :ref:`OEOptimizer2 <OEOpt_OEOptimizer2>` abstract base class added to allow
  optimizers that use analytical second derivatives.

* Newton-Raphson optimization method added as an option for minimization.
  For this release it is restricted however to the MMFF94/MMFF94S force field and 
  Sheffield solvation model. It is available only for optimization in Cartesian 
  coordinates. 

* The string representation of the gradient norm by the
  :ref:`OECheckpoint1 <OEOpt_OECheckpoint1>` object and by the
  :oe:meth:`OESz::OESzybkiResults::Print` method will be in scientific
  notation to provide better precision.

* The following methods have been added to :ref:`OESzybkiResults <OESz_OESzybkiResults>`:

  - :oe:meth:`OESz::OESzybkiResults::GetVibEntropy`
  - :oe:meth:`OESz::OESzybkiResults::GetRotEntropy`
  - :oe:meth:`OESz::OESzybkiResults::GetLnQvib`
  - :oe:meth:`OESz::OESzybkiResults::GetLnQrot`

* Efficiency of diagonalization of Hessian matrix is improved.   

* Added two new example programs showing how to use Newton-Raphson
  optimization.

.. oe:language:: c++

   * The C++ Szybki toolkit now links against the new ``oemath`` library.

   * All C++ examples have been renamed to better represent their utility. 

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

* Calculation of PB solvent forces will no longer run out of memory
  and crash due to violent moves of the optimizer.

* :oe:meth:`OESz::OESzybki::LoadPotentialGrid` and
  :oe:meth:`OESz::OESzybki::SavePotentialGrid` will no longer crash due to
  the length of the file name passed.

* :ref:`OESzybki <OESz_OESzybki>` will no longer allow a solid-body
  optimization in partially flexible protein as this was never an
  intended feature.

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

* :oe:meth:`OESz::OESzybki::SetProtein` will now fail and throw a
  warning if all the protein coordinates are zero.

* :oe:meth:`OESz::OESzybkiResults::Print` output will now include MMFF terms
  for a protein-ligand complex single-point calculation when
  :oe:meth:`OESz::OESzybki::SetProtein` was called before
  ``OESz::OESzybki::SetRunType``.

Documentation fixes
--------------------------------------------------------------------------------

* :oe:meth:`OESz::OESzybkiEnsembleResults::GetChargeType` return type is now
  properly documented.

