Подгонка границ объектов (Редактирование)

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

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

Более подробно о подгонке границ

Иллюстрация

Иллюстрация инструмента Подгонка границ объектов

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

    Внимание:

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

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

  • Примечание:

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

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

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

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

    • Переместить точку - Конечная точка входной линии будет перемещена в новое местоположение соединения.
    • Добавить сегмент - Прямой сегмент будет добавлен к конечной точке входной линии так, чтобы он заканчивался в новом местоположении соединения.
    • Подтянуть вершины - Конечная точка линии будет уравнена в новое местоположение соединения. Оставшиеся вершины будут также уравнены таким образом, что изменение их позиций будет постепенно уменьшаться в направлении к противоположному концу линии.

Параметры

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

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

Feature Layer
Входные объекты-связи

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

Feature Layer
Метод
(Дополнительный)

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

  • Переместить точкуКонечная точка линии будет перемещена в новое местоположение соединения. Это значение по умолчанию
  • Добавить сегментПрямой сегмент будет добавлен к конечной точке линии так, чтобы он заканчивался в новом местоположении соединения.
  • Подтянуть вершиныКонечная точка линии будет уравнена в новое местоположение соединения. Оставшиеся вершины будут также уравнены таким образом, что изменение их позиций будет постепенно уменьшаться в направлении к противоположному концу линии.
String
Смежные объекты
(Дополнительный)

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

Feature Layer
Объекты-границы
(Дополнительный)

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

Feature Layer

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

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

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

Feature Layer

arcpy.management.EdgematchFeatures(in_features, in_link_features, {method}, {adjacent_features}, {border_features})
ИмяОписаниеТип данных
in_features

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

Feature Layer
in_link_features

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

Feature Layer
method
(Дополнительный)

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

  • MOVE_ENDPOINTКонечная точка линии будет перемещена в новое местоположение соединения. Это значение по умолчанию
  • ADD_SEGMENTПрямой сегмент будет добавлен к конечной точке линии так, чтобы он заканчивался в новом местоположении соединения.
  • ADJUST_VERTICESКонечная точка линии будет уравнена в новое местоположение соединения. Оставшиеся вершины будут также уравнены таким образом, что изменение их позиций будет постепенно уменьшаться в направлении к противоположному концу линии.
String
adjacent_features
(Дополнительный)

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

Feature Layer
border_features
(Дополнительный)

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

Feature Layer

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

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

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

Feature Layer

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.EdgematchFeatures("cityA_Roads.shp", "em_Links.shp"
                             "MOVE_ENDPOINT")
EdgematchFeatures, пример 2 (автономный скрипт)

Пример скрипта Python для применения функции EdgematchFeatures в автономном режиме.

"""
Name:        EdgematchFeatures_example_script2.py
Description: Performs edgematching spatial adjustment using links produced by
             GenerateEdgematchLinks. The links go from input features to adjacent 
             features. The links are then checked for intersecting conditions, which
             may not be desired. They are then used to adjust input features 
             (a copy is made) to connect to the matched adjacent features.
"""

# Import system modules.
import arcpy

# Set environment settings.
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"D:\conflationTools\ScriptExamples\data.gdb"

# Set local variables.
inFeatures = "roads1"
adjFeatures = "roads2"
gelOutput = "gelinks_out"

search_distance = "200 Feet"
match_fields = "NAME ROAD_NAME"

qaLocations = "qa_locations"

# Generate rubbersheet links.
arcpy.edit.GenerateEdgematchLinks(inFeatures, adjFeatures, gelOutput, search_distance, match_fields)

"""
Note 1:  The result of GenerateEdgematchLinks may contain errors; see the tool reference.
         Inspection and editing may be necessary to ensure correct links before using
         them for edgematching.

         One of the possible errors is intersecting or touching links.  
         Their locations can be found by the process below.
"""

# Find locations where links intersect or touch. The result contains coincident points.
arcpy.analysis.Intersect(gelOutput, qaLocations, "", "", "POINT")

# Delete coincident points.
arcpy.management.DeleteIdentical(qaLocations, "Shape")

"""
Note 2:  You can manually inspect locations in qaLocations and delete or
         modify links as needed.
"""

# Make a copy of the inFeatures for edgematching.
inFeature_Copy = inFeatures + "_Copy"
arcpy.management.CopyFeatures(inFeatures, inFeature_Copy)

# Use the links to adjust the copy of the input features.
arcpy.edit.EdgematchFeatures(inFeature_Copy, gelOutput, "MOVE_ENDPOINT")