Entidades de ajuste de bordes (Edición)

Resumen

Modifica las entidades de línea de entrada mediante el ajuste espacial de sus formas, guiada por los vínculos de ajuste de bordes especificados, de modo que se conecten con las líneas en el dataset adyacente.

Más información sobre el ajuste de bordes

Ilustración

Uso

Precaución:

Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

• Esta herramienta está pensada para utilizarse tras la herramienta Generar vínculos de ajuste de bordes. Ajusta espacialmente las formas de las líneas de entrada, guiada por las entidades de vínculo de entrada creadas por la herramienta Generar vínculos de ajuste de bordes, de modo que se conecten correctamente con las entidades de línea adyacentes a lo largo de las áreas de borde. Las entidades de vínculo de entrada deben tener los campos SRC_FID y ADJ_FID.

Nota:

Todas las entradas deben estar en el mismo sistema de coordenadas.

• Esta herramienta deriva las nuevas ubicaciones de conexión de los vínculos de ajuste de bordes y posteriormente modifica las entidades correspondientes para que sus extremos se conecten a las nuevas ubicaciones. Dependiendo de las entradas (Entidades de entrada, Entidades adyacentes y Entidades de borde) que proporcione, se determinarán las nuevas ubicaciones de conexión y las entidades relevantes se ajustarán en consecuencia. Este ajuste garantiza que las entidades coincidentes estén conectadas, tal y como se describe a continuación:

  • Si solo proporciona Entidades de entrada, los extremos de los vínculos de ajuste de bordes se utilizan como las nuevas ubicaciones de conexión. Las líneas de entrada asociadas con los vínculos de ajuste de bordes (es decir, sus Id. de entidad coinciden con los valores SRC_FID de los vínculos) se ajustan de modo que finalicen en los extremos de los vínculos. Esto garantiza que se conecten con las entidades adyacentes previstas que han intervenido en la generación de los vínculos de ajuste de bordes.
  • Si proporciona tanto Entidades de entrada como Entidades adyacentes, los puntos intermedios de los vínculos de ajuste de bordes se utilizan como las nuevas ubicaciones de conexión. Tanto las líneas de entrada asociadas como las líneas adyacentes asociadas (es decir, sus Id. de entidad coinciden con los valores ADJ_FID de los vínculos) están ajustadas de modo que sus extremos se conecten a los puntos intermedios de los vínculos.
  • Si especifica Entidades de borde, la herramienta utiliza las ubicaciones en los bordes más cercanos a los puntos intermedios de los vínculos de ajuste de bordes como las nuevas ubicaciones de conexión. Las Entidades de entrada y las Entidades adyacentes (si se especifican) se ajustan para que sus extremos se conecten con las ubicaciones de borde calculadas.

  El parámetro Método dispone de tres opciones de ajuste de borde para ajustar las entidades. Cada opción se aplica solo a las entidades de entrada o tanto a las entidades de entrada como a las entidades adyacentes, tal y como se ha descrito más arriba.

  • Mover extremo (MOVE_ENDPOINT en Python): mueve el extremo de la línea de entrada a la nueva ubicación de conexión.
  • Agregar segmento (ADD_SEGMENT en Python): agrega un segmento recto al final de una línea de entrada para que finalice en la nueva ubicación de conexión.
  • Ajustar vértices (ADJUST_VERTICES en Python): ajusta el extremo de una línea a la nueva ubicación de conexión. Los vértices restantes también se ajustan de modo que sus cambios posicionales se reduzcan gradualmente hacia el extremo opuesto de la línea.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Entidades de línea de entrada que se deben ajustar.	Feature Layer
Entidades de vínculo de entrada	Entidades de línea de entrada que representan vínculos de ajuste de bordes.	Feature Layer
Método (Opcional)	Método de ajuste de bordes que se utiliza para ajustar solo las entidades de entrada o tanto las entidades de entrada como las entidades de borde a las nuevas ubicaciones de conexión. Mover extremo—Mueve el extremo de una línea a la nueva ubicación de conexión. Esta es la opción predeterminada. Agregar segmento—Añade un segmento recto al final de una línea para que finalice en la nueva ubicación de conexión. Ajustar vértices—Ajusta el extremo de una línea a la nueva ubicación de conexión. Los vértices restantes también se ajustan de modo que sus cambios posicionales se reduzcan gradualmente hacia el extremo opuesto de la línea.	String
Entidades adyacentes (Opcional)	Entidades de línea que son adyacentes a las entidades de entrada. Si se especifican, tanto las entidades de entrada como las adyacentes se ajustan para contactar en las nuevas ubicaciones de conexión, ya sea en los puntos intermedios de los vínculos de ajuste de bordes o en las ubicaciones más cercanas a los puntos intermedios de los vínculos en las entidades de borde (si se especifican).	Feature Layer
Entidades de borde (Opcional)	Entidades poligonales o de línea que representan los bordes entre las entidades de entrada y las adyacentes. Cuando especifica entidades de borde, tanto las entidades de entrada como las entidades adyacentes se ajustan para contactar en las nuevas ubicaciones de conexión más cercanas a los puntos intermedios de los vínculos en las entidades de borde.	Feature Layer

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de entrada actualizadas	Las entidades de entrada actualizadas.	Feature Layer

Python

arcpy.edit.EdgematchFeatures(in_features, in_link_features, {method}, {adjacent_features}, {border_features})

Nombre	Explicación	Tipo de datos
in_features	Entidades de línea de entrada que se deben ajustar.	Feature Layer
in_link_features	Entidades de línea de entrada que representan vínculos de ajuste de bordes.	Feature Layer
method (Opcional)	Método de ajuste de bordes que se utiliza para ajustar solo las entidades de entrada o tanto las entidades de entrada como las entidades de borde a las nuevas ubicaciones de conexión. MOVE_ENDPOINT—Mueve el extremo de una línea a la nueva ubicación de conexión. Esta es la opción predeterminada. ADD_SEGMENT—Añade un segmento recto al final de una línea para que finalice en la nueva ubicación de conexión. ADJUST_VERTICES—Ajusta el extremo de una línea a la nueva ubicación de conexión. Los vértices restantes también se ajustan de modo que sus cambios posicionales se reduzcan gradualmente hacia el extremo opuesto de la línea.	String
adjacent_features (Opcional)	Entidades de línea que son adyacentes a las entidades de entrada. Si se especifican, tanto las entidades de entrada como las adyacentes se ajustan para contactar en las nuevas ubicaciones de conexión, ya sea en los puntos intermedios de los vínculos de ajuste de bordes o en las ubicaciones más cercanas a los puntos intermedios de los vínculos en las entidades de borde (si se especifican).	Feature Layer
border_features (Opcional)	Entidades poligonales o de línea que representan los bordes entre las entidades de entrada y las adyacentes. Cuando especifica entidades de borde, tanto las entidades de entrada como las entidades adyacentes se ajustan para contactar en las nuevas ubicaciones de conexión más cercanas a los puntos intermedios de los vínculos en las entidades de borde.	Feature Layer

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Las entidades de entrada actualizadas.	Feature Layer

Muestra de código

Ejemplo 1 de EdgematchFeatures (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función EdgematchFeatures de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.EdgematchFeatures("cityA_Roads.shp", "em_Links.shp"
                             "MOVE_ENDPOINT")

Ejemplo 2 de EdgematchFeatures (script independiente)

El siguiente script independiente de Python es un ejemplo de cómo aplicar la función EdgematchFeatures en un entorno de scripts.

# 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")

Entornos

Espacio de trabajo actual, Extensión

Información de licenciamiento

• Basic: No
• Standard: No
• Advanced: Sí