.. # split from OEGraphemeFunctions.rst:2590

.. include:: ../substitutions

.. oe:namespace:: OEGrapheme

.. meta::
   :keywords: OEGetMoleculeSurfaceScale

.. oe:function:: OEGetMoleculeSurfaceScale

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

      .. oe:api::

         double OEGetMoleculeSurfaceScale(const OEChem::OEMolBase& mol,
                                          const OEDepict::OE2DMolDisplayOptions& opts,
                                          double maxRadiusScale = OESurfaceArcScale::Default)

   .. oe:language:: python

      .. oe:api:: python

         OEGetMoleculeSurfaceScale(mol: Union[OEGraphMol,OEMol,OEQMol],
                                   opts: OE2DMolDisplayOptions,
                                   maxRadiusScale: float) -> float


   Estimates the scaling factor of the molecule depiction considering
   the size of the molecule surface being drawn around the molecule
   diagram.
   See :ref:`Figure: Example of using the OEGetMoleculeSurfaceScale function <figure_OEGetMoleculeSurfaceScale>`.

   *mol*
     The molecule for which the scaling factor is determined.

   *opts*
     The :ref:`OE2DMolDisplayOptions <OEDepict_OE2DMolDisplayOptions>` object that stores
     the parameters which influence the calculated scaling factor
     (such as the width and the height of the image).

   *maxRadiusScale*
     The maximum radius multiplier used to generate the arcs of the
     2D molecule surface.

   .. _figure_OEGetMoleculeSurfaceScale:

   .. figure:: ../images/OEGetMoleculeSurfaceScale.*
      :align:  center

      **Example of using the OEGetMoleculeSurfaceScale function**

   .. seealso::

      * :oe:constns:`OEGrapheme::OESurfaceArcScale` namespace

