Alinear entidades (Edición)

Resumen

Identifica partes incoherentes de las entidades de entrada respecto a las entidades de destino dentro de una distancia de búsqueda y las alinea con las entidades de destino.

Ilustración

Ilustración Alinear entidades

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.

    Nota:

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

  • Las entidades de entrada y las entidades de destino pueden ser entidades poligonales o de líneas Por ejemplo, puede tener un límite de condado como una línea o polígono, pero una parte de este difiere de la línea de centro del río que constituye el borde entre este condado y el condado vecino. Esta herramienta se puede utilizar para alinear esta parte del límite del condado con la línea de centro del río para que coincidan.

  • Una entidad de entrada, o parte de ella, se convierte en un candidato para la alineación cuando está dentro de la Distancia de búsqueda especificada respecto a la entidad de destino. La forma del candidato tiene que ser similar a la forma del destino; por ejemplo, una entidad de carretera de entrada y una entidad de carretera de destino que se ejecutan en paralelo son más similares que dos entidades que se cruzan entre sí en un ángulo de 90 grados.

  • Si se especifica, se utilizarán los Campos coincidentes para determinar si hay más probabilidad de que los candidatos para la alineación sean las entidades coincidentes correctas respecto a las entidades de destino. Por ejemplo, si se encuentran dos entidades de entrada dentro de la distancia de búsqueda respecto a una entidad de destino y ambas son similares en cuanto a forma al destino, la que tenga un valor de campo coincide será un candidato más firme.

  • La alineación conserva las relaciones topológicas existentes entre las entidades de entrada. Por ejemplo, si una línea, con sus extremos conectados a otras líneas, se mueve debido a la alineación, los extremos de todas las líneas de conexión se moverán para que las líneas permanezcan conectadas.

  • Un nuevo campo, AF_CONF, se agrega a la entrada modificada. Este campo almacena un valor mayor que 0 y hasta un máximo de 100, e indica el nivel de confianza de la alineación para cada entidad. El valor 100 significa que no hay ambigüedad en el candidato para la alineación. El valor disminuirá debido a los diversos candidatos potenciales que se encuentren, a la mayor cantidad de diferencias en la forma o a atributos sin coincidencia cuando se especifique la opción Campos coincidentes. El valor -1 se asigna a las entidades sin modificar. Debido a la posible complejidad de las entidades de entrada y de destino, se puede producir una alineación inesperada, por lo tanto, puede que sea necesario realizar una inspección posterior, sobre todo en aquellas entidades que tengan valores de AF_CONF relativamente bajos.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Entidades poligonales o de línea de entrada que se deben ajustar.

Feature Layer
Entidades de destino

Entidades poligonales o de línea de entrada como entidades de destino.

Feature Layer
Distancia de búsqueda

Distancia utilizada para buscar candidatos que coinciden. Se debe especificar una distancia que debe ser mayor que cero. Puede elegir la unidad que prefiera; el valor predeterminado es la unidad de la entidad.

Linear Unit
Campos coincidentes
(Opcional)

Campos de entidades de entrada y de destino. Si se especifican, cada pareja de campos se comprueba para candidatos coincidentes con el fin de ayudar a determinar la concordancia adecuada.

Value Table

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades de salida

Las entidades de entrada actualizadas.

Capa de entidades

arcpy.edit.AlignFeatures(in_features, target_features, search_distance, {match_fields})
NombreExplicaciónTipo de datos
in_features

Entidades poligonales o de línea de entrada que se deben ajustar.

Feature Layer
target_features

Entidades poligonales o de línea de entrada como entidades de destino.

Feature Layer
search_distance

Distancia utilizada para buscar candidatos que coinciden. Se debe especificar una distancia que debe ser mayor que cero. Puede elegir la unidad que prefiera; el valor predeterminado es la unidad de la entidad.

Linear Unit
match_fields
[[source_field, target_field],...]
(Opcional)

Campos de entidades de entrada y de destino. Si se especifican, cada pareja de campos se comprueba para candidatos coincidentes con el fin de ayudar a determinar la concordancia adecuada.

Value Table

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

Las entidades de entrada actualizadas.

Capa de entidades

Muestra de código

Ejemplo 1 de AlignFeatures (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/Countries.gdb"
arcpy.AlignFeatures_edit("countryA_border", "target_border", "25 Feet")
Ejemplo 2 de AlignFeatures (script independiente)

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

import arcpy
import os

# all input data are in country.gdb and output will also go to this gdb
arcpy.env.workspace = os.path.join(os.getcwd(), "country.gdb")

try:
    in_features_orig = "common_border"
    in_features_copy = "common_border1"
    
    # Make a copy of the original data 
    arcpy.CopyFeatures_management(in_features_orig, in_features_copy)
    
    # Features to which input will be aligned
    target_features = "country1_border"
    
    search_dist = "100 Meters"
    match_fields = "A_field B_field"
    
    arcpy.AlignFeatures_edit(in_features_copy, target_features, search_dist, match_fields)
    
except arcpy.ExecuteError as aex:
    print(arcpy.GetMessages(2))
    
except Exception as ex:
    print(ex.args[0])

Entornos

Casos especiales

Información de licenciamiento

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