| Подпись | Описание | Тип данных |
Входные растровые или векторные данные зон | Набор данных, определяющий зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем. | Raster Layer; Feature Layer |
Поле зоны | Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | Field |
Входной растр значений | Растр, содержащий значения, которые будут использоваться для создания гистограммы. | Raster Layer |
Выходная таблица | Выходной файл таблицы. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных в рабочей области базы геоданных, и таблица dBASE, если рабочая область представляет собой папку с файлами. Дополнительная выходная диаграмма создается по информации в таблице. | Table |
Имя выходной диаграммы (Дополнительный) | Имя выходной диаграммы для отображения. График будет содержаться на панели Содержание в разделе Автономные таблицы. | Graph |
Зоны как строки в выходной таблице (Дополнительный) | Определяет, каким образом значения входного растра значений будут представлены в выходной таблице.
| Boolean |
Доступно с лицензией Spatial Analyst.
Краткая информация
Создает таблицу и график гистограммы, показывающие плотность распределения значений ячеек на входных данных значений для каждой уникальной зоны.
Использование
Зональная гистограмма позволяет исследовать плотность распределения значений в одном наборе данных в пределах классов другого набора данных. Примеры включают распределение уклонов в классах землепользования, распределения осадков в классах высот или распределение преступлений избиения полицейскими.
Число классов зональной гистограммы зависит от того, как задано значение параметра Входной растр значений (in_value_raster в Python).
Если он задан как набор растровых данных, применяются следующие условия:
- Для целочисленного растра с менее, чем 25 уникальными значениями, число классов будет соответствовать числу уникальных значений в растре значений.
- Для целочисленного растра с более, чем 25 уникальными значениями, значения разбиваются на 256 классов, от 1 до 256. Если число уникальных значений меньше 256, некоторые классы получат идентификатор 0.
- Для растра с плавающей точкой значения будут разделены на 256 классов, от 1 до 256.
Если он задан как растровый слой, применяются следующие условия:
- Для символов Растяжки будет использован тип растяжки, а значения будут разбиты на 256 классов - от 1 до 256.
- Для символов Классификации или Уникальных значений число классов будет соответствовать числу классов или уникальных значений в установках символов.
- Зональный анализ выполняется в пределах диапазона значений, указанного в настройках символов Растяжка, Классификация или Уникальные значения. Значения в растре значений, которые не отображены в символах, игнорируются при расчетах.
- При выполнении зонального анализа игнорируются символы Дискретные цвета и Векторное поле. Анализ будет выполняться только для типа данных и числа уникальных значений в растре значений, так же как и при указании для входного растра значений набора растровых данных.
- Зональная гистограмма покажет значения классов ил надписей символов слоя растра значений.
Зона определяется как все области входных данных, имеющие одно значение. Области не обязательно должны быть непрерывными. И растры, и векторные объекты могут использоваться для входных данных зон.
Если значение параметра Входные растровые или векторные данные зон (in_zone_data в Python) является растром, это должен быть целочисленный растр.
Если значение параметра Входные растровые или Векторные данные зон является объектами, они будут конвертированы в растр с использованием размера ячейки и выравнивания ячеек из параметра Входной растр значений (in_value_raster в Python).
Если размер ячейки, выравнивание ячеек или пространственная привязка параметров Входные растровые или векторные данные зон и Входной растр значений различаются, то значение параметра Входной растр значений будет использоваться в качестве Размера ячейки, Растра привязки и Выходной системы координат во внутренней обработке. Любой из этих случаев приведет к внутреннему перерасчету перед выполнением зональной операции.
Если входные данные зон и значений являются растрами с одинаковым размером ячеек, и с корректным выравниванием, они будут использоваться непосредственно в инструменте и не будут пересчитаны во время обработки инструмента.
Если значение Входные растровые или векторные данные зон представлено точечными объектами, возможно, что в каждую конкретную ячейку входного растра значений попадет больше одной точки. Для таких ячеек значение зоны определяется точкой с наименьшим значением ObjectID (в частности, OID или FID).
Если Входные растровые или векторные данные зон имеют перекрывающиеся полигоны, зональный анализ не будет выполняться для каждого индивидуального полигона. Поскольку векторные входные данные конвертируются в растр, каждое местоположение может иметь только одно значение.
Альтернативный метод заключается в обработке зональных данных итеративно для каждой из полигональных зон с последующим сопоставлением результатов.
Значение параметра Поле зоны (zone_field в Python) должно быть целочисленным или текстовым.
При указании значения параметра Входные растровые или векторные данные зон полем зоны по умолчанию будет первое доступное целочисленное или текстовое поле. Если других допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).
Диаграмма зональной гистограммы не создается по умолчанию. Для создания графика отметьте параметр Зоны как строки в выходной таблице (установите для параметра zones_as_rows значение ZONES_AS_ROWS в Python) и укажите Имя выходной диаграммы (параметр out_graph в Python). График зональной гистограммы может быть создан только в ArcGIS Pro и не поддерживается в автономном скрипте.
Если выходная таблица создается через отмену параметра Зоны как строки выходной таблице, поле надписи будет содержать значения набора растровых данных значений или надписей символов слоя, в зависимости от того, как определен входной растр значений.
Если выходная таблица создается через параметр Зоны как строки выходной таблицы, поле надписи будет содержать значения растра зон.
Если значения выходной частоты превышают емкость поля типа long (32-разрядное целое число), тип поля в выходной таблице будет автоматически изменен на big integer (64-разрядное целое число), при условии, что формат указанной выходной таблицы поддерживает его. Если выходной формат вывода не поддерживает тип данных big integer, значение выходной частоты будет возвращено как -9999. Тип данных поля big integer поддерживается таблицами файловой и многопользовательской базы геоданных.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Параметры
ZonalHistogram(in_zone_data, zone_field, in_value_raster, out_table, {out_graph}, {zones_as_rows})| Имя | Описание | Тип данных |
in_zone_data | Набор данных, определяющий зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем. | Raster Layer; Feature Layer |
zone_field | Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | Field |
in_value_raster | Растр, содержащий значения, которые будут использоваться для создания гистограммы. | Raster Layer |
out_table | Выходной файл таблицы. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных в рабочей области базы геоданных, и таблица dBASE, если рабочая область представляет собой папку с файлами. Дополнительная выходная диаграмма создается по информации в таблице. | Table |
out_graph (Дополнительный) | Имя выходной диаграммы для отображения. | Graph |
zones_as_rows (Дополнительный) | Определяет, каким образом значения входного растра значений будут представлены в выходной таблице.
| Boolean |
Пример кода
В этом примере создается таблица зональной гистограммы .dbf и файл диаграммы.
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalHist = ZonalHistogram("zoneras", "zonfield", "valueras", "znhist_tbl.dbf",
"znhist_graphl", "ZONES_AS_ROWS")В этом примере создается таблица зональной гистограммы .dbf.
# Name: ZonalHistogram_Ex_02.py
# Description: Creates a zonal histogram output table
# showing the amount of value cells
# for each unique input zone.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inZoneData = "zonras"
zoneField = "zonfield"
inValueRaster = "valueras"
outTable = "C:/sapyexamples/output/zonehist_tb2.dbf"
# Execute ZonalHistogram
ZonalHistogram(inZoneData, zoneField, inValueRaster, outTable)Параметры среды
Информация о лицензиях
- Basic: Обязательно Spatial Analyst
- Standard: Обязательно Spatial Analyst
- Advanced: Обязательно Spatial Analyst