Таблица пересечений (Инструменты Анализа)

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

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

Иллюстрация

! Иллюстрация инструмента Таблица пересечений

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

Зона включает в себя все объекты из параметра Входные объекты зон, для которых совпадают значения в параметре Поля зоны. Аналогично, класс включает в себя все объекты из параметра Объекты входного класса, для которых совпадают значения в параметре Поля класса. Объекты не обязательно должны граничить друг с другом, чтобы попасть в одну зону или класс. Этот инструмент рассчитывает, какая часть зоны пересекается каждым классом (включая площадь и процент площади зоны).
Если значение Поля класса не задано, все объекты из параметра Объекты входного класса будут считаться относящимися к одному классу. Значение Выходная таблица будет содержать одну запись для этой зоны.
Если значение Поля класса задано, то значение Выходная таблица будет содержать n записей для каждой зоны, где n – число классов внутри этой зоны. Например, если зона содержит четыре класса, значение Выходная таблица будет содержать четыре записи для этой зоны.
Числовые атрибуты из параметра Объекты входного класса могут суммироваться в пределах зоны с помощью параметра Поля суммирования. Суммарные значения для класса представляют пропорцию суммарных значений на основе процента класса, пересекающего зону.

Внимание:

Используйте в качестве Полей суммирования поля с абсолютными значениями (а не с относительными нормализованными значениями, как, например проценты или плотность), поскольку значения могут быть разделены и перераспределены по разным зонам.
Использование значений Объектов входного класса более высокой размерности, чем значения Входные объекты зоны не поддерживается.
- Если значения Входные объекты зон являются точками, значения Входные объекты классов не могут быть полигонами или линиями.
- Если значения **Входные объекты зон **являются линиями, значения Входные объекты классов не могут быть полигонами.
Если значения Входные объекты зон и Объекты входного класса являются полигонами, статистика выходной таблицы будет основана на вычислении площади.

Если значения Объекты входного класса являются линиями, выходная таблица статистики будет основана на линейных расчетах.

Если значения Объекты входного класса являются точками, выходная таблица статистики будет основана на числе объектов.
Если значения параметров Входные объекты зон и Объекты входного класса имеют одинаковое измерение (и те, и другие полигоны, линии или точки), в выходном поле PERCENTAGE записывается процент объекта зоны, пересекаемого классом.

Если значения Входные объекты зон и Объекты входного класса имеют разные измерения (полигональная зона с линейным классом или линейная зона с точечным классом), выходное поле PERCENTAGE будет содержать процент класса, пересекающего полигон зоны.

В поле PERCENTAGE можно записать процентное значение, превышающее 100, если есть перекрывающиеся объекты в параметрах Входные объекты зон или Объекты входного класса.
Выходная таблица содержит поле AREA, только если значения Входные объекты зон и Объекты входного класса являются полигонами. Поле AREA содержит площадь значений Входных объектов зон, которую пересекают значения Объекты входного класса.

Выходная таблица содержит поле LENGTH, если значения Объекты входного класса являются линиями. Поле LENGTH содержит длину пересечения между значениями Входные объекты зон и Объекты входного класса.

Выходная таблица содержит поле PNT_COUNT, если значения Объекты входного класса являются точками. Поле PNT_COUNT содержит количество точек Входных объектов класса, которые пересекают Входные объекты зоны.
При использовании векторных слоев, если какие-либо объекты выбраны, в расчетах используются только выбранные объекты.
Для определения пересечения объектов зон с объектами класса используются те же правила, что и при работе с инструментом Пересечение.
Используйте инструмент Сводная таблица для преобразования Выходной таблицы в таблицу, содержащую одну запись для каждой зоны с атрибутами класса в виде отдельных полей атрибутов. Заполните параметры инструмента Сводная таблица следующим образом:
- Входная таблица—Таблица пересечений Выходная таблица
- Входные поля—Таблица пересечений Поля зоны
- Поле столбцов—Таблица пересечений Поля класса
- Поле значений—Таблица пересечений Поля суммирования или AREA, LENGTH, PERCENTAGE
! Пример выходной сводной таблицы

Подпись	Объяснение	Тип данных
Входные объекты зон	Объекты, используемые для определения зон.	Feature Layer
Поля зон	Атрибутивное поле или поля, которые будут использованы для определения зон.	Field
Объекты входного класса	Объекты, используемые для идентификации классов.	Feature Layer
Выходная таблица	Таблица, содержащая кросс-таблицу пересечений между зонами и классами.	Table
Поля классов (Дополнительный)	Атрибутивное поле или поля, используемые для определения классов.	Field
Поля суммы (Дополнительный)	Поля, которые будут суммироваться из параметра Объекты входного класса.	Field
Допуск XY (Дополнительный)	Расстояние, определяющее диапазон, в котором объекты или их вершины считаются совпадающими. По умолчанию это расстояние равно значению допуска x,y Входных объектов зон. Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit
Выходные единицы (Дополнительный)	Задает единицы измерения, которые будут использоваться для расчета площади или длины. Настройка выходных единиц не поддерживается, если объекты входного класса являются точками. Unknown–Единицы измерения будут неизвестны. Километры–Единицами измерения – километры. Метры–Единицей измерения – метры. Дециметры–Единицами измерения будут дециметры. Сантиметры–Единицами измерения будут сантиметры. Миллиметры–Единицами измерения будут миллиметры. Сухопутные мили–Единицами измерения будут сухопутные мили. Международные морские мили–Единицами измерения будут международные морские мили. Международные ярды–Единицами измерения будут международные ярды. Международные футы–Единицами измерения будут международные футы. Международные дюймы–Единицами измерения будут международные дюймы. Геодезические мили США–Единицами измерения будут геодезические мили (США). Геодезические морские мили США–Единицами измерения будут геодезические морские мили США. Геодезические ярды США–Единицами измерения будут геодезические ярды США. Геодезические футы США–Единицами измерения будут геодезические футы США. Дюймы–Единицами измерения будут геодезические дюймы США. Десятичные градусы–Единицами измерения будут десятичные градусы. Точки–Единицами измерения будут точки. Ары–Единицами измерения будут ары. Квадратные километры–Единицами измерения – квадратные километры. Квадратные метры–Единицами измерения – квадратные метры. Квадратные дециметры–Единицами измерения будут квадратные дециметры. Квадратный сантиметры–Единицами измерения будут квадратные сантиметры. Квадратные миллиметры–Единицами измерения будут квадратные миллиметры. Квадратные сухопутные мили–Единицами измерения будут квадратные сухопутные мили. Квадратные международные морские мили–Единицами измерения площади будут квадратные международные морские мили. Международные квадратные ярды–Единицами измерения будут квадратные международные ярды. Квадратные международные футы–Единицами измерения будут квадратные международные футы. Квадратные международные дюймы–Единицами измерения будут квадратные международные дюймы. Квадратные геодезические мили США–Единицами измерения будут квадратные геодезические мили США. Квадратные геодезические морские мили США–Единицами измерения площади будут квадратные геодезические морские мили США. Квадратные геодезические ярды США–Единицами измерения будут квадратные геодезические ярды США. Квадратные геодезические футы США–Единицами измерения будут квадратные геодезические футы США. Квадратные геодезические дюймы США–Единицами измерения будут квадратные геодезические дюймы США. Геодезические акры США–Единицами измерения будут геодезические акры США. Гектары–Единицами измерения – гектары. Акры–Единицами измерения будут международные акры.	String

arcpy.analysis.TabulateIntersection(in_zone_features, zone_fields, in_class_features, out_table, {class_fields}, {sum_fields}, {xy_tolerance}, {out_units})

Имя	Объяснение	Тип данных
in_zone_features	Объекты, используемые для определения зон.	Feature Layer
zone_fields [zone_fields,...]	Атрибутивное поле или поля, которые будут использованы для определения зон.	Field
in_class_features	Объекты, используемые для идентификации классов.	Feature Layer
out_table	Таблица, содержащая кросс-таблицу пересечений между зонами и классами.	Table
class_fields [class_fields,...] (Дополнительный)	Атрибутивное поле или поля, используемые для определения классов.	Field
sum_fields [sum_fields,...] (Дополнительный)	Поля, которые будут суммироваться из параметра `in_class_features`.	Field
xy_tolerance (Дополнительный)	Расстояние, определяющее диапазон, в котором объекты или их вершины считаются совпадающими. По умолчанию это допуск x,y значения параметра `in_zone_features`. Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit
out_units (Дополнительный)	Задает единицы измерения, которые будут использоваться для расчета площади или длины. Настройка выходных единиц не поддерживается, если объекты входного класса являются точками. `UNKNOWN`–Единицы измерения будут неизвестны. `KILOMETERS`–Единицами измерения – километры. `METERS`–Единицей измерения – метры. `DECIMETERS`–Единицами измерения будут дециметры. `CENTIMETERS`–Единицами измерения будут сантиметры. `MILLIMETERS`–Единицами измерения будут миллиметры. `MILES_INTERNATIONAL`–Единицами измерения будут сухопутные мили. `NAUTICAL_MILES_INTERNATIONAL`–Единицами измерения будут международные морские мили. `YARDS_INTERNATIONAL`–Единицами измерения будут международные ярды. `FEET_INTERNATIONAL`–Единицами измерения будут международные футы. `INCHES_INTERNATIONAL`–Единицами измерения будут международные дюймы. `MILES`–Единицами измерения будут геодезические мили (США). `NAUTICAL_MILES`–Единицами измерения будут геодезические морские мили США. `YARDS`–Единицами измерения будут геодезические ярды США. `FEET`–Единицами измерения будут геодезические футы США. `INCHES`–Единицами измерения будут геодезические дюймы США. `DECIMAL_DEGREES`–Единицами измерения будут десятичные градусы. `POINTS`–Единицами измерения будут точки. `ARES`–Единицами измерения будут ары. `SQUARE_KILOMETERS`–Единицами измерения – квадратные километры. `SQUARE_METERS`–Единицами измерения – квадратные метры. `SQUARE_DECIMETERS`–Единицами измерения будут квадратные дециметры. `SQUARE_CENTIMETERS`–Единицами измерения будут квадратные сантиметры. `SQUARE_MILLIMETERS`–Единицами измерения будут квадратные миллиметры. `SQUARE_MILES`–Единицами измерения будут квадратные сухопутные мили. `SQUARE_NAUTICAL_MILES`–Единицами измерения площади будут квадратные международные морские мили. `SQUARE_YARDS`–Единицами измерения будут квадратные международные ярды. `SQUARE_FEET`–Единицами измерения будут квадратные международные футы. `SQUARE_INCHES`–Единицами измерения будут квадратные международные дюймы. `SQUARE_MILES_US`–Единицами измерения будут квадратные геодезические мили США. `SQUARE_NAUTICAL_MILES_US`–Единицами измерения площади будут квадратные геодезические морские мили США. `SQUARE_YARDS_US`–Единицами измерения будут квадратные геодезические ярды США. `SQUARE_FEET_US`–Единицами измерения будут квадратные геодезические футы США. `SQUARE_INCHES_US`–Единицами измерения будут квадратные геодезические дюймы США. `ACRES_US`–Единицами измерения будут геодезические акры США. `HECTARES`–Единицами измерения – гектары. `ACRES`–Единицами измерения будут международные акры.	String

Пример кода

Пример 1 TabulateIntersection (окно Python)

Используйте функцию TabulateIntersection в окне Python для определения площади, занимаемой каждым типом растительности в каждой зоне.

import arcpy
arcpy.analysis.TabulateIntersection("Zones", "zone_id", "Vegetation",
                                    r"C:\Esri\veganalysis.gdb\vegtypeAreas",
                                    "VEGTYPE")

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

Этот скрипт запускает функцию TabulateIntersection, позволяющую создать простой инструмент-скрипт TabulateArea. Инструмент-скрипт TabulateArea принимает в качестве входных данных только полигональные объекты.

В полях Зона и Класс можно ввести только по одному значению.

'''
TabulateArea.py
Description: Shows how to wrap the TabulateIntersection tool to create a TabulateArea script tool
Requirements: Polygon Zone Feature Class, Polygon Class Feature Class

'''
import arcpy
import sys
import os

def AddMsgAndPrint(msg, severity=0):
    # Adds a Message (in case this is run as a tool)
    # and also prints the message to the screen (standard output)
    print(msg)

    # Split the message on \n first, so that if it's multiple lines,
    # a GPMessage will be added for each line
    try:
        for string in msg.split('\n'):
            # Add appropriate geoprocessing message
            if severity == 0:
                arcpy.AddMessage(string)
            elif severity == 1:
                arcpy.AddWarning(string)
            elif severity == 2:
                arcpy.AddError(string)
    except:
        pass

## Get Parameters
zoneFC = arcpy.GetParameterAsText(0)
zoneFld = arcpy.GetParameterAsText(1) # Only allow one field
classFC = arcpy.GetParameterAsText(2)
outTab = arcpy.GetParameterAsText(3)
classFld = arcpy.GetParameterAsText(4) # Optional and only allow one field
sum_Fields = ""
xy_tol = ""
outUnits = arcpy.GetParameterAsText(5)

## Validate parameters
# Inputs can only be polygons
zoneDesc = arcpy.Describe(zoneFC)
classDesc = arcpy.Describe(classFC)
if zoneDesc.shapeType != "Polygon" or classDesc.shapeType != "Polygon":
    AddMsgAndPrint("Inputs must be of type polygon.", 2)
    sys.exit()

# Only one zone field and class field
if zoneFld != "":
    if zoneFld.find(";") > -1 or classFld.find(";") > -1:
        AddMsgAndPrint("A maximum of one zone and/or class field is allowed.", 2)
        sys.exit()

# Run TabulateIntersection
try:
    arcpy.analysis.TabulateIntersection(zoneFC, zoneFld, classFC, outTab,
                                        classFld, sum_Fields, xy_tol, outUnits)
except:
    arcpy.AddMessage("Tabulate Intersection Failed.")

AddMsgAndPrint(arcpy.GetMessages(), 0)

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

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

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

Basic: Нет
Standard: Нет
Advanced: Да