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
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.
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)
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 |
Ejemplo 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")
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere Spatial Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst