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 result layer.
Input layers
The Input layers group includes the following parameters:
The Input stream raster parameter is a raster layer that represents a continuous stream network.
It is recommended that you create the Input stream raster using the same Input surface raster that is input to the tool.
The Input stream raster can be created from the Input surface raster using the Flow Direction, Flow Accumulation, and Con tools, respectively.
To use streams from other sources, for best results, burn them into theInput surface raster 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 is void of sinks, the distance measurements are to stream cells represented by the Input stream raster value.
If the Input surface raster 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 following 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 to create the Input flow direction raster using the Input surface raster that is input to the tool.
The Input flow direction raster limits the directions along which flow distance is measured.
If the Input flow direction raster is not 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:
- The Distance type parameter 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.
- The Statistic type parameter identifies the statistic type that will be used to compute flow distance over multiple flow paths.
- 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 determines 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.
- 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
- Parallel processing factor
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 licensing and configurations:
- Creator or GIS Professional user type
- Publisher or Administrator role, or an equivalent custom role
- Available when the organization is configured for raster analytics with a premium capability license
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