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")

Связанные разделы