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

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

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

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

Иллюстрация

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

Внимание:

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

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

Примечание:

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Входные линейные объекты для уравнивания.	Feature Layer
Входные объекты-связи	Входные линейные объекты, представляющие связи метода подгонки границ.	Feature Layer
Метод (Дополнительный)	Метод подгонки границ должен использоваться для уравнивания только входных объектов, либо входных и смежных объектов, к их новым местоположениям соединений. Переместить точку—Перемещает конечную точку линии в новое местоположение соединения. Это значение по умолчанию Добавить сегмент—Добавляет прямой сегмент к конечной точке линии, так что он заканчивается в новом местоположении соединения. Подтянуть вершины—Перемещает конечную точку линии в новое местоположение соединения. Оставшиеся вершины также перемещаются таким образом, что изменение их позиций будет постепенно уменьшаться в направлении к противоположному концу линии.	String
Смежные объекты (Дополнительный)	Линейные объекты, которые уравниваются с входными объектами. Если выбрана данная опция, то входные линии и смежные линии будут уравнены таким образом, что они будут заканчиваться в новых местоположениях соединений: либо в средних точках связей подгонки границ, либо в местоположениях, ближайших к средним точкам связей на объектах границ (если выбрано).	Feature Layer
Объекты-границы (Дополнительный)	Линейные или полигональные объекты, представляющие границы между входными и смежными объектами. Когда вы указываете объекты-границы, то и входные, и смежные объекты подгоняются так, чтобы они сходились в новых местоположениях соединений, которые являются ближайшими к средним точкам связей объектов-границ.	Feature Layer

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

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

Python

arcpy.edit.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

Пример кода

Пример 1 функции EdgematchFeatures (окно 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
#              might not be desired; they are finally used to adjust input features 
#              (a copy is made) to connect with the matched adjacent feautures.
# Author:      Esri
# -----------------------------------------------------------------------

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.overwriteOutput = True
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.GenerateEdgematchLinks_edit(inFeatures, adjFeatures, gelOutput, search_distance, match_fields)

# ====================================================================================
# Note 1:  The result of GenerateEdgematchLinks may contain errors; see tool reference.
#          Inspection and editing may be necessary to ensure correct links before using
#          them for edgematching.
#
#          One of the possible errors are undesired 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.Intersect_analysis(gelOutput, qaLocations, "", "", "POINT")

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

# ====================================================================================
# Note 2:  At this point you can manually inspect locations in qaLocations; delete or
#          modify links as needed.
# ====================================================================================

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

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

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

Текущая рабочая область, Экстент

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

• Basic: Нет
• Standard: Нет
• Advanced: Да