流动距离 (栅格分析)

摘要

计算每个像元（沿流动路径）与流入的流上像元之间下坡距离的水平或垂直分量。 如果是多个流动路径，则需要计算最小或最大流动距离，以及流动距离的加权平均数。

如果提供可选流向栅格，则下坡方向将限于由输入流向栅格定义的方向。

插图

使用情况

• 当您登录到已针对 Raster Analysis 配置 ArcGIS Image Server 的 ArcGIS Enterprise 门户时，可以使用此栅格分析门户工具。 工具运行时，ArcGIS Pro 将充当客户端，并且处理将在与 ArcGIS Enterprise 联合的服务器中进行。 门户工具接受来自门户的图层作为输入，并在门户中创建输出。

  输入栅格图层支持门户中的图层、影像服务的 URI 或 URL 或者创建影像服务器图层工具的输出。 此工具不支持本地栅格数据或图层。

• 要限制测量流动距离的下坡方向，请提供一个可选的输入流向栅格，可以使用流向工具获得该栅格。 生成可选输入流向栅格时，可以从 D8、D-Infinity (DINF) 和多流向 (MFD) 流动模型中选择。 可以使用输入流向类型来指定创建流向栅格时所使用的方法。

• 如果提供了可选输入流向栅格，则建议使用您将提供给流动距离工具的同一输入表面栅格，通过流向工具来创建该栅格。

  如果此输入表面栅格没有汇，则距离测量将测量到由输入流栅格表示的流像元的距离。

  如果此输入表面栅格具有汇，则在到达流之前，一些流动路径可能因流入汇而过早终止。 在此情况下，这些像元的流动距离测量只能计算到其流入的汇像元。

• 在没有提供可选流向栅格的情况下运行该工具时，会根据每个像元到其所流入的河流上像元的所有可能下坡水流路径，评估流动距离。

  如果使用可选 D8 流向栅格来运行该工具，则从每个像元到流上的某个像元可能只有一条下坡流动路径，并将沿此单一流动路径测量流动距离。

• 建议使用作为工具输入提供的同一输入表面栅格来创建输入流栅格。 如果拥有可用的 Spatial Analyst 扩展许可，则可以分别使用流向、流量和条件函数工具根据输入表面栅格创建流栅格。 如果您希望使用来自其他数据源的河流，为获得最佳结果，您必须首先将其融入输入表面栅格，然后再运行流动距离工具。

• 如果从每个像元到其沿流动路径流经的流上的像元存在多个流动路径，请使用统计类型来计算最小或最大流动距离，或流动距离的加权平均数。

  如果从每个像元到流上的某个像元只存在单一流动路径，则所有统计类型都将产生相同的结果。

参数

对话框

标注	说明	数据类型
输入流栅格	定义河流网络的输入栅格。	Raster Layer; Image Service; String
输入表面栅格	输入栅格表示连续表面。	Raster Layer; Image Service; String
输出名称	输出流动距离栅格服务的名称。 默认名称基于工具名称以及输入图层名称。 如果该图层名称已存在，则系统将提示您提供其他名称。	String
输入流向栅格 (可选)	根据每个像元来显示流向的输入栅格。 如果提供流向栅格，则下坡方向将限于由输入流向定义的方向。 可以使用 D8、MFD 或 DINF 方法创建流向栅格。 使用流向类型参数指定创建流向栅格时所使用的方法。	Raster Layer; Image Service; String
距离类型 (可选)	要计算的距离类型。 垂直—流动距离计算表示属性域中的每个像元到其沿水流路径流入的河流上像元的最小流动距离的垂直分量。 这是默认设置。 水平—流动距离计算表示属性域中的每个像元到其沿水流路径流入的河流上像元的最小流动距离的水平分量。	String
流向类型 (可选)	指定输入流向栅格类型。 D8—输入流向栅格为 D8 类型。 这是默认设置。 MFD—输入流向栅格为多流向 (MFD) 类型。 DINF—输入流向栅格为 D-Infinity (DINF) 类型。	String
统计类型 (可选)	确定用于计算多个流动路径上的流动距离的统计类型。 如果从每个像元到流上的某个像元只存在单一流动路径，则所有统计类型都将产生相同的结果。 最小值—如果存在多个流动路径，则需要计算最小流动距离。 这是默认设置。 加权平均数—如果存在多个流动路径，则需要计算流动距离的加权平均数。 从某个像元到其下游相邻像元的流量比例可用作计算加权平均数的权重。 最大值—如果存在多个流动路径，则需要计算最大流动距离。	String

派生输出

标注	说明	数据类型
输出栅格	输出栅格。	Raster Layer

Python

arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})

名称	说明	数据类型
inputStreamRaster	定义河流网络的输入栅格。	Raster Layer; Image Service; String
inputSurfaceRaster	输入栅格表示连续表面。	Raster Layer; Image Service; String
outputName	输出流动距离栅格服务的名称。 默认名称基于工具名称以及输入图层名称。 如果该图层名称已存在，则系统将提示您提供其他名称。	String
inputFlowDirectionRaster (可选)	根据每个像元来显示流向的输入栅格。 如果提供流向栅格，则下坡方向将限于由输入流向定义的方向。 可以使用 D8、MFD 或 DINF 方法创建流向栅格。 使用 flowDirectionType 参数指定创建流向栅格时所使用的方法。	Raster Layer; Image Service; String
distanceType (可选)	要计算的距离类型。 VERTICAL—流动距离计算表示属性域中的每个像元到其沿水流路径流入的河流上像元的最小流动距离的垂直分量。 这是默认设置。 HORIZONTAL—流动距离计算表示属性域中的每个像元到其沿水流路径流入的河流上像元的最小流动距离的水平分量。	String
flowDirectionType (可选)	指定输入流向栅格类型。 D8—输入流向栅格为 D8 类型。 这是默认设置。 MFD—输入流向栅格为多流向 (MFD) 类型。 DINF—输入流向栅格为 D-Infinity (DINF) 类型。	String
statisticsType (可选)	确定用于计算多个流动路径上的流动距离的统计类型。 如果从每个像元到流上的某个像元只存在单一流动路径，则所有统计类型都将产生相同的结果。 MINIMUM—如果存在多个流动路径，则需要计算最小流动距离。 这是默认设置。 WEIGHTED_MEAN—如果存在多个流动路径，则需要计算流动距离的加权平均数。 从某个像元到其下游相邻像元的流量比例可用作计算加权平均数的权重。 MAXIMUM—如果存在多个流动路径，则需要计算最大流动距离。	String

派生输出

名称	说明	数据类型
outputRaster	输出栅格。	Raster Layer

代码示例

FlowDistance 示例 1（Python 窗口）

本示例将计算到河流栅格上像元的最小下坡水平流动距离。

import arcpy
arcpy.ra.FlowDistance("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")

FlowDistance 示例 2（独立脚本）

本示例将计算到河流栅格上像元的最小下坡垂直流动距离。

#---------------------------------------------------------------------------
# Name: FlowDistance_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inStreams = "https://myserver/rest/services/streams/ImageServer"
inSurface = "https://myserver/rest/services/elevation_fill/ImageServer"
outputFlowDistance = "outFlowDistanceVertical2"
inFlowDirection = ""
distanceType = "VERTICAL"

# Execute Flow Distance raster analysis tool
arcpy.ra.FlowDistance(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)

环境

像元大小, 范围, 掩膜, 输出坐标系, 金字塔, 捕捉栅格

许可信息

• Basic: 需要 ArcGIS Image Server
• Standard: 需要 ArcGIS Image Server
• Advanced: 需要 ArcGIS Image Server