Crear ráster constante (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
 |
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).
Algunas de las razones más comunes para crear un ráster con todos los valores iguales incluyen:
- 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.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
constant_value |
El valor constante desde el cual se crea un dataset 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, el valor constante de entrada sólo es exacto a 7 posiciones decimales (precisión simple). | 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 Extensión es una clase de Python. En esta herramienta toma la forma de: Extensión(XMín, YMín, XMáx, YMáx)
Las coordenadas se especifican en las mismas unidades de mapa que in_raster. 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 |
El ráster de salida para el cual cada celda tendrá un valor constante especificado. | Raster |
Ejemplo de código
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")
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")