com.esri.arcgis.geoprocessing.tools.spatialstatisticstools
Class MedianCenter

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.spatialstatisticstools.MedianCenter

All Implemented Interfaces:

GPTool

public class MedianCenter
extends AbstractGPTool

Identifies the location that minimizes overall Euclidean distance to the features in a dataset. The Median Center tool is contained in the Spatial Statistics Tools tool box.

Usage tips:

• While the tool returns a point at the average X and average Y coordinate for all feature centroids, the median center uses an iterative algorithm to find the point that minimizes Euclidean distance to all features in the dataset.
• Both the and Median Center are measures of central tendency. The algorithm for the Median Center tool is less influenced by data outliers.
• Calculations based on feature distances require to accurately measure distances.
• 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.
• The Case Field is used to group features for separate median center computations. When a Case Field is specified, the input features are first grouped according to case field values, and then a median center is calculated for each group. The case field can be of numeric, date, or string type, and will appear as an attribute in the Output Feature Class.
• The x and y values for the median center feature(s) are attributes in the output feature class. The values are stored in the fields XCOORD and YCOORD.
• The data median will be computed for all fields specified in the Attribute Field(s) parameter.
• 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.
• When using shapefiles, keep in mind that they cannot store null values. Tools or other procedures that create shapefiles from non-shapefile inputs may store or interpret null values as zero. This can lead to unexpected results. See also .

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

MedianCenter()
Creates the Median Center tool with defaults.

MedianCenter(Object inputFeatureClass, Object outputFeatureClass)
Creates the Median Center tool with the required parameters.

Method Summary

Object	getAttributeField() Returns the Attribute Field parameter of this tool .
Object	getCaseField() Returns the Case Field parameter of this tool .
Object	getInputFeatureClass() Returns the Input Feature Class parameter of this tool .
Object	getOutputFeatureClass() Returns the Output Feature Class parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
Object	getWeightField() Returns the Weight Field parameter of this tool .
void	setAttributeField(Object attributeField) Sets the Attribute Field parameter of this tool .
void	setCaseField(Object caseField) Sets the Case Field parameter of this tool .
void	setInputFeatureClass(Object inputFeatureClass) Sets the Input Feature Class parameter of this tool .
void	setOutputFeatureClass(Object outputFeatureClass) Sets the Output Feature Class parameter of this tool .
void	setWeightField(Object weightField) Sets the Weight Field parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MedianCenter

public MedianCenter()

Creates the Median Center tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

MedianCenter

public MedianCenter(Object inputFeatureClass,
                    Object outputFeatureClass)

Creates the Median Center tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inputFeatureClass - a feature class for which the median center will be calculated.

outputFeatureClass - a point feature class that will contain the features representing the median centers of the input feature class.

Method Detail

getInputFeatureClass

public Object getInputFeatureClass()

Returns the Input Feature Class parameter of this tool . This parameter is a feature class for which the median center will be calculated. This is a required parameter.

Returns:

the Input Feature Class

setInputFeatureClass

public void setInputFeatureClass(Object inputFeatureClass)

Sets the Input Feature Class parameter of this tool . This parameter is a feature class for which the median center will be calculated. This is a required parameter.

Parameters:

inputFeatureClass - a feature class for which the median center will be calculated.

getOutputFeatureClass

public Object getOutputFeatureClass()

Returns the Output Feature Class parameter of this tool . This parameter is a point feature class that will contain the features representing the median centers of the input feature class. This is a required parameter.

Returns:

the Output Feature Class

setOutputFeatureClass

public void setOutputFeatureClass(Object outputFeatureClass)

Sets the Output Feature Class parameter of this tool . This parameter is a point feature class that will contain the features representing the median centers of the input feature class. This is a required parameter.

Parameters:

outputFeatureClass - a point feature class that will contain the features representing the median centers of the input feature class.

getWeightField

public Object getWeightField()

Returns the Weight Field parameter of this tool . This parameter is the numeric field used to create a weighted median center. This is an optional parameter.

Returns:

the Weight Field

setWeightField

public void setWeightField(Object weightField)

Sets the Weight Field parameter of this tool . This parameter is the numeric field used to create a weighted median center. This is an optional parameter.

Parameters:

weightField - the numeric field used to create a weighted median center.

getCaseField

public Object getCaseField()

Returns the Case Field parameter of this tool . This parameter is field used to group features for separate median center calculations. The case field can be of numeric, date, or string type. This is an optional parameter.

Returns:

the Case Field

setCaseField

public void setCaseField(Object caseField)

Sets the Case Field parameter of this tool . This parameter is field used to group features for separate median center calculations. The case field can be of numeric, date, or string type. This is an optional parameter.

Parameters:

caseField - field used to group features for separate median center calculations. The case field can be of numeric, date, or string type.

getAttributeField

public Object getAttributeField()

Returns the Attribute Field parameter of this tool . This parameter is numeric field(s) for which the data median value will be computed. This is an optional parameter.

Returns:

the Attribute Field

setAttributeField

public void setAttributeField(Object attributeField)

Sets the Attribute Field parameter of this tool . This parameter is numeric field(s) for which the data median value will be computed. This is an optional parameter.

Parameters:

attributeField - numeric field(s) for which the data median value will be computed.

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias