Краткая информация
Разбивает значения пикселов растрового объекта на группы на основании зон, заданных в другом растре, и сопоставления значений, зависимых от зон, в таблице.
Обсуждение
Для получения дополнительной информации о том, как работает эта функция, см. растровую функцию Зональная перекодировка.
Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта 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.ia 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.ia import *
# Set the local variables
in_raster = "C:/data/NDVI.tif"
zonal_attribute_table = "C:/data/Features.gdb/remapValues"
zone_raster = "C:/data/neighborhoods.tif"
# Apply ZonalRemap function
zonal_remap_raster = arcpy.ia.ZonalRemap(in_raster, zonal_attribute_table, zone_raster)
# Save the output
zonal_remap_raster.save("C:/arcpyExamples/outputs/neighborhood_NDVI.tiff")