.. oe:namespace:: OEShape

.. meta::
   :keywords: OECalcVolume

.. oe:function:: OECalcVolume

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

      .. oe:api::

         float OECalcVolume(const OEChem::OEMolBase& mol,
                            bool useHydrogens = true)

   .. oe:language:: python

      .. oe:api:: python

         OECalcVolume(mol: Union[OEGraphMol,OEMol,OEQMol],
                      useHydrogens: bool = True) -> float

   Calculate the Gaussian shape volume of a molecule.

   The volume is computed as the first-order Gaussian overlap integral over all
   atoms in the molecule. The molecule must have valid 3D coordinates assigned.

   *mol*

      The molecule to calculate the volume for.

   *useHydrogens*

      If true (the default), hydrogen atoms are included in the volume
      calculation. If false, only heavy atoms contribute.

   Returns the Gaussian shape volume in cubic angstroms.
