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

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

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

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

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

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

Иллюстрация

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

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

  • Можно добавить только 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.analysis.PairwiseIntersect(["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.analysis.PairwiseIntersect(inFeatures, intersectOutput)

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

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

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