Пространственное соединение (Инструменты Анализа)

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

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

Узнайте больше об отношениях Пространственного соединения по типу объекта

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

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

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

• В выходной класс объектов будут добавлены следующие поля:

  • Join_Count—Количество присоединяемых объектов, соответствующих каждому целевому объекту.

    Если значение параметра Присоединить объекты представляет собой один входной параметр, выходной параметр будет иметь поле Join_Count по умолчанию. Если имеется более одного входного параметра, имя поля Количество соединений будет включать имя входного параметра по умолчанию, например Input1_JoinCount, Input2_JoinCount и т. д. Укажите имя этого поля, заполнив столбец Имя поля Количество соединений.

  • TARGET_FID—Оbject ID целевого объекта,

  Дополнительное поле, JOIN_FID, будет добавлено к выходным данным, если параметр Операция объединения установлен на Соединение один-ко-многим. Это поле представляет собой идентификатор object ID соединяемого объекта.

• Если для параметра Операция соединения указано значение Соединение один-ко-многим, в выходном классе пространственных объектов может быть несколько строк для каждого целевого объекта. Воспользуйтесь полем JOIN_FID для определения того, к какому целевому объекту (TARGET_FID) присоединяется тот или иной объект. Значение -1 в поле JOIN_FID означает, что ни один объект не соответствует заданному пространственному отношению с целевым объектом.

• Все целевые объекты исходного класса будут сохранены в выходном классе объектов, если выполняются два следующих условия:

  • Параметр Операция соединения установлен как Соединение один-к-одному.

  • Параметр Сохранить все целевые объекты отмечен.

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

• Используйте параметр Список полей для управления полями и их содержанием во входных наборах данных.

  • Добавляйте и удаляйте поля из списка полей, изменяйте порядок и переименовывайте поля.

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

  • Используйте действие, чтобы определить, как значения из одного или нескольких входных полей будут объединены в одно выходное поле. Доступны следующие действия: Первое, Последнее, Соединить, Сумма, Среднее, Медиана, Режим, Минимум, Максимум, Стандартное отклонение и Число.

  • При использовании действия Соединить, вы можете задать разделитель, например, точку или другой символ. Щелкните начало текстового поля Разделитель, чтобы добавить символы-разделители.

  • Стандартное отклонение не является допустимым параметром для одиночных входных значений.

  • Используйте опцию Экспорт для сохранения списка полей как файла .fieldmap.

  • Используйте опцию Загрузить , чтобы загрузить файл .fieldmap. Векторный слой или набор данных, указанный в файле, должен соответствовать набору данных, используемому в инструменте. Иначе параметр Список полей будет сброшен.

  • Используйте кнопку Фрагмент текста в исходных текстовых полях, чтобы выбрать, какие символы из входного значения будут извлечены в выходное поле. Чтобы получить доступ к кнопке Фрагмент текста, наведите курсор на текстовое поле в списке входных полей, затем укажите начальную и конечную позиции символов.

  • Поля также можно сопоставить в скрипте Python.

• Действия, определяемые с помощью параметра Список полей, применяются только к атрибутам присоединяемых объектов, если более одного объекта соответствует целевому объекту (если Join_Count > 1). Например, если к одному целевому объекту присоединяются три объекта со значениями атрибута DEPTH 15.5, 2.5 и 3.3, и используется действие Среднее, в выходное атрибутивное поле будет записано значение 6.1. При статистическом расчете нулевые значения в соединяемых полях игнорируются. Например, для значений 15.5, значения null и 2.5 результатом будет 9.0 для Среднего и 2 для Количества.

• Если параметр Опции сопоставления настроен как Ближайший или Геодезически ближайший, то как минимум два присоединяемых объекта находятся на одинаковом расстоянии от целевого объекта. В этом случае присоединен будет только один объект, выбираемый случайным образом (Object ID присоединяемого объекта на выбор не влияет). Чтобы найти 2-й, 3-й или n-й ближайший объект, используйте инструмент Построить таблицу соседних объектов.

  Узнайте больше о том, как рассчитывается близость

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

• Параметр Сопоставление атрибутов отфильтровывает объекты, которым будут соответствовать пространственные отношения, указанные в параметре Опция сопоставления. Укажите поля из присоединяемых и целевых объектов, у которых, в дополнение к их пространственному отношению, должны быть сопоставленные атрибуты.

• Более подробно об использовании пространственных отношений Пересечение 3D и В пределах расстояния 3D см. в разделе Выбор трехмерных отношений по расположению.

Параметры

• Dialog
• Python

Подпись	Объяснение	Тип данных
Целевые объекты	Атрибуты целевых объектов, к которым присоединяются атрибуты присоединяемых объектов и которые будут перенесены в выходной класс объектов. Однако часть атрибутов может быть задана параметром Список полей.	Feature Layer
Присоединить объекты	Атрибуты присоединяемых объектов будут присоединены к объектам целевого класса. Дополнительную информацию о том, как тип операции соединения влияет на объединение соединенных атрибутов, см. в справке по параметру Операция соединения. Используйте столбец Имя поля Количество соединений, чтобы указать пользовательское наименование для поля количества соединений. При наличии более одного входного значения, по умолчанию будет использоваться имя поля класса объектов. Столбцы таблицы значений: Join Features–The features whose attributes will be joined to the target features. Join Count Field Name–The name of the join count field.	Value Table
Выходной класс пространственных объектов	Новый класс пространственных объектов, содержащий атрибуты целевых и присоединяемых объектов. По умолчанию все атрибуты целевых и присоединяемых объектов будут записаны в целевой класс объектов. Однако набор переносимых атрибутов может быть задан параметром Список полей.	Feature Class
Операция соединения (Дополнительный)	Операция, которая соединит целевые и присоединяемые объекты в выходном классе объектов, если найдено несколько присоединяемых объектов с тем же пространственным отношением с одним целевым объектом. Присоединить Один-к-одному–Если найдено несколько присоединяемых объектов, которые имеют одинаковое пространственное расположение по отношению к одному целевому объекту, будут агрегированы атрибуты из нескольких соединяемых объектов с использованием правила слияния в соответствии со Списком полей. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, атрибуты этих двух полигонов будут агрегированы до переноса в выходной класс объектов. Если один полигон имеет атрибутивное значение 3, а другой – значение 7, и задано правило слияния Суммарное значение, значение в выходном классе объектов будет равно 10. Используется по умолчанию. Присоединить один-ко-многим–Если найдено несколько присоединяемых объектов, которые имеют одинаковое пространственное расположение по отношению к одному целевому объекту, выходной класс объектов будет содержать несколько копий строки атрибутивной таблицы соответствующего целевого объекта. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, выходной класс объектов будет содержать две строки атрибутивной таблицы целевого объекта: одна – с атрибутами одного полигона, другая – с атрибутами другого.	String
Сохранить все целевые объекты (Дополнительный)	Указывает, будут ли сохранены все целевые объекты в выходном классе объектов (внешнее соединение) или только имеющие заданное пространственное отношение с присоединяемыми объектами (внутреннее соединение). Отмечено–Все целевые объекты будут записаны в выходные данные (внешнее соединение). Используется по умолчанию. Не отмечено–Только те целевые объекты, которые имеют заданное пространственное отношение с соединяемыми объектами, будут поддерживаться в выходном классе объектов (внутреннее соединение). Например, если для целевых объектов указан класс точечных объектов, а для соединяемых объектов указан класс полигональных объектов, когда параметру match_option присвоено значение WITHIN, выходной класс объектов будет содержать только те целевые объекты, которые находятся внутри соединяемого полигонального объекта. Все целевые объекты, которые не попадают в пределы присоединяемых объектов, будут исключены из выходных данных.	Boolean
Сопоставление полей (Дополнительный)	Поля, которые будут включены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из присоединяемых и целевых объектов. Используйте список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей. Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное.	Field Mappings
Опции сопоставления (Дополнительный)	Задает критерии, которые будут использоваться для сопоставления строк. Пересечение–Присоединяемые объекты учитываются, если они пересекают целевые объекты. Используется по умолчанию. Укажите расстояние в параметре Радиус поиска. Пересечение 3D–Присоединяемые объекты учитываются, если они пересекают целевые объекты в трехмерном пространстве (x, y и z). Укажите расстояние в параметре Радиус поиска. В пределах расстояния–Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Укажите расстояние в параметре Радиус поиска. В пределах геодезического расстояния–Такое же, как и В пределах расстояния, только используется геодезическое расстояние, а не плоскостное. Расстояние между объектами будет вычислено геодезически по формуле, которая учитывает кривизну поверхности Земли и корректно выполняет обработку данных, расположенных вокруг линий перемены дат и в приполярных областях. Используйте эту опцию, если ваши данные покрывают большую территорию, или если система координат входных объектов не подходит для вычисления расстояний. В пределах расстояния 3D–Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта в трехмерном пространстве. Укажите расстояние в параметре Радиус поиска. Содержит–Целевые объекты должны содержать в своих границах присоединяемые объекты. Целевыми объектами должны быть полигоны или полилинии. Для этой опции целевые объекты не могут быть точками, а присоединяемые объекты могут быть только полигонами, если целевые объекты также являются полигонами. Полностью содержит–Присоединяемые объекты учитываются, если они целиком содержатся в целевом объекте. Полигон может полностью содержать любой объект. Точка не может полностью содержать какой-либо объект, даже точку. Полилиния может полностью содержать только полилинию и точку. Содержит по Клементини–Это пространственное отношение дает те же результаты, что и Полностью содержит, за исключением ситуаций, когда присоединяемый объект находится целиком на границе целевого объекта (ни одна часть не находится внутри или вне его); в этом случае объект учитываться не будет. Клементини определяет границу полигона, как линию, разделяющую внешнюю и внутреннюю области полигона, границу линии – как её конечную точку, а граница точки всегда является пустой. Внутри–Целевые объекты должны содержать в своих границах присоединяемые объекты. Это противоположность отношения Содержит. Для этой опции целевые объекты могут быть только полигонами, а присоединяемые объекты – также полигонами. Точка может быть присоединяемым объектом, только если целевым объектом является точка. Полностью в пределах–Присоединяемые объекты учитываются, если целевой объект целиком в них содержится. Это противоположность отношения Полностью содержит. Внутри по Клементини–Результат будет тем же, что и с опцией Внутри, за исключением ситуаций, когда присоединяемый объект находится целиком на границе целевого объекта; в этом случае объект учитываться не будет. Клементини определяет границу полигона, как линию, разделяющую внешнюю и внутреннюю области полигона, границу линии – как её конечную точку, а граница точки всегда является пустой. Идентичны–Присоединяемые объекты учитываются, если они идентичны целевому объекту. Присоединяемый и целевой объекты должны иметь один и тот же тип геометрии – точка к точке, линия к линии или полигон к полигону. Касаются границы–Присоединяемые объекты учитываются, если их границы касаются целевого объекта. Если целевые и присоединяемые объекты являются линиями или полигонами, граница присоединяемого объекта может только касаться границы целевого объекта, и ни одна часть присоединяемого объекта не может пересекать границу целевого объекта. Имеют общий линейный сегмент с–Присоединяемые объекты учитываются, если они имеют общий линейный сегмент с целевым объектом. Присоединяемые и целевые объекты должны быть линейными или полигональными. Пересекается границей–Присоединяемые объекты учитываются, если целевой объект пересекается их контуром. Присоединяемые и целевые объекты должны быть линейными или полигональными. Если присоединяемыми и целевыми объектами являются полигоны, используется граница полигона (линия). Будут учитываться линии, пересекающиеся в точке, но не линии с общим линейным сегментом. Имеют центр внутри–Присоединяемые объекты учитываются, если они содержат в своих границах центр целевого объекта. Центр объекта вычисляется следующим образом: для полигонального и мультиточечного объекта используется его геометрический центроид, а для линии используется ее геометрическая середина. Укажите расстояние в параметре Радиус поиска. Ближайший–К целевому объекту присоединяется наиболее близко расположенный у нему присоединяемый объект. Более подробно см. советы по использованию. Укажите расстояние в параметре Радиус поиска. Геодезически ближайший–Такое же, как и Ближайший, только используется геодезическое расстояние, а не плоскостное. Используйте эту опцию, если ваши данные покрывают большую территорию, или если система координат входных объектов не подходит для вычисления расстояний. Наибольшее наложение–Присоединяемые объекты будут сопоставляться будут сопоставляться с целевым объектом с максимальным перекрытием.	String
Радиус поиска (Дополнительный)	Расстояние от целевого объекта, в пределах которого присоединяемые объекты будут учитываться для пространственного соединения. Радиус поиска является корректным, только если задано пространственное отношение (для параметра Опция сопоставления выбрано Пересекает, В пределах расстояния, В пределах геодезического расстояния, Имеет центр в, Ближайший или Ближайший геодезически). Например, при радиусе поиска в 100 метров с пространственным отношением В пределах расстояния будут присоединяться объекты, расположенные в пределах 100 метров от целевого объекта. Для трех отношений в пределах расстояния, если значение Радиуса поиска не задано, используется расстояние 0.	Linear Unit
Имя поля расстояния (Дополнительный)	Имя поля, содержащего расстояние между целевым объектом и ближайшим к нему присоединяемым объектом. Это поле будет добавлено в выходной класс объектов. Этот параметр допустим только в том случае, если задано пространственное отношение, а параметру Опция сопоставления установлено значение Ближайший или Ближайший геодезически. Значения в этом поле равно -1, если в пределах радиуса поиска не найдено подходящего объекта. Если имя поля не указано, поле не будет добавлено в выходной класс объектов.	String
Сопоставление полей (Дополнительный)	Пары полей из присоединяемых объектов и целевых объектов, которые будут использоваться для сопоставления атрибутов. В пространственном соединении будут участвовать только те записи из присоединяемых объектов, у которых будут общие с целевыми объектами значения сопоставляемых полей. Столбцы таблицы значений: Join Fields–Fields from the join features that will be used for attribute matching. Target Fields–Fields from the target features that will be used for attribute matching.	Value Table

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

Выходное Z-значение по умолчанию, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Экстент, Наличие выходных значений M, Выходные данные содержат Z значения, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z

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

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

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

• Обзор группы инструментов Наложение
• Поиск инструмента геообработки
• Отношения пространственных соединений по типу объекта
• Сопоставление атрибутивных полей
• Сопоставление входных полей с выходными полями