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

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

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

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

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

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

Иллюстрация

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

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

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

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

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

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

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

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

    Когда отмечен параметр Точность, для точечного выхода будет использована максимально возможная точность. Инструмент использует максимальную доступную точность, которая зависит от абсолютных значений координат геометрии и точности аппаратных вычислений с плавающей точкой. Примерная оценка максимального используемого допуска - 0.002 миллиметра по сравнению с 1 миллиметром по умолчанию.

    При записи выходных данных разрешение пространственной привязки будет применено, поэтому точки могут немного сместиться.

    Если входные данные содержат нелинейные сегменты (кривые), для наилучших результатов включите параметр среды Поддерживать сегменты кривых и установите параметр среды Метод обработки кривой на ТОЧНЫЙ.

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

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

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

  • Если входные объекты имеют 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
Использовать максимальную точность
(Дополнительный)

Указывает уровень точности, который будет использован, если значением параметра Выходной тип является Точка. Этот параметр не поддерживается, если значением параметра Выходной тип является Как у входных данных или Линия. Отмечайте этот параметр, если хотите, чтобы инструмент применил уровень точности, больший чем у входной пространственной привязки по умолчанию, при задании точечных выходных данных.

  • Отмечен - при задании точечных выходных данных будет использована максимальная точность.
  • Не отмечен - точность первого входного класса объектов будет использована при задании точечных выходных данных. Это значение по умолчанию
Boolean

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type}, {precision})
ИмяОписаниеТип данных
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
precision
(Дополнительный)

Указывает уровень точности, который будет использован, если значением параметра output_type является POINT. Этот параметр не поддерживается, если значением параметра output_type является INPUT или LINE. Используйте опцию MAX_PRECISION, если хотите, чтобы инструмент применил уровень точности, больший чем у входной пространственной привязки по умолчанию, при определении точечных выходных данных.

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

Пример кода

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 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: Да

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