.. oe:namespace:: OEShape

.. meta::
   :keywords: OECalcShapeMultipoles

.. oe:function:: OECalcShapeMultipoles

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

      .. oe:api::

         bool OECalcShapeMultipoles(const OEChem::OEMolBase& mol, float* smult,
                                    unsigned int type = OEOverlapRepresentation::Atoms,
                                    bool useHydrogens = false)

   .. oe:language:: python

      .. oe:api:: python

         OECalcShapeMultipoles(mol: Union[OEGraphMol,OEMol,OEQMol],
                               type: int = OEOverlapRepresentation_Atoms,
                               useH: bool = False) -> List[float]

   Calculate the shape (steric) multipoles of a molecule.

   The molecule must have valid 3D coordinates assigned. Multipole coefficients
   are written to the caller-supplied array *smult*. The required array size
   depends on the *type* parameter: for
   :oe:const:`OEShape::OEOverlapRepresentation::Atoms` the array must be large
   enough to hold one entry per atom.

   *mol*

      The molecule to calculate multipoles for.

   *smult*

      Output array that receives the computed multipole coefficients.

   *type*

      The overlap representation to use, chosen from the
      :oe:constns:`OEShape::OEOverlapRepresentation` namespace.

   *useHydrogens*

      If true, hydrogen atoms are included. The default is false.

   Returns true on success.
