.. # split from OESzFunctions.rst:7

.. oe:namespace:: OESz

.. meta::
   :keywords: OEEstimateConfFreeEnergies

.. oe:function:: OEEstimateConfFreeEnergies

   .. oe:language:: c++ java csharp

      .. oe:api::

         bool OEEstimateConfFreeEnergies(OEFreeFormConfResults& results,
                                         OEChem::OEMCMolBase& moldst,
                                         const OEChem::OEMCMolBase& molsrc,
                                         const OEFreeFormConfOptions& opts)

   .. oe:language:: python

      .. oe:api:: python

         OEEstimateConfFreeEnergies(res: OEFreeFormConfResults, dst: OEMol,
                                    src: OEMol, opts: OEFreeFormConfOptions) -> bool

   .. warning::

      This function should not be used on 32-bit platforms because
      the memory requirements are too high.
                                     
   Estimates the Gibbs free energy to convert an ensemble of solution
   conformations into a state where only a single specific conformation
   is present as described in the theory section.
   Function returns ``true`` if the calculation was successful, ``false`` 
   otherwise. Results are accessible from the ``results`` object 
   (see :ref:`OEFreeFormConfResults <OESz_OEFreeFormConfResults>`). The ensemble of unique
   conformations is returned as a multiconformer molecule
   ``moldst``. The third argument represents the input molecule, and
   the last one contains user selected options (see
   :ref:`OEFreeFormConfOptions <OESz_OEFreeFormConfOptions>`).

