Skip to main content

ZonalRemap

汇总

根据其他栅格中定义的区域以及在表中定义的区域相关值映射来将栅格对象的像素值分类为组。

讨论

有关此函数工作原理的详细信息，请参阅 分区重映射 栅格函数。

栅格对象所引用的栅格数据集是临时性的。 要将其设置为永久，可以调用栅格对象的 save 方法。

语法

ZonalRemap(raster, zonal_attribute_table, {zone_raster}, {zone_field}, {min_value_field_name}, {max_value_field_name}, {output_value_field_name}, {background_value}, {default_output_value}, {where_clause})

参数 说明 数据类型

raster

包含要重映射的像素值的单波段栅格输入。

Raster

zonal_attribute_table

至少包含三个字段的表格。该表必须具有最小阈值、最大阈值和目标值。目标值为将包含重映射值的字段的名称。

输入的格式可以是要素类、要素服务或 ArcGIS 支持的任何表格类型。

String

zone_raster

所含的每个像素均定义与特定位置相关联区域的单波段栅格。区域定义为输入中具有相同值的所有区域。各区域无需相连。

(默认值为 None)

RasterCollection

zone_field

位于 zonal_attribute_table 中且包含区域 ID 值的字段名。

区域 ID 值直接与分区栅格中的区域 ID 连接。区域 ID 值将在重映射时提供其他级别的过滤。如果没有区域 ID 与表格中的特定记录相关联，则该值将不会参与重映射。

(默认值为 'ZoneID')

String

min_value_field_name

包含重映射输入像素时应大于的最小值的字段名。

如果未指定像素值或如果字段值为空，将不会测试像素值的最小值。

(默认值为 'ZoneMin')

String

max_value_field_name

包含重映射输入像素时应小于的最大值的字段名。

如果未指定像素值或如果字段值为空，将不会测试像素值的最大值。

(默认值为 'ZoneMax')

String

output_value_field_name

包含输入像素要重映射到的目标值的字段名。

如果未指定像素值或如果字段值为空，重映射的像素值将设置为 default_output_value 。

(默认值为 'ZoneValue')

String

background_value

重映射输入像素之前的输出栅格初始像素值。

(默认值为 0)

String

default_output_value

将向不满足 zonal_attribute_table 中设置的任一条件的像素指定的值。

如果未指定 output_value_field_name 参数或未在 zonal_attribute_table 中指定对应分区阈值的输出值，则该值也将成为输出像素的值。

(默认值为 255)

String

where_clause

应用于 zonal_attribute_table 的查询。

(默认值为 None)

String

返回值

数据类型 说明

Raster

重映射的栅格对象。

代码示例

分区重映射示例

根据其他栅格中定义的区域或在表中定义的区域相关值来重映射栅格中的像素。

from arcpy.sa import *
out_zonalremap_raster = ZonalRemap("cloudceilings.tif","zonal.csv", "zone.tif")
out_zonalremap_raster.save("C:/arcpyExamples/outputs/Zonal_remap.tif")
分区重映射示例

根据其他栅格中定义的区域或在表中定义的区域相关值来重映射栅格中的像素。

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

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

# Set the local variables
in_raster = "NDVI.tif"
zonal_attribute_table = "zonal.csv"
zone_raster = "neighborhoods.tif"

# Apply ZonalRemap function
zonal_remap_raster = ZonalRemap(in_raster, zonal_attribute_table, zone_raster)

# Save the output
zonal_remap_raster.save("C:/arcpyExamples/outputs/NDVI.tif")