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
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
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí