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

Сводка

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

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

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

Иллюстрация

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

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

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

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

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

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

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

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

  • Выходной тип может быть таким же, как у входных объектов с самой простой геометрией, или проще. Например, если все входные данные – полигоны, выходные могут быть полигонами, линиями или точками. Если один из входных наборов данных – линейного типа, и нет ни одного точечного типа, выходные могут быть линейными или точечными. Если какие-либо из входных данных представлены точками, выходной тип может быть только точечным.

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

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

Синтаксис

PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
ParameterОбъяснениеТип данных
in_features
[in_feature,...]

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

Value Table
out_feature_class

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

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

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

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

Минимальное расстояние, в пределах которого координаты узлов и вершин объектов считаются различимыми, и на которое могут быть смещены координаты по оси 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: Да

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