SpatialCentroid
===============

.. currentmodule:: globalmapper
.. py:function:: SpatialCentroid (GM_LayerHandle_t32 aLayer, GM_SpatialOps_Params_t aParams, GM_FeatureGrouping_t8 aGrouping, str aStr) -> GM_Error_t32

	The **Centroid** spatial transform creates a new layer with a point at the geometric center of the given area
	feature(s). The *aGrouping* parameter defines whether points should be created for every area in the layer, for
	feature groups by attribute, or one for the entire layer.

	:param GM_LayerHandle_t32 aLayer: Input layer
	:param GM_SpatialOps_Params_t aParams: Parameters
	:param GM_FeatureGrouping_t8 aGrouping: Grouping type
	:param str aStr: The attribute list string; may be an empty string
	:returns: Error Code
	:rtype: GM_Error_t32
		
| 

.. list-table::
    :width: 100%
    :class: borderless
    :header-rows: 1

    * - BEFORE
      - AFTER

    * - .. image:: ../images/SpatialAnalysis_Images/multShapes.png
            :width: 151px
            :height: 150px
            :align: center

      - .. image:: ../images/SpatialAnalysis_Images/CentroidAfter.png
			:width: 151px
			:height: 150px
			:align: center

| 

Example
-------
The following is an example of SpatialCentroid.

.. literalinclude:: ../../sample_tests/sample_code/SpatialCentroid_sample.py
   :language: python