Alinear entidades (Edición)

Resumen

Identifica partes incoherentes de las entidades de entrada en comparación con las entidades de destino dentro de una distancia de búsqueda y las alinea con las entidades de destino.

Ilustración

Ilustración de la herramienta 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 del valor de Distancia de búsqueda especificado respecto a la entidad de destino. La forma del candidato debe 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, el parámetro Campos coincidentes determina 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.

  • El 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 el parámetro 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. 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 ajustarán.

Feature Layer
Entidades de destino

Entidades poligonales o de línea de entrada con las que se alinearán las entidades de entrada.

Feature Layer
Distancia de búsqueda

La distancia que se utilizará 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 de coincidencia
(Opcional)

Campos de entidades de entrada y de destino. Si se proporciona, se comprobarán los candidatos coincidentes con cada pareja de campos 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.

Feature Layer

arcpy.management.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 ajustarán.

Feature Layer
target_features

Entidades poligonales o de línea de entrada con las que se alinearán las entidades de entrada.

Feature Layer
search_distance

La distancia que se utilizará 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 proporciona, se comprobarán los candidatos coincidentes con cada pareja de campos 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.

Feature Layer

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 de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/Countries.gdb"
arcpy.edit.AlignFeatures("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 is in country.gdb and output will also go to this gdb
arcpy.env.workspace = os.path.join(os.getcwd(), "country.gdb")

in_features_orig = "common_border"
in_features_copy = "common_border1"

# Make a copy of the original data 
arcpy.management.CopyFeatures(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.edit.AlignFeatures(in_features_copy, target_features, search_dist, match_fields)