This tool calculates distance allocation for each cell to the provided sources based on straight-line distance, cost distance, true surface distance, and vertical and horizontal factors.
Example applications include answering questions such as the following:
If Use current map extent is checked, only those features in the input layer that are visible within the current map extent will be analyzed. If unchecked, all features in the input layer will be analyzed, even if they are outside the current map display extent.
A raster or feature layer that identifies the sources to which the distance will be calculated.
If the input is a raster, it must consist of cells that have valid values (zero is a valid value) for the sources, and the remaining cells must be assigned NoData.
If the input is a feature layer, it can be point, line, or polygon.
The field used to assign values to the source locations. It must be of type integer.
The dataset that defines the barriers.
For a raster layer, the input type can be integer or float. Any cells that have a value (including zero) will be treated as a barrier. Any cells that are NoData will not be treated as a barrier.
For a feature service, the input can be point, line, or polygon.
A raster defining the elevation values at each cell location.
The values are used to calculate the actual surface distance covered when passing between cells.
A raster defining the impedance, or cost, to move planimetrically through each cell.
The value at each cell location represents the cost-per-unit distance for moving through the cell. Each cell location value is multiplied by the cell resolution while also compensating for diagonal movement to obtain the total cost of passing through the cell.
The values of the cost raster can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).
A raster defining the z-values for each cell location.
The values are used for calculating the slope that is used to identify the vertical factor incurred when moving from one cell to another.
The Vertical factor defines the relationship between the vertical cost factor and the vertical relative moving angle.
There are several factors with modifiers from which to select that identify a defined vertical factor graph. The graphs are used to identify the vertical factor used in calculating the total cost for moving into a neighboring cell.
In the descriptions below, vertical factor (VF) defines the vertical difficulty encountered in moving from one cell to the next, and the vertical relative moving angle (VRMA) modifier identifies the slope angle between the From source cell and the To source cell.
The modifiers to the vertical parameters are as follows:
A raster defining the horizontal direction at each cell.
The values on the raster must be integers ranging from 0 to 360, with 0 degrees being north, or toward the top of the screen, and increasing clockwise. Flat areas should be given a value of -1. The values at each location will be used in conjunction with the Horizontal factor to determine the horizontal cost incurred when moving from a cell to its neighbors.
The Horizontal factor defines the relationship between the horizontal cost factor and the horizontal relative moving angle.
There are several factors with modifiers from which to select that identify a defined horizontal factor graph. The graphs are used to identify the horizontal factor that is used in calculating the total cost of moving into a neighboring cell.
In the descriptions below, horizontal factor (HF) defines the horizontal difficulty encountered when moving from one cell to the next, and horizontal relative moving angle (HRMA) identifies the angle between the horizontal direction from a cell and the moving direction.
The definitions and parameters of these HF are as follows:
The modifiers to the horizontal keywords are as follows:
The initial accumulative cost to begin the cost calculation.
This allows for the specification of the fixed cost associated with a source. Instead of starting at a cost of zero, the cost algorithm will begin with the value set by Initial accumulation.
The values must be zero or greater. The default is 0.
The maximum accumulation for the traveler for a source.
The cost calculations continue for each source until the specified accumulation is reached.
The values must be greater than zero. The default accumulation is to the edge of the output raster.
The multiplier to apply to the cost values.
This allows for control of the mode of travel or the magnitude at a source. The greater the multiplier, the greater the cost to move through each cell.
The values must be greater than zero. The default is 1.
Specifies the direction of the traveler when applying horizontal and vertical factors.
From source—The horizontal factor and vertical factor will be applied beginning at the input source and travel out to the nonsource cells. This is the default.
To source—The horizontal factor and vertical factor will be applied beginning at each nonsource cell and travel back to the input source.
Specify the From source or To source keyword, which will be applied to all sources, or specify a field in the source data that contains the keywords to identify the direction of travel for each source. That field must contain the string FROM_SOURCE
or TO_SOURCE
.
Specifies whether to calculate the distance using a planar (flat earth) or a geodesic (ellipsoid) method.
The name of the layer that will be created in My Content and added to the map. The default name is based on the tool name and the input layer name. If the layer already exists, you will be prompted to provide another name.
You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box. If you have the privileges to create both tiled and dynamic imagery layers, you can specify which layer type to generate in the output using the Save result as drop-down box.
The distance accumulation raster contains the accumulative distance for each cell from, or to, the least-cost source.
The output raster is of type float.
The name of the layer that will be created in My Content and added to the map. The default name is based on the tool name and the input layer name. If the layer already exists, you will be prompted to provide another name.
You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box. If you have the privileges to create both tiled and dynamic imagery layers, you can specify which layer type to generate in the output using the Save result as drop-down box.
The back direction raster contains the calculated direction in degrees. The direction identifies the next cell along the shortest path back to the closest source while avoiding barriers.
The range of values is from 0 degrees to 360 degrees, with 0 reserved for the source cells. Due east (right) is 90, and the values increase clockwise (180 is south, 270 is west, and 360 is north).
The output raster is of type float.
The name of the layer that will be created in My Content. You must provide a name that does not currently exist in My Content.
You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box. If you have the privileges to create both tiled and dynamic imagery layers, you can specify which layer type to generate in the output using the Save result as drop-down box.
The source direction raster identifies the direction of the least accumulated cost source cell as an azimuth in degrees.
The range of values is from 0 degrees to 360 degrees, with 0 reserved for the source cells. Due east (right) is 90, and the values increase clockwise (180 is south, 270 is west, and 360 is north).
The output raster is of type float.
The name of the layer that will be created in My Content. You must provide a name that does not currently exist in My Content.
You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box. If you have the privileges to create both tiled and dynamic imagery layers, you can specify which layer type to generate in the output using the Save result as drop-down box.
The source location raster is a multiband output. The first band contains a row index, and the second band contains a column index. These indexes identify the location of the source cell that is the least accumulated cost distance away.
The name of the layer that will be created in My Content. You must provide a name that does not currently exist in My Content.
You can specify the name of a folder in My Content where the result will be saved using the Save result in drop-down box. If you have the privileges to create both tiled and dynamic imagery layers, you can specify which layer type to generate in the output using the Save result as drop-down box.