Crear ráster constante—Ayuda

Disponible con una licencia de Spatial Analyst.

Resumen
Ilustración
Uso
Sintaxis
Muestra de código
Entornos
Información sobre licencias

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

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).
Algunas de las razones más comunes para crear un ráster con todos los valores iguales son las siguientes:
- Se ha establecido un entorno de Máscara y desea que un ráster identifique todas las celdas sin máscara para utilizar en varias herramientas diferentes (por ejemplo, como un ráster de condición en la herramienta Evaluación condicional).
- Desea que todos los valores en un ráster de salida de una máscara o un proceso de selección se clasifiquen como un valor único.
- Desea aplicar el valor constante de un análisis a todas las ubicaciones de celda en otro ráster; por ejemplo, desea agregar cinco decibeles a cada ubicación en un ráster de contaminación acústica.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Sintaxis

CreateConstantRaster (constant_value, {data_type}, {cell_size}, {extent})

Parámetro	Explicación	Tipo 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. INTEGER — Se creará un ráster entero. FLOAT — Se creará un ráster de punto flotante. Si el tipo de datos especificados es FLOAT, los valores de las celdas del ráster de salida solo serán exactas en el valor constante de 7 posiciones decimales, independientemente del formato de salida.	String
cell_size (Opcional)	El tamaño de celda para el dataset ráster de salida. Este es el valor del entorno si se lo establece específicamente. Si no está establecido específicamente, es el valor más bajo del ancho o la altura de la extensión del entorno en la referencia espacial de salida, dividido por 250.	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 derecha superior. Las coordenadas se especifican en las mismas unidades de mapa que el ajuste 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.	Extent

Valor de retorno

Nombre	Explicación	Tipo 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)

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

ArcMap

Crear ráster constante