Попарное пересечение (Анализ)

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

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

Для выполнения операций пересечения доступны и другие инструменты. Изучить подробности можно в документации к инструменту Пересечение.

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

Более подробно о том, как работает инструмент Попарное пресечение

Иллюстрация

Иллюстрация к инструменту Попарное пересечение

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

  • Можно добавить только 2 входных класса объектов.

  • Входными объектами должны быть простые пространственные объекты: точки, мультиточки, линии или полигоны. Входные объекты не могут быть сложными, такими как объекты-аннотации, объекты-размеры или сетевые объекты.

  • В отличие от инструмента Пересечение ранги не поддерживаются.

  • По умолчанию объекты кривых из входных данных будут уплотнены в выходных данных. Для поддержки кривых в выходных данных используйте параметр среды Поддержка сегментов кривой.

  • Инструмент использует только те входные объекты, которые имеют пространственный индекс. Используйте инструмент Добавить пространственный индекс, чтобы его построить (особенно это касается шейп-файлов) или перестроить уже существующий, чтобы он был абсолютно точен.

  • Если входные объекты имеют m или z значения, в выходных объектах останутся m и z значения первого класса объектов. Если входные данные не содержат m- или z значения, в выходных данных они также будут отсутствовать.

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

  • Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входные классы объектов или слои для пересечения. Может быть только 2 входных набора данных.

Value Table
Выходной класс объектов

Выходной класс объектов.

Feature Class
Соединяемые атрибуты
(Дополнительный)

Определяет, какие атрибуты входных объектов будут перенесены в выходной класс объектов.

  • Все атрибуты — Все атрибуты из входных объектов будут перенесены в выходной класс объектов. Это значение по умолчанию
  • Все атрибуты, кроме ID объектов — Все атрибуты, кроме FID, из входных объектов будут перенесены в выходной класс объектов.
  • Только ID объектов — В выходной класс объектов будет скопировано только поле FID из входных объектов.
String
Допуск XY
(Дополнительный)

Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y).

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
Тип выходных данных
(Дополнительный)

Задает тип возвращаемых пересечений.

  • Как у входных данных — Результирующие объекты пересечения будут иметь тот же тип геометрии, что и входные объекты с геометрией самого низкого порядка. Если все входные объекты – полигоны, результирующий класс объектов также будет полигональным. Если один или несколько входных классов объектов – линейные, и среди входных классов нет точечных объектов, результирующий класс будет линейным. Если один из входных классов объектов представлен точечными объектами, результирующий класс также будет содержать точки. Это значение по умолчанию.
  • Линии — Будет возвращена линия пересечения. Эта опция используется, если среди входных классов нет точечных объектов.
  • Точки — Будет возвращена точка пересечения. Если входные данные – линии или полигоны, выходными данными будет класс мультиточечных объектов.
String

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
ИмяОписаниеТип данных
in_features
[in_features,...]

Входные классы объектов или слои для пересечения. Может быть только 2 входных набора данных.

Value Table
out_feature_class

Выходной класс объектов.

Feature Class
join_attributes
(Дополнительный)

Определяет, какие атрибуты входных объектов будут перенесены в выходной класс объектов.

  • ALLВсе атрибуты из входных объектов будут перенесены в выходной класс объектов. Это значение по умолчанию
  • NO_FIDВсе атрибуты, кроме FID, из входных объектов будут перенесены в выходной класс объектов.
  • ONLY_FIDВ выходной класс объектов будет скопировано только поле FID из входных объектов.
String
cluster_tolerance
(Дополнительный)

Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y).

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
output_type
(Дополнительный)

Задает тип возвращаемых пересечений.

  • INPUTРезультирующие объекты пересечения будут иметь тот же тип геометрии, что и входные объекты с геометрией самого низкого порядка. Если все входные объекты – полигоны, результирующий класс объектов также будет полигональным. Если один или несколько входных классов объектов – линейные, и среди входных классов нет точечных объектов, результирующий класс будет линейным. Если один из входных классов объектов представлен точечными объектами, результирующий класс также будет содержать точки. Это значение по умолчанию.
  • LINEБудет возвращена линия пересечения. Эта опция используется, если среди входных классов нет точечных объектов.
  • POINTБудет возвращена точка пересечения. Если входные данные – линии или полигоны, выходными данными будет класс мультиточечных объектов.
String

Пример кода

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

Окно Python скрипта с примером использования функции PairwiseIntersect в режиме прямого запуска:

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.PairwiseIntersect_analysis(["vegetation_stands", "road_buffer200m", "water_buffer100"], 
                                 "mysites", "ALL")
PairwiseIntersect, пример 2 (автономный скрипт)

Найти типы растительности, через которые протекают ручьи.

# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.
# Import system modules
import arcpy
# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "c:/data/data.gdb"    
# Process: Find all streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"
arcpy.PairwiseIntersect_analysis(inFeatures, intersectOutput)

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы