Combinación (Análisis)
Resumen
Calcula una unión geométrica de las entidades de entrada. Todas las entidades y sus atributos se escribirán en la clase de entidad de salida.
Ilustración
 |
Uso
-
Todas las clases de entidad y las capas de entidades de entrada deben tener geometría de polígono.
-
El parámetro Permitir espacios se puede utilizar con la configuración ALL u ONLY_FID en el parámetro Unir atributos. Esto permite la identificación de las áreas resultantes que están completamente encerradas por los polígonos resultantes. Los atributos FID para estas entidades GAP serán todos -1.
-
Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay capas creadas por la herramienta Crear capa de entidades y el campo Utilizar política de relación está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relación en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió por igual, el valor del atributo de cada nueva entidad recibirá la mitad del valor del atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Precaución:Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla o clases de entidad de geodatabase.
-
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener información más detallada, vea Geoprocesamiento con datasets grandes.
-
Esta herramienta puede generar entidades multiparte en la salida aunque todas las entradas tengan una única parte. Si no se desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple sobre la clase de entidad de salida.
Licencia:Con las licencias de ArcGIS for Desktop Basic y Standard, la cantidad de capas o clases de entidad de entrada se limita a dos.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_features [[in_features, {Rank}],...] |
Una lista de las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia cluster, las entidades con la clasificación más baja se alinearán con la entidad con la clasificación más alta. La clasificación más alta es uno. Todas las entidades de entrada deben ser polígonos. | Value Table |
out_feature_class |
La clase de entidad que contendrá los resultados. | Feature Class |
join_attributes (Opcional) |
Determina qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.
| String |
cluster_tolerance (Opcional) |
La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). | Linear unit |
gaps (Opcional) |
Los espacios son áreas de la clase de entidad de salida que están completamente encerradas por otros polígonos. Esto no es válido, pero puede ser conveniente identificarlos para su análisis. Para encontrar los espacios en la salida, establezca esta opción a NO_GAPS, y se creará una entidad en estas áreas. Para seleccionar estas entidades, consulte la clase de entidad de salida según todos los valores de FID de la entidad de entrada que sean igual a -1.
| Boolean |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función Combinación en el modo inmediato.
import arcpy from arcpy import env env.workspace = "C:/data/data/gdb" arcpy.Union_analysis (["well_buff50", "stream_buff200", "waterbody_buff500"], "water_buffers", "NO_FID", 0.0003) arcpy.Union_analysis ([["counties", 2],["parcels", 1],["state", 2]], "state_landinfo")
La siguiente secuencia de comandos independiente muestra dos formas de aplicar la función Combinación en la secuencia de comandos.
# unions.py # Purpose: union 3 feature classes # Import the system modules import arcpy from arcpy import env # Set the current workspace # (to avoid having to specify the full path to the feature classes each time) env.workspace = "c:/data/data.gdb" # Union 3 feature classes but only carry the FID attributes to the output inFeatures = ["well_buff50", "stream_buff200", "waterbody_buff500"] outFeatures = "water_buffers" clusterTol = 0.0003 arcpy.Union_analysis (inFeatures, outFeatures, "ONLY_FID", clusterTol) # Union 3 other feature classes, but specify some ranks for each # since parcels has better spatial accuracy inFeatures = [["counties", 2],["parcels", 1],["state", 2]] outFeatures = "state_landinfo" arcpy.Union_analysis (inFeatures, outFeatures)