Выровнять объекты (Редактирование)

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

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

Иллюстрация

Иллюстрация инструмента Выровнять объекты

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

    Внимание:

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

    Примечание:

    Все входные данные должны быть в одной системе координат.

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

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

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

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

  • Поле AF_CONF добавляется к измененному входному объекту. В этом поле хранится значение, от 0 до 100, определяющее уровень достоверности для выравнивания по каждому объекту. Значение 100 показывает отсутствие разночтений для кандидата на выравнивание. Значение тем ниже, чем больше кандидатов на выравнивание находится, больше различий в геометрии или больше несовпадений атрибутов при отмеченном параметре Сопоставление полей. Если входной объект не изменен – в поле будет значение -1. Так как входные и целевые объекты могут обладать сложной геометрией, есть вероятность неожиданного результата выравнивания. Необходима последующая проверка, особенно если объектам присвоены относительно низкие значения AF_CONF.

Параметры

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

Входные линейные или полигональные объекты для сопоставления.

Feature Layer
Целевые объекты

Входные линии или полигоны, по которым будут выровнены входные объекты.

Feature Layer
Расстояние поиска

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

Linear Unit
Сопоставление полей
(Дополнительный)

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

Value Table

Производные выходные данные

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

Обновленные входные объекты.

Feature Layer

arcpy.management.AlignFeatures(in_features, target_features, search_distance, {match_fields})
ИмяОписаниеТип данных
in_features

Входные линейные или полигональные объекты для сопоставления.

Feature Layer
target_features

Входные линии или полигоны, по которым будут выровнены входные объекты.

Feature Layer
search_distance

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

Linear Unit
match_fields
[[source_field, target_field],...]
(Дополнительный)

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

Value Table

Производные выходные данные

ИмяОписаниеТип данных
out_feature_class

Обновленные входные объекты.

Feature Layer

Пример кода

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

В следующем скрипте окна Python показано, как используется функция AlignFeatures в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/Countries.gdb"
arcpy.edit.AlignFeatures("countryA_border", "target_border", "25 Feet")
AlignFeatures, пример 2 (автономный скрипт)

Следующий автономный скрипт является примером применения функции AlignFeatures в среде скриптов.

import arcpy
import os

# All input data is in country.gdb and output will also go to this gdb
arcpy.env.workspace = os.path.join(os.getcwd(), "country.gdb")

in_features_orig = "common_border"
in_features_copy = "common_border1"

# Make a copy of the original data 
arcpy.management.CopyFeatures(in_features_orig, in_features_copy)

# Features to which input will be aligned
target_features = "country1_border"
search_dist = "100 Meters"
match_fields = [["A_field", "B_field"]]

arcpy.edit.AlignFeatures(in_features_copy, target_features, search_dist, match_fields)