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 acerca ajuste de bordes

Ilustración

Uso

Precaución:

Esta herramienta modifica los datos de entrada. Vea Herramientas sin salidas para ver más información y estrategias para evitar cambios de datos no deseados.

• Esta herramienta está diseñada para usarse según las instrucciones de 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 con las entidades de línea adyacentes a lo largo de las áreas del 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 extrae las nuevas ubicaciones de conexión de los vínculos de ajuste de bordes y posteriormente modifica las entidades correspondientes para que finalicen en nuevas ubicaciones. Dependiendo de las entradas (Entidades de entrada, Entidades adyacentes y Entidades de límite) que proporcione, se determinarán las nuevas ubicaciones de conexión y las entidades relevantes se ajustarán en correspondencia. 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 identificadores 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 identificadores de entidad coinciden con los valores ADJ_FID de los vínculos) están ajustadas de modo que finalicen y se conecten en los puntos intermedios de los vínculos.
  • Si añade Entidades de límite, también debe especificar Entidades adyacentes. La herramienta busca las ubicaciones en los límites que están más cerca de los vínculos como las nuevas ubicaciones de conexión. Tanto las líneas de entrada como las líneas adyacentes asociadas con los vínculos de ajuste de bordes se ajustan para que se conecten en las ubicaciones de límite.

  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.

  • MOVE_ENDPOINT: mueve el extremo de la línea de entrada a la nueva ubicación de conexión.
  • ADD_SEGMENT: añade un segmento recto al final de una línea de entrada 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.

Sintaxis

EdgematchFeatures_edit (in_features, in_link_features, {method}, {adjacent_features}, {border_features})

Parámetro	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 adyacentes 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 límite (si se especifican). Si proporciona ambas entidades, debe proporcionar entidades adyacentes.	Feature Layer
border_features (Opcional)	Entidades de línea o poligonales que representan los límites entre las entidades de entrada y adyacentes. Si especifica las entidades de límite, también debe especificar las entidades adyacentes. 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 límite.	Feature Layer

Ejemplo de código

Ejemplo 1 de EdgematchFeatures (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo se utiliza la función EdgematchFeatures en el modo inmediato.

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

Ejemplo 2 de EdgematchFeatures (secuencia de comandos de Python independiente)

La siguiente secuencia de comandos de Python independiente es un ejemplo de cómo se aplica la función EdgematchFeatures en un entorno de secuencias de comandos.

# 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