Зональная гистограмма (Инструменты 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 для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Подпись	Объяснение	Тип данных
Входные растровые или векторные данные зон	Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем.	Raster Layer; Feature Layer
Поле зоны	Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	Field
Входной растр значений	Растр, содержащий значения, которые будут использоваться для создания гистограммы.	Raster Layer
Выходная таблица	Выходной файл таблицы. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию на выходе будет таблица базы геоданных, если она находится в рабочей области базы геоданных, и таблица dBASE, если она находится в файловой рабочей области. Дополнительная выходная диаграмма создается по информации в таблице.	Table
Имя выходной диаграммы (Дополнительный)	Имя выходной диаграммы для отображения. График будет содержаться на панели Содержание в разделе Автономные таблицы.	String
Зоны как строки в выходной таблице (Дополнительный)	Определяет, каким образом значения входного растра значений будут представлены в выходной таблице. Отмечено–Зоны будут представлены как строки. Не отмечено–Зоны будут представлены как поля. Используется по умолчанию.	Boolean

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 (Дополнительный)	Имя выходной диаграммы для отображения.	String
zones_as_rows (Дополнительный)	Определяет, каким образом значения входного растра значений будут представлены в выходной таблице. `ZONES_AS_ROWS`–Зоны будут представлены как строки. `ZONES_AS_FIELDS`–Зоны будут представлены как поля. Используется по умолчанию.	Boolean

Пример кода

ZonalHistogram пример 1 (окно Python)

В этом примере создается таблица зональной гистограммы .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")

ZonalHistogram пример 2 (автономный скрипт)

В этом примере создается таблица зональной гистограммы .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 *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inZoneData = "zonras"
zoneField = "zonfield"
inValueRaster = "valueras"
outTable = "C:/sapyexamples/output/zonehist_tb2.dbf"

# Run ZonalHistogram
ZonalHistogram(inZoneData, zoneField, inValueRaster, outTable)

Параметры среды

Автоподтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово конфигурации, Выходная система координат, Поддержка полноценных имен полей, Временная рабочая область, Растр привязки, Размер листа, Перенос описаний доменов полей

Информация о лицензировании