Skip To Content

Euclidean Allocation function

Available with Spatial Analyst license.

Overviews

Calculates, for each cell, the nearest source based on Euclidean distance.

Euclidean Allocation illustration

Learn more about Euclidean distance analysis

Notes

The Source Raster must be a raster. If your source is a feature class, you will need to convert it to a raster before you can use it as an input. The NoData values that exist in the Source Raster are not included as valid values in the function. The value 0 is considered a legitimate value in the source raster. A Source Raster can be created using the extraction tools or the Clip function.

The Maximum Distance is specified in the same map units as the Source Raster.

The Value Raster is useful if the Source Raster was derived from an operation that resulted in Boolean pixel values. These operations cause the Source Raster to lose the original zone values that were associated with the source pixel locations. The Value Raster can either restore these pixel values or allow analysis on additional combinations of zone values within the source pixels. If the Value Raster is used, it may change the configuration and results of the output.

If the Mask has been set in the geoprocessing environments, and the pixels to be masked will cover a source location, the Euclidean calculations will occur on the remaining source locations. The source pixels that are masked will not be considered in the computations; these pixels will be assigned a value of NoData. Any pixel location that is assigned NoData on the input surface will receive NoData on all the output rasters. See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this function.

Parameters

Parameter nameDescription

Source Raster

(Required)

The input raster that identifies the pixels or locations to which the Euclidean distance for every output pixel location is calculated. The input type can be an integer or a floating point value.

If the input Source Raster is floating point, the Value Raster must be set, and it must be an integer. The Value Raster will take precedence over any setting of the Source Field.

Source Field

The field used to assign values to the source locations. It must be an integer type. If the Value Raster has been set, the values in that input will take precedence over any setting for the Source Field.

Maximum Distance

The threshold that the accumulative distance values cannot exceed. If an accumulative Euclidean distance exceeds this value, the output value for the pixel location will be NoData. The default distance is to the extent of the output raster.

Value Raster

The input integer raster that identifies the zone values to be used for each input source location. For each source location pixel, the value defined by the Value Raster will be assigned to all pixels allocated to the source location for the computation. The Value Raster will take precedence over any setting for the Source Field.

Cellsize

The pixel size at which the output raster will be created. If the cell size was explicitly set in Environments, that will be the default cell size. If Environments was not set, the output cell size will be the same as the Source Raster.

Environment settings

Geoprocessing Environment settings for global functions are controlled at the application level. Setting processing environments in ArcGIS Pro can be done by selecting the Environments button on the Analysis tab. See Analysis environments and Spatial Analyst for additional details on environment settings.

The following environments are supported by this global function: