.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEPRECompress

.. oe:function:: OEPRECompress

   .. warning::

      OEB files generated through these functions will only be
      readable by **OEChem TK** 2.0.2 (2014.Oct) and higher.

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

      .. oe:api::

         bool OEPRECompress(oemolstreambase& str)

   .. oe:language:: python

      .. oe:api:: python

         OEPRECompress(str: oemolstreambase) -> bool

   Enables the :ref:`oemolostream <OEChem_oemolostream>` to write
   rotor-offset-compressed molecules in the perfect-rotor-encoding
   format, even for ``float`` precision molecules. This alleviates the
   need to GZip the ``OEB``, improving the performance of
   :oe:meth:`OEChem::OEMolDatabase::Open`.

   .. note::

      To compress data for **ROCS/FastROCS** at the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` level
      instead of :ref:`oemolostream <OEChem_oemolostream>` see :oe:func:`OEFastROCS::OEPrepareFastROCSMol`.

.. ################################################################
   #
   ################################################################

