Combinar (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Combina múltiples rásteres de manera que se asigna un único valor de salida a cada combinación única de valores de entrada.

Ilustración

Ilustración de Combinar
OutRas = Combine([InRas1, InRas2])

Uso

  • La herramienta Combinar funciona en valores enteros y en las tablas de atributos asociadas. Si los valores de la entrada son de punto flotante, se truncan automáticamente, se verifica que sean únicos contra la otra entrada y se envían a la tabla de atributos de salida.

  • La herramienta Combinar es similar a la herramienta Combinatoria Or. Ambas asignan un número nuevo a cada combinación única de valores de entrada. Sin embargo, en la herramienta Combinar, se puede especificar una lista de rásteres, mientras que en la herramienta Combinatoria Or solo se pueden especificar dos entradas, que pueden ser rásteres o valores constantes.

  • Cuando se especifica un ráster multibanda como uno de los valores del parámetro Rásteres de entrada (in_rasters en Python), se utilizarán todas las bandas.

    Para procesar una selección de bandas a partir de un ráster multibanda, cree primero un dataset ráster formado por esas bandas concretas con la herramienta Bandas compuestas; después, utilice el resultado en la lista del parámetro Rásteres de entrada (in_rasters en Python).

  • El ráster de salida siempre es de tipo entero.

  • Cada entrada de ráster se representa con un campo en la tabla de atributos de ráster (RAT) de salida en el que el orden de los campos de la salida coincide con el orden de los rásteres de entrada.

    Si existen entradas multibanda, la salida identifica cada banda como un ráster individual y se crea el correspondiente número de campos.

    Si se usa un mismo ráster varias veces, el ráster se considera como entradas individuales; sin embargo, se devuelve una advertencia.

  • El nombre de campo en el RAT de salida se basa en el nombre del dataset ráster. Si el nombre de campo es demasiado largo, se trunca para respetar la limitación de longitud de los nombres de campo. Cualquier carácter especial del nombre del ráster que no se admita en la base de datos se reemplaza por un guion bajo.

    En el caso de las entradas multibanda, el nombre del campo se construye con dos partes separadas por un guion bajo. La primera parte se deriva del nombre del ráster, seguido del índice de la banda, empezando por 1.

    En el caso de los nombres de campo duplicados, cada nombre de campo subsiguiente se cambia para hacerlo único, modificando el nombre del ráster con un índice que empieza por 1.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Rásteres de entrada

La lista de rásteres de entrada para combinar.

Raster Layer

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster combinado de salida.

Se asigna un valor entero único a cada combinación única de valores de entrada.

Raster

Combine(in_rasters)
NombreExplicaciónTipo de datos
in_rasters
[in_raster,...]

La lista de rásteres de entrada para combinar.

Raster Layer

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster combinado de salida.

Se asigna un valor entero único a cada combinación única de valores de entrada.

Raster

Muestra de código

Ejemplo 1 de Combinar (ventana de Python)

Este ejemplo toma diferentes rásteres de entrada en formatos distintos (Grid, IMG, y TIFF) y genera los valores de combinación única como un ráster de cuadrícula.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCombine = Combine(["filter", "zone", "source.img", "dec.tif"])
outCombine.save("C:/sapyexamples/output/outcombine2")
Ejemplo 2 de Combinar (secuencia de comandos independiente)

Este ejemplo toma diferentes rásteres de entrada en formatos distintos (Grid, IMG, y TIFF) y genera los valores de combinación única como un ráster de cuadrícula.

# Name: Combine_Ex_02.py
# Description: Combines multiple rasters such that a unique value is
#              assigned to each unique combination of input values
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster01 = "filter"
inRaster02 = "zone"
inRaster03 = "source.img"
inRaster04 = "dec.tif"

# Execute Combine
outCombine = Combine([inRaster01,inRaster02,inRaster03,inRaster04])

# Save the output 
outCombine.save("C:/sapyexamples/output/outcombine")