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

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.

Sintaxis

arcpy.edit.AlignFeatures(in_features, target_features, search_distance, {match_fields})

Parámetro	Explicación	Tipo 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

Nombre	Explicación	Tipo 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

Espacio de trabajo actual, Extensión

Información de licenciamiento

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