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.

Más información sobre cómo funciona Combinación

Ilustración

Ilustración de la herramienta Combinació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 Todos los atributos o Solo Id. de entidad en el parámetro Atributos para unir. Permite la identificación de las áreas resultantes que están completamente encerradas por los polígonos resultantes. Los atributos FID correspondientes a estas entidades de espacio serán todos -1.

  • La clase de entidad de salida contendrá un atributo FID_<name> para cada una de las clases de entidad de entrada. Por ejemplo, si a una de las clases de entidad de entrada se le asigna el nombre Soils, habrá un atributo FID_Soils en la clase de entidad de salida. Los valores de FID_<name> serán -1 para cualquier entidad de entrada (o cualquier parte de una entidad de entrada) que no interseque con otra entidad de entrada. En este caso, los valores de atributo para las demás clases de entidad de la unión donde no se ha detectado ninguna intersección no se transferirán a la entidad de salida.

  • 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ó equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de 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 puede generar entidades multiparte en la salida, aunque todas las entradas tengan una única parte. Si no desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple en la clase de entidad de salida.

  • Licencia:

    Las licencias de ArcGIS Desktop Basic y Desktop Standard limitan el número de capas o clases de entidad de entrada a dos.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia clúster, 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
Clase de entidad de salida

La clase de entidad que contendrá los resultados.

Feature Class
Atributos para unir
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • Todos los atributosTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto los Id. de entidadTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • Solo Id. de entidadSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
String
Tolerancia XY
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
Espacios permitidos
(Opcional)

Especifica si una entidad se creará para áreas de la salida que están completamente encerradas por polígonos.

Los espacios son áreas en la clase de entidad de salida que están completamente encerradas por otros polígonos (se crea desde la intersección de entidades o de agujeros existentes en los polígonos de entrada). Estas áreas no son válidas, pero puede identificarlas para su análisis. Para identificar los espacios en la salida, desactive este parámetro; se creará una entidad en estas áreas. Para seleccionar estas entidades, consulte la clase de entidad de salida en función de todos los valores de FID de la entidad de entrada que sean igual que -1.

  • Activada: no se creará ninguna entidad para un área de la salida que esté completamente encerrada por polígonos. Esta es la opción predeterminada.
  • Desactivada: se creará una entidad para un área de la salida que esté completamente encerrada por polígonos. Esta entidad no tendrá valores de atributos y tendrá un valor FID de -1.
Boolean

arcpy.analysis.Union(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {gaps})
NombreExplicaciónTipo de datos
in_features
[[in_features, {rank}],...]

Las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia clúster, 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)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • ALLTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_FIDTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • ONLY_FIDSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
String
cluster_tolerance
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
gaps
(Opcional)

Especifica si una entidad se creará para áreas de la salida que están completamente encerradas por polígonos.

Los espacios son áreas en la clase de entidad de salida que están completamente encerradas por otros polígonos (se crea desde la intersección de entidades o de agujeros existentes en los polígonos de entrada). Estas áreas no son válidas, pero puede identificarlas para su análisis. Para identificar los espacios en la salida, establezca este parámetro en NO_GAPS y se creará una entidad en estas áreas. Para seleccionar estas entidades, consulte la clase de entidad de salida en función de todos los valores de FID de la entidad de entrada que sean igual que -1.

  • GAPSNo se creará ninguna entidad para un área de la salida que esté completamente encerrada por polígonos. Esta es la opción predeterminada.
  • NO_GAPSSe creará una entidad para un área de la salida que esté completamente encerrada por polígonos. Esta entidad no tendrá valores de atributos y tendrá un valor FID de -1.
Boolean

Muestra de código

Ejemplo de Combinación (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/data/gdb"
arcpy.analysis.Union(["well_buff50", "stream_buff200", "waterbody_buff500"], 
                     "water_buffers", "NO_FID", 0.0003)
arcpy.analysis.Union([["counties", 2], ["parcels", 1], ["state", 2]], 
                     "state_landinfo")
Ejemplo 2 de Combinación (script independiente)

El siguiente script independiente muestra dos formas de aplicar la función Union en scripts.

# unions.py
# Purpose: union 3 feature classes

# Import the system modules
import arcpy

# Set the current workspace (to avoid having to specify the full path to the 
# feature classes each time)
arcpy.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"
arcpy.analysis.Union(inFeatures, outFeatures, "ONLY_FID")

# 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.analysis.Union(inFeatures, outFeatures)

Entornos

Casos especiales

Factor de procesamiento en paralelo

Esta herramienta respeta el entorno de Factor de procesamiento en paralelo. Si no se establece el entorno (valor predeterminado) o si se establece en 0, se desactivará el procesamiento en paralelo. El procesamiento paralelo no se utilizará y el procesamiento se hará de forma secuencial. Si se establece el entorno en 100, se habilitará el procesamiento en paralelo. Se utilizará el procesamiento paralelo y el procesamiento se hará en paralelo. Se utilizarán hasta 10 núcleos cuando se active el procesamiento en paralelo.

En estos momentos, procesamiento en paralelo es compatible con las operaciones de polígono sobre polígono, línea sobre polígono y punto sobre superposición poligonal.

Información de licenciamiento

  • Basic: Limitado
  • Standard: Limitado
  • Advanced: Sí

Temas relacionados