“最佳路径为栅格”工具确定从目的地到源的最佳栅格路径。
注：
该工具现在可以在 Map Viewer 中使用，这是 ArcGIS Enterprise 中的现代化地图制作工具。 有关详细信息，请参阅最佳路径为栅格 (Map Viewer)。
要运行此工具，门户必须针对栅格分析进行配置。
如果在 Map Viewer 经典版 中没有看到该工具，请联系您的组织管理员。 您的门户可能无法配置为用于路径选择，或者您不具备运行该工具所需的权限。
工作流示意图
示例
示例应用如下：
- 查找新道路的最佳路径。
- 查找从某个位置开始的下溯追踪。
用法说明
在生成最佳路径之前，通常使用以下工具之一来创建距离累积栅格和反向栅格：距离累积或距离分配。 这些是生成最佳路径所需的输入。
创建的最佳路径可以是基于 D8 流向的流动路径。 要以此方式生成最佳路径，将 D8 流向栅格用作输入反向或流向栅格的输入。 还需要提供输入距离累积栅格；输入距离累积栅格不用于确定路径。 无论您使用常量栅格还是数字高程模型 (DEM)，您的路径都是相同的；只有路径上的属性值会有所不同。 流向栅格函数可用于生成 D8 流向栅格。
当输入目标数据是栅格时，目标像元集包括输入栅格中的所有像元或具有有效值的要素目标数据。 具有 NoData 值的像元不包括在源集内。 值零将被视为合法目标。
使用输入目标的要素数据时，必须注意输出像元大小的管理方式，特别是在输出像元相对于输入中的详细信息较为粗略时尤其如此。 系统将应用使用“要素转栅格”工具的内部栅格化过程。 这意味着，不在像元中心的数据将不会包含在中间栅格化目标输出中，也不会在距离计算中表示出来。 例如，如果您的目标是一系列相对于输出像元大小偏小的面，如建筑物覆盖区，则可能只有一部分面会落入输出栅格像元的中心，从而导致分析中会缺少其他许多面。
输出最佳路径上的值表示给定位置处的路径数。 在许多情况下，路径随沿相同的路线，留下一个目的地，然后汇聚到同一个源 例如，值 1 表示在给定位置只有一条最佳路径，而值 5 表示在该位置存在 5 条经过研究区域中的该像元的最佳路径。
要生成最佳路径，将忽略范围、像元大小和捕捉栅格环境设置，并且使用反向栅格的特征计算输出栅格。 如果对反向栅格重采样或重新捕捉或改变范围，则该栅格的模式将被严重更改。
下表列出了此工具的参数：
| 参数 | 说明 |
|---|---|
| 选择目标栅格或要素 | 用于识别像元的栅格或要素输入（将确定的最佳路径为该像元与最佳源之间的路径）。 如果输入是栅格，则它必须由具有有效目标值（零是有效值）的像元组成，并且必须为其余的像元指定 NoData。 输入栅格类型必须为整型。 |
| 目标字段 | 要用于获得目标位置的值的字段。 |
| 选择距离累积栅格 | 距离累积栅格将用于确定从目的地到源的最佳路径。 距离累积栅格通常使用距离累积或距离分配工具进行创建。 距离累积栅格中的每个像元表示表面上从每个像元到源像元集的最小累积成本距离。 |
| 选择反向或流向栅格 | 反向栅格包含以度为单位的计算方向。 该方向用于标识沿最佳路径返回最小累积成本源同时避开障碍的下一个像元。 反向栅格通常使用距离累积或距离分配工具进行创建。 在本例中，值的范围是 0 度到 360 度。 值 0 留供源像元使用。 正东（右侧）是 90 度，且值以顺时针方向增加（180 是南方、270 是西方、360 是北方）。 创建的最佳路径可以是基于 D8 流向的流动路径。 要以此方式生成最佳路径，请将 D8 流向栅格用作此参数的输入。 |
| 路径类型（可选） | 用于指定对输入目标数据中的值和区域在成本路径计算中的解释方式进行定义的关键字。
|
| 结果图层名称 | 您可以使用将结果保存在下拉框指定我的内容中的文件夹名称，结果将保存到该文件夹中。 |
环境
分析环境设置是影响工具执行结果的附加参数。 您可以通过单击工具窗格顶部的齿轮图标 
来访问该工具的分析环境设置。
该工具支持以下分析环境：
- 输出坐标系 - 指定输出图层的坐标系。
类似的工具和栅格函数
“最佳路径为栅格”工具确定从目的地到源的最佳栅格路径。 其他工具或许在解决类似问题时十分有用。
Map Viewer 经典版 分析工具和栅格函数
使用最佳路径为栅格工具计算最佳路径并创建要素服务输出。
最佳路径为栅格可作为栅格函数使用。
ArcGIS Pro 分析工具和栅格函数
最佳路径为栅格和最佳路径为线地理处理工具在 Spatial Analyst 和 Raster Analysis 工具箱中受支持。
最佳路径为栅格和最佳路径为线地理处理工具在 Raster Analysis 工具箱中受支持。
最佳路径为栅格可作为栅格函数。
ArcGIS Enterprise 开发者资源
如果您正在使用 ArcGIS REST API，请使用 Optimal Path As Line 和 Optimal Path As Raster 任务。
如果您正在使用 ArcGIS API for Python，则请使用来自 arcgis.raster.analytics 模块的 optimal_path_as_line 
或使用来自 arcgis.raster.functions.gbl 模块的 optimal_path_as_raster 。