ArcMap

Mean Center

Summary

Identifies the geographic center (or the center of concentration) for a set of features.

Learn more about how Mean Center works

Illustration

Mean Center illustration

Usage

  • The mean center is a point constructed from the average x and y values for the input feature centroids.

  • This tool requires projected data to accurately measure distances.

  • The x and y values for the mean center point features are attributes in the Output Feature Class. The values are stored in the fields XCOORD and YCOORD.

  • The Case Field is used to group features for separate mean center computations. When a Case Field is specified, the input features are first grouped according to case field values, and then a mean center is calculated for each group. The case field can be of integer, date, or string type. Records with NULL values for the Case Field will be excluded from analysis.

  • The Dimension Field is any numeric field in the input feature class. The Mean Center tool will compute the average for all values in that field and include the result in the output feature class.

  • For line and polygon features, feature centroids are used in distance computations. For multipoints, polylines, or polygons with multiple parts, the centroid is computed using the weighted mean center of all feature parts. The weighting for point features is 1, for line features is length, and for polygon features is area.

  • Map layers can be used to define the Input Feature Class. When using a layer with a selection, only the selected features are included in the analysis.

Syntax

arcpy.stats.MeanCenter(Input_Feature_Class, Output_Feature_Class, {Weight_Field}, {Case_Field}, {Dimension_Field})
ParameterExplanationData Type
Input_Feature_Class

A feature class for which the mean center will be calculated.

Feature Layer
Output_Feature_Class

A point feature class that will contain the features representing the mean centers of the input feature class.

Feature Class
Weight_Field
(Optional)

The numeric field used to create a weighted mean center.

Field
Case_Field
(Optional)

Field used to group features for separate mean center calculations. The case field can be of integer, date, or string type.

Field
Dimension_Field
(Optional)

A numeric field containing attribute values from which an average value will be calculated.

Field

Code sample

MeanCenter Example (Python Window)

The following Python Window script demonstrates how to use the MeanCenter tool.

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.MeanCenter_stats("coffee_shops.shp", "coffee_MEANCENTER.shp", "NUM_EMP", "#", "#")
MeanCenter Example (Stand-alone Python script)

The following stand-alone Python script demonstrates how to use the MeanCenter tool.

# Measure geographic distribution characteristics of coffee house locations weighted by the number of employees
 
# Import system modules
import arcpy
 
# Local variables...
workspace = "C:/data"
input_FC = "coffee_shops.shp"
CF_output = "coffee_CENTRALFEATURE.shp"
MEAN_output = "coffee_MEANCENTER.shp"
MED_output = "coffee_MEDIANCENTER.shp"
weight_field = "NUM_EMP"
 
try:
    # Set the workspace to avoid having to type out full path names
    arcpy.env.workspace = workspace
 
    # Process: Central Feature...
    arcpy.CentralFeature_stats(input_FC, CF_output, "Euclidean Distance", weight_field, "#", "#")
 
    # Process: Mean Center...
    arcpy.MeanCenter_stats(input_FC, MEAN_output, weight_field, "#", "#")

    # Process: Median Center...
    arcpy.MedianCenter_stats(input_FC, MED_output, weight_field, "#", "#")
 
except:
    # If an error occurred when running the tool, print out the error message.
    print(arcpy.GetMessages())

Environments

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics