The Flow Distance tool calculates the horizontal or vertical downslope distance from each cell to the stream into which they flow.
The output is a hosted imagery layer.
Usage notes
Flow Distance includes configurations for input layers, analysis settings, and the result layer.
Input layers
The Input layers group includes the following parameters:
Input stream raster is a raster layer that represents a continuous stream network.
It is recommended that you create the Input stream raster layer using the same Input surface raster layer that is input to the tool.
The Input stream raster layer can be created from the Input surface raster layer using the Flow Direction, Flow Accumulation, and Con tools, respectively.
To use streams from other sources, for best results, add them to theInput surface raster layer first. Then run the Flow Direction tool on the result.
The Input surface raster is the elevation raster that will be used for calculation.
If the Input surface raster layer is void of sinks, the distance measurements are to stream cells represented by the Input stream raster value.
If the Input surface raster layer has sinks present, some flow paths may be terminated by flowing into sinks before reaching streams. In such cases, flow distance measurements for these cells are calculated only up to the sink cells into which they flow.
- The Optional layer group includes the Input flow direction raster parameter.
The Input flow direction raster parameter specifies the raster that shows the direction of flow out of each cell. The flow direction raster can be created using the Flow Direction tool with the D8, Multiple Flow Direction (MFD), or D-Infinity (DINF) method. Use the Flow direction type parameter to specify the method that was used when the flow direction raster was created.
It is recommended that you use the Input surface raster layer that is input to this tool to create the Input flow direction raster layer.
The Input flow direction raster parameter limits the directions along which flow distance is measured.
If no Input flow direction raster layer is specified, flow distance is assessed considering all possible downslope flow paths from each cell to the cells on the stream into which they flow.
Flow distance settings
The Flow distance settings group includes the following parameters:
- Distance type specifies whether the vertical or horizontal component of flow distance will be calculated.
- Vertical—The flow distance calculations represent the vertical component of flow distance, following the flow path, from each cell in the domain to the cells on the stream into which they flow. This is the default.
- Horizontal—The flow distance calculations represent the horizontal component of flow distance, following the flow path, from each cell in the domain to the cells on the stream into which they flow.
- The Flow direction type parameter specifies the type of flow method that will be used when computing flow direction. Specify the method (D8, MFD or DINF) that was used when creating the raster specified in the Input flow direction raster.
- Statistic type specifies the statistic type that will be used to compute flow distance over multiple flow paths. The options are as follows:
- Minimum—Where multiple flow paths exist, minimum flow distance will be computed. This is the default.
- Weighted mean—Where multiple flow paths exist, a weighted mean of flow distance will be computed. Flow proportion from a cell to its downstream neighboring cells are used as weights for computing weighted mean.
- Maximum—Where multiple flow paths exist, maximum flow distance will be computed.
Result layer
The Result layer group includes the following parameters:
- Output name specifies the name of the layer that is created and added to the map. The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Output layer type specifies the type of raster output that will be created. The output can be either a tiled imagery layer or a dynamic imagery layer.
- Save in folder specifies the name of a folder in My content where the result will be saved.
Environments
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the following analysis environments:
- Output coordinate system
- Processing extent
Note:
The default processing extent in Map Viewer is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.
- Snap raster
- Cell size
- Mask
Credits
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
Output
The Output raster name layer stores the flow distance from each cell to the stream into which they flow.
Usage requirements
This tool requires the following user type and configurations:
- Professional or Professional Plus user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role with the Imagery Analysis privilege
Resources
Use the following resources to learn more:
- Flow Distance in ArcGIS REST API
- flow_distance in ArcGIS API for Python
- Flow Distance in ArcGIS Pro with the Raster Analysis extension
- Flow Distance in ArcGIS Pro with the Spatial Analyst extension