Crear ráster constante (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Crea un ráster de un valor constante dentro de la extensión y el tamaño de celda de la ventana de análisis.

Ilustración

Ilustración de Crear ráster constante
OutRas = CreateConstantRaster(2)

Uso

  • La herramienta Crear ráster constante asigna el valor especificado a cada celda en el ráster de salida.

  • El valor constante debe ser un valor numérico. Es aceptable la notación científica (por ejemplo, 3,048e-4 para 0,003048).

  • El parámetro Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse a partir de un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro ni el tamaño de celda del entorno, pero se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se especifica nada, el tamaño de celda es 1.

  • Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.

    Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente a la referencia espacial de salida, se proyecta en función del valor de Método de proyección de tamaño de celda seleccionado.

  • Dado que la herramienta no tiene ninguna entrada, la referencia espacial de salida se deriva de otra configuración en un orden específico. En primer lugar, se usará el entorno Sistema de coordenadas de salida si se especifica, seguido del sistema de coordenadas de la vista de mapa. Si no se cumple ninguna de estas condiciones, la referencia espacial de salida se definirá como Desconocida.

  • En función del tamaño de celda, la extensión de salida predeterminada se calcula para crear un ráster de 250 filas y 250 columnas. Por lo tanto, para el tamaño de celda predeterminado de 1, la Extensión de salida es (0, 0, 250, 250). El valor de extensión se ajusta en función de los entornos Tamaño de celda, Ráster de alineación y Sistema de coordenadas de salida, si se especifica.

  • 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
Valor constante

Valor constante con el que se rellenan todas las celdas del ráster de salida.

Double
Tipo de datos de salida
(Opcional)

El tipo de datos del dataset ráster de salida.

Si el tipo de datos especificado es de punto flotante, los valores de las celdas del ráster de salida solo serán precisas en el valor constante de 7 posiciones decimales, independientemente del formato de salida.

  • EnteroSe creará un ráster entero.
  • FlotanteSe creará un ráster de punto flotante.
String
Tamaño de celda de salida
(Opcional)

El tamaño de celda del ráster de salida que se va a crear.

Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.

Analysis Cell Size
Extensión de salida
(Opcional)

Extensión para el dataset ráster de salida.

La extensión será el valor del entorno si se lo establece específicamente. Si no se lo establece específicamente, el valor predeterminado es 0, 0, 250, 250.

Envelope; Extent

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de salida para el que cada celda tendrá el valor constante especificado.

Raster

CreateConstantRaster(constant_value, {data_type}, {cell_size}, {extent})
NombreExplicaciónTipo de datos
constant_value

Valor constante con el que se rellenan todas las celdas del ráster de salida.

Double
data_type
(Opcional)

El tipo de datos del dataset ráster de salida.

  • INTEGERSe creará un ráster entero.
  • FLOATSe creará un ráster de punto flotante.

Si el tipo de datos especificado es de punto flotante, los valores de las celdas del ráster de salida solo serán precisas en el valor constante de 7 posiciones decimales, independientemente del formato de salida.

String
cell_size
(Opcional)

El tamaño de celda del ráster de salida que se va a crear.

Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte la sección Uso para obtener más detalles.

Analysis Cell Size
extent
(Opcional)

Extensión para el dataset ráster de salida.

La Extent es una clase de Python.

En esta herramienta toma la forma de Extent(XMin, YMin, XMax, YMax)

  • donde XMin y YMin definen la coordenada inferior izquierda de la extensión, y XMax y YMax definen la coordenada superior derecha.

Las coordenadas se especifican en las mismas unidades de mapa que la configuración del entorno Sistema de coordenadas de salida.

La extensión será el valor del entorno si se lo establece específicamente. Si no se lo establece específicamente, el valor predeterminado es 0, 0, 250, 250.

Envelope; Extent

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

Ráster de salida para el que cada celda tendrá el valor constante especificado.

Raster

Muestra de código

Ejemplo 1 de CreateConstantRaster (ventana de Python)

Este ejemplo crea un ráster flotante con un valor en particular en el tamaño y la extensión de celda definidos.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outConstRaster = CreateConstantRaster(12.7, "FLOAT", 2, Extent(0, 0, 250, 250))
outConstRaster.save("C:/sapyexamples/output/outconst2")
Ejemplo 2 de CreateConstantRaster (secuencia de comandos independiente)

Este ejemplo crea un ráster entero con un valor en particular en el tamaño y la extensión de celda definidos.

# Name: CreateConstantRaster_Ex_02.py
# Description: Creates a raster from a constant value
# Requirements: Spatial Analyst Extension

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

# Set local variables
constantValue = 12
cellSize = 2
outExtent = Extent(0, 0, 250, 250)

# Execute CreateConstantRaster
outConstRaster = CreateConstantRaster(constantValue, "FLOAT", cellSize,
                                      outExtent)

# Save the output 
outConstRaster.save("C:/sapyexamples/output/outconst")