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

Ilustración de la herramienta Entidades de ajuste de bordes

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 modifica las entidades correspondientes para que sus extremos se conecten a las nuevas ubicaciones. Dependiendo de los parámetros de entrada (Entidades de entrada, Entidades adyacentes y Entidades de borde) que especifique, 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, como se describe a continuación:

    • Si solo se especifica el parámetro Entidades de entrada, los extremos de los vínculos de ajuste de bordes se utilizarán 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 ajustarán 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.
    • Cuando se especifican los parámetros Entidades de entrada y 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) estarán ajustadas de modo que sus extremos se conecten a los puntos intermedios de los vínculos.
    • Cuando se especifique el parámetro Entidades de borde, la herramienta utilizará 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. Los valores de los parámetros Entidades de entrada y Entidades adyacentes (si se especifican) se ajustarán para que sus extremos se conecten con las ubicaciones de borde calculadas.

    El parámetro Método dispone de las siguientes 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, como se ha descrito más arriba.

    • Mover extremo: el extremo de la línea de entrada se moverá a la nueva ubicación de conexión.
    • Agregar segmento: se agregará 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: el extremo de una línea se ajustará a la nueva ubicación de conexión. Los vértices restantes también se ajustarán de modo que sus cambios posicionales se reduzcan gradualmente hacia el extremo opuesto de la línea.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Entidades de línea de entrada que se ajustarán.

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)

Especifica el método de ajuste de bordes que se utilizará 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 extremoEl extremo de la línea de entrada se moverá a la nueva ubicación de conexión. Esta es la opción predeterminada.
  • Agregar segmentoSe agregará un segmento recto al final de una línea para que finalice en la nueva ubicación de conexión.
  • Ajustar vérticesEl extremo de una línea se ajustará a la nueva ubicación de conexión. Los vértices restantes también se ajustarán de modo que los 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 proporcionan, tanto las entidades de entrada como las adyacentes se ajustarán 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 proporcionan).

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 ajustarán 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

EtiquetaExplicaciónTipo de datos
Entidades de entrada actualizadas

Las entidades de entrada actualizadas.

Feature Layer

arcpy.management.EdgematchFeatures(in_features, in_link_features, {method}, {adjacent_features}, {border_features})
NombreExplicaciónTipo de datos
in_features

Entidades de línea de entrada que se ajustarán.

Feature Layer
in_link_features

Entidades de línea de entrada que representan vínculos de ajuste de bordes.

Feature Layer
method
(Opcional)

Especifica el método de ajuste de bordes que se utilizará 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_ENDPOINTEl extremo de la línea de entrada se moverá a la nueva ubicación de conexión. Esta es la opción predeterminada.
  • ADD_SEGMENTSe agregará un segmento recto al final de una línea para que finalice en la nueva ubicación de conexión.
  • ADJUST_VERTICESEl extremo de una línea se ajustará a la nueva ubicación de conexión. Los vértices restantes también se ajustarán de modo que los 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 proporcionan, tanto las entidades de entrada como las adyacentes se ajustarán 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 proporcionan).

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 ajustarán 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

NombreExplicaciónTipo 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
             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")