Crear ráster normal (Spatial Analyst)

Resumen

Crea un ráster de valores aleatorios con una distribución normal (gaussiana) dentro de la extensión y el tamaño de la celda de la ventana de análisis.

Ilustración

OutRas = CreateNormalRaster(1, 0 0 4 4)

Note: This output is representative. The actual values will be different each time the tool is executed.

Uso

• La herramienta Crear ráster normal genera valores para cada celda en el ráster de salida.

• El ráster de salida de ésta herramienta es siempre de punto flotante.

• Los valores de las celdas tendrán hasta 7 dígitos de precisión después del punto decimal.

• Los valores de salida tendrán un valor medio de 0,0 y una desviación estándar de 1,0. Si desea una desviación estándar diferente, multiplique el ráster de salida por ese valor. Si desea un valor medio diferente, sume ese valor al ráster. Por ejemplo, para crear un ráster donde los valores se caracterizan por un valor medio de 39 y una desviación estándar de 2,5, multiplique los resultados de Crear ráster normal por 2,5 y después sume 39.

  • En Álgebra de mapas podría hacer algo como:

    import arcpy
    from arcpy import env
    from arcpy.sa import *
    env.workspace = "C:/data"
    outNorm = CreateNormalRaster(1, Extent(0, 0, 100, 100)) * 2.5 + 39
    outNorm.save("C:/output/norm2")
    

• El generador de números aleatorios se inicia automáticamente con el valor actual del reloj del sistema (segundos desde el 1º de enero de 1970). Si reinicia la herramienta Crear ráster aleatorio también se reinicia Crear ráster normal.

Sintaxis

CreateNormalRaster ({cell_size}, {extent})

Parámetro	Explicación	Tipo de datos
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) donde XMín e YMín definen la coordenada inferior izquierda de la extensión, y XMáx e YMáx definen la coordenada derecha superior. 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 de valores distribuidos normalmente con un valor medio de 0,0 y una desviación estándar de 1,0.	Raster

Ejemplo de código

Ejemplo 1 de CreateNormalRaster (ventana de Python)

Este ejemplo crea un ráster de salida de valores distribuidos normalmente con el tamaño y la extensión de celda definido.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNormalRaster = CreateNormalRaster(2, Extent(0, 0, 150, 150))
outNormalRaster.save("C:/sapyexamples/output/outnormal")

Ejemplo 2 de CreateNormalRaster (secuencia de comandos independiente)

Este ejemplo crea un ráster de salida de valores distribuidos normalmente con el tamaño y la extensión de celda definido.

# Name: CreateNormalRaster_Ex_02.py
# Description: Creates a raster of random values from a normal distribution
# 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
cellSize = 2
extent = Extent(0, 0, 150, 150)

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

# Execute CreateNormalRaster
outNormalRaster = CreateNormalRaster(cellSize, extent) 

# Save the output 
outNormalRaster.save("C:/sapyexamples/output/outnormraster")

Entornos

Tamaño de celda, Espacio de trabajo actual, Máscara, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal, Alinear ráster

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