Таблица площадей (Инструменты Spatial Analyst)

Краткая информация

Вычисляет перекрестную таблицу площадей между двумя наборами данных и выдает таблицу.

Иллюстрация

Использование

Зона определяется как все области входных данных, имеющие одно значение. Области не обязательно должны быть непрерывными. Для входных данных зон могут использоваться и растры и объекты.
Если одним из входных данных является растр, он должен быть целочисленным.
Если одним из входных наборов данных является класс пространственных объектов, он внутренне конвертируется в растр перед выполнением анализа, используя Размер ячейки и выравнивание ячейки другого входного растра.
Если входными данными являются два растра и их ячейки не выровнены, то в процессе анализа будет произведен пересчет исходных данных. Если параметр среды Растр замыкания явно не указан, ячейки выравниваются внутри с использованием входного растра или данных класса объектов (in_class_data в Python). Если оба растра имеют одинаковый размер ячейки и ячейки выровнены, пересчет проводиться не будет.
Если оба входных набора данных относятся к классу пространственных объектов, они внутренне конвертируются в растр перед их анализом с использованием параметра Размер ячейки анализа (processing_cell_size в Python) или из параметра среды анализ растров, если указан.
Если Входные растровые или векторные данные зон (in_zone_data в Python) являются объектом, для любых зональных объектов, которые не пересекаются с любыми центрами ячеек растра класса, эти зоны не будут конвертироваться во внутренний растр зон. В результате, эти зоны не будут представлены в выходных данных. Вы можете управлять этим поведением, задав соответствующее значение для параметра среды Размер ячеек, что позволит сохранить желательный уровень детализации зон объектов, и задать его в параметрах среды анализа.
Если входные данные содержат перекрывающиеся объекты, зональный анализ будет выполнен для каждого отдельного объекта.
Если в качестве входного класса пространственных объектов используются точечные или линейные данные, в итоговую таблицу будут включены площади областей, пересекаемых этими объектами.
При указании входной зоны или данных классов полем по умолчанию будет первое доступное и допустимое поле. Если других допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).
Параметр Размер ячейки анализа может быть задан числовым значениям или получен из имеющегося набора растровых данных. Если размер ячейки не был явно указан в качестве значения параметра, он извлекается из среды Размер ячейки, если он был указан. Если параметр размера ячейки и параметр среды не заданы, размер выходной ячейки по умолчанию определяется на основе типа входного набора данных следующим образом:
- Если входной набор данных является растром, используется размер ячейки набора данных.
- Если входной набор данных является пространственным объектом и была установлена среда Растр привязки, используется размер ячейки растра привязки. Если растр привязки не задан, размер ячейки рассчитывается как меньшее из значений ширины или высоты экстента, деленных на 250, в которых экстент находится в выходной системе координат, указанной в параметрах среды.
Если размер ячейки задан с использованием числового значения, инструмент будет использовать его непосредственно для выходного растра.

Если размер ячейки задан с использованием набора растровых данных, параметр покажет путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого набора растровых данных будет использоваться непосредственно в анализе при условии, что пространственная привязка набора данных совпадает с выходной пространственной привязкой. Если пространственная привязка набора данных отличается от выходной пространственной привязки, она будет спроецирована на основе значения Метод проецирования размера ячейки.
Параметр Классы как строки в выходной таблице (classes_as_rows в Python) позволяет выбрать тип схемы выходной таблицы. Отметьте этот параметр (CLASSES_AS_ROWS в Python) для представления строк классов или снимите его отметку (CLASSES_AS_FIELDS в Python) для представления классов в виде полей.

Когда классы представлены в строках, данные выходной таблицы можно связать и запросить для извлечения информации о площади по растрам зон или классов.
Выходными данными этого инструмента является таблица.

В этой таблице, когда параметр Классы как строки в выходной таблице не отмечен (CLASSES_AS_FIELDS в Python), верно следующее:
- Содержится запись о каждом уникальном значении в наборе данных зоны.
- Содержится поле для каждого уникального значения в наборе данных классов.
- Каждая запись будет хранить площадь каждого класса в пределах каждой зоны.
Когда параметр Классы как строки в выходной таблице отмечен (CLASSES_AS_ROWS в Python), верно следующее:
- Для каждого уникального значения набора данных зоны будет создана запись, которая имеет уникальное значение набора данных класса.
- Там будут отдельные поля, которые идентифицируют поле зоны, поле класса, количество и площадь каждого класса в пределах каждой зоны.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

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

TabulateArea(in_zone_data, zone_field, in_class_data, class_field, out_table, {processing_cell_size}, {classes_as_rows})

Имя	Объяснение	Тип данных
in_zone_data	Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем.	Raster Layer; Feature Layer
zone_field	Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	Field
in_class_data	Набор данных, определяющий классы, для которых вычисляется суммарная площадь внутри каждой зоны. Входные данные классов могут быть представлены слоем целочисленного растра или векторным слоем.	Raster Layer; Feature Layer
class_field	Поле, содержащее значения классов. Поле может быть представлено целочисленным или строковым полем входных данных классов.	Field
out_table	Выходная таблица, которая будет содержать итоговые суммарные значения площадей каждого класса в пределах каждой зоны. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию на выходе будет таблица базы геоданных, если она находится в рабочей области базы геоданных, и таблица dBASE, если она находится в файловой рабочей области.	Table
processing_cell_size (Дополнительный)	Размер ячейки, который будет использован при создании выходного растра. Этот параметр может быть задан числовым значениям или получен из имеющегося набора растровых данных. Если размер ячейки не был явно указан в качестве значения параметра, используется параметр среды Размер ячейки, если он задан, иначе будут применены дополнительные правила для его вычисления по другим входным данным. Более подробную информацию см. в разделе об использовании.	Analysis Cell Size
classes_as_rows (Дополнительный)	Определяет, каким образом значения входного растра класса будут представлены в выходной таблице. `CLASSES_AS_ROWS`–Классы будут представлены как строки. `CLASSES_AS_FIELDS`–Классы будут представлены как поля. Используется по умолчанию.	Boolean

Пример кода

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

В этом примере выдаётся таблица с площадью каждого значения класса, которые содержатся в каждой зоне.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
TabulateArea("zonedata.shp", "IDStr", "valueraster", "VALUE",
             "C:/sapyexamples/output/areatable.dbf", 2)

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

В этом примере выдаётся таблица с площадью каждого значения класса, которые содержатся в каждой зоне.

# Name: TabulateArea_Ex_02.py
# Description: Calculates cross tabulated areas between two datasets.
# 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"
env.extent = "classgrid"
env.snapRaster = "classgrid"

# Set local variables
inZoneData = "zonedata.shp"
zoneField = "IDStr"
inClassData = "valueraster"
classField = "VALUE"
outTable = "C:/sapyexamples/output/areatable02.dbf"
processingCellSize = 2

# Run TabulateArea
TabulateArea(inZoneData, zoneField, inClassData, classField, outTable,
             processingCellSize)

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst