调整栅格以匹配流 (Spatial Analyst 工具)

汇总

修改输入表面栅格在指定位置的像元值。

用法

输出表面栅格（Python 中的 out_surface_raster）参数值仅在沿输入路径处包含修改后的像元值。所有其他像元都将保留输入表面栅格中的原始值。
输入路径要素（Python 中的 in_path_features）参数值表示将要修改像元值的位置。同时支持 2D 和 3D 线。如果指定 2D 线，像元值将从输入表面栅格中提取，并存储在可选的 3D 输出路径要素的折点中。如果指定 3D 线，折点的 Z 值将用于修改像元值。
该工具独立处理每条线，并对每条线使用相同的输入表面栅格。

若两条线发生重叠，最后处理的线具有最高权重的影响力。

若两条线相交（例如在节点处），工具将逐一对其进行处理。若输入路径要素为 3D 线且各交汇折点存储的 Z 值不一致，修改后的像元值可能无法确保下游流向。
当修改方法（Python 中的 modification_method）参数设置为全部选项（Python 中的 ALL）时，工具将使用所有可用折点的 Z 值。

折点数量无需与线下方的像元数量匹配。如果数量不匹配，工具将进行插值。如果数量相同，则不进行插值，工具将根据每个折点的 Z 值修改对应的每个像元。

如果输入路径要素参数值是使用生成溃口线工具创建的且两个工具使用了相同的高程栅格，或者输入路径要素为 2D 线且其折点数量与线下方的像元数量相同，则此方法不会修改输入表面栅格。
当为修改宽度（Python 中的 modification_width）参数指定了大于分析像元大小的值时，工具将通过创建具有 V 形横截面的河道来破开路径。对于分数宽度（例如 1.5 个像元），工具将向上取整。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

标注	说明	数据类型
输入路径要素	用于标识将要修改像元值的位置的输入折线要素。输入可以是 2D 或 3D 线。	Feature Layer
输入表面栅格	输入表面栅格。	Raster Layer
输出路径要素（可选）	输入路径要素的 3D 表示。对于输入表面栅格参数值，每个像元中心处的折线折点将以路径内的最低高程作为其 Z 值，从而构建 3D 形状。	Feature Dataset
修改方法（可选）	指定用于修改表面栅格像元值的方法。端点—将使用起始折点和结束折点的 Z 值进行插值。这是默认设置。全部—将使用所有可用折点的 Z 值进行修改。最大值—将使用所有折点中的最大 Z 值来修改路径下方的所有像元。最小值—将使用所有折点中的最小 Z 值来修改路径下方的所有像元。平均值—将计算所有折点的平均 Z 值并用于修改路径下方的所有像元。	String
修改宽度（可选）	输入表面栅格中被修改路径的宽度。默认情况下，该值为分析像元大小。河道横截面将呈 V 形。	Linear Unit
端点缓冲区（可选）	将在输入路径线的起点和终点处使用的缓冲区。缓冲区可确保表面栅格与路径线起点和终点之间的平滑过渡。	Linear Unit

返回值

标注	说明	数据类型
输出表面栅格	输出表面栅格，其中沿输入路径的像元值已被修改。	Raster

AdjustRasterToStream(in_path_features, in_surface_raster, {out_path_features}, {modification_method}, {modification_width}, {endpoints_buffer})

名称	说明	数据类型
in_path_features	用于标识将要修改像元值的位置的输入折线要素。输入可以是 2D 或 3D 线。	Feature Layer
in_surface_raster	输入表面栅格。	Raster Layer
out_path_features （可选）	输入路径要素的 3D 表示。对于 `in_surface_raster` 参数值，每个像元中心处的折线折点将以路径内的最低高程作为其 Z 值，从而构建 3D 形状。	Feature Dataset
modification_method （可选）	指定用于修改表面栅格像元值的方法。 `ENDPOINTS`—将使用起始折点和结束折点的 Z 值进行插值。这是默认设置。 `ALL`—将使用所有可用折点的 Z 值进行修改。 `MAXIMUM`—将使用所有折点中的最大 Z 值来修改路径下方的所有像元。 `MINIMUM`—将使用所有折点中的最小 Z 值来修改路径下方的所有像元。 `AVERAGE`—将计算所有折点的平均 Z 值并用于修改路径下方的所有像元。	String
modification_width （可选）	输入表面栅格中被修改路径的宽度。默认情况下，该值为分析像元大小。河道横截面将呈 V 形。	Linear Unit
endpoints_buffer （可选）	将在输入路径线的起点和终点处使用的缓冲区。缓冲区可确保表面栅格与路径线起点和终点之间的平滑过渡。	Linear Unit

返回值

名称	说明	数据类型
out_surface_raster	输出表面栅格，其中沿输入路径的像元值已被修改。	Raster

代码示例

AdjustRasterToStream 示例 1（Python 窗口）

本示例使用默认参数值沿输入河流线生成修改后的表面栅格。

from arcpy.sa import *
out_modified_surface = AdjustRasterToStream("in_breach_lines", 
                                             "surface.tif", 
                                             None, 
                                             "ENDPOINTS", 
                                             "", 
                                             "")
out_modified_surface.save("C:/arcpyExamples/outputs/" \
                            "out_modified_surface.tif")

AdjustRasterToStream 示例 2（独立脚本）

本示例使用所有折点中的最小 Z 值沿输入河流线生成修改后的表面栅格。

# Name: AdjustRasterToStream_standalone.py
# Description: Adjusts the cell values of a surface raster along the input 2D stream 
# or lines to the minimum Z value across all the vertices. 
# Additionally, it creates an output shapefile representing the input streams in 3D.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
in_path_features = "breachlines.shp"
in_surface_raster = "surface.tif"
out_3d_path_features = "breachlines_3D.shp"

# Run Adjust Raster to Stream
out_surface_raster = AdjustRasterToStream(in_path_features, 
                                           in_surface_raster, 
                                           out_3d_path_features, 
                                           "MIN", 
                                           "", 
                                           "")

# Save the output
out_surface_raster.save("C:/arcpyExamples/outputs/out_modified_surface.tif")

环境

自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 金字塔, 临时工作空间, 捕捉栅格, 分块大小

许可信息

基本: 需要 Spatial Analyst
标准: 需要 Spatial Analyst
高级: 需要 Spatial Analyst

调整栅格以匹配流 (Spatial Analyst 工具)

汇总

用法

参数

返回值

环境

许可信息

相关主题