Crear ráster aleatorio (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Crea un ráster de valores aleatorios de punto flotante entre 0,0 y 1,0 dentro de la extensión y del tamaño de celda de la ventana de análisis.

La herramienta Crear ráster aleatorio de la caja de herramientas Administración de datos proporciona una funcionalidad o rendimiento mejorados.

Ilustración

Ilustración de Crear ráster aleatorio
OutRas = CreateRandomRaster()
Nota: Esta salida es representativa. Los valores reales serán diferentes cada vez que se ejecute la herramienta.

Uso

  • La herramienta Crear ráster aleatorio 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.

  • El uso repetido del mismo valor seed o del valor predeterminado no generará el mismo ráster.

  • Puede cambiar el seed a través de un parámetro para asegurarse de obtener distintos puntos de inicio para el generador de números aleatorios.

  • Para generar los valores, se utiliza el algoritmo 599 de ACM generador de números aleatorios.

  • 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 mediante un valor numérico, la herramienta lo utilizará directamente para el ráster de salida.

    Si el tamaño de celda se especifica utilizando un dataset ráster, el parámetro mostrará 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 utilizará 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 de la referencia espacial de salida, se proyectará en función del valor de Método de proyección de tamaño de celda especificado.

  • 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.

  • La caja de herramientas Administración de datos contiene la herramienta Crear ráster aleatorio que ofrece más opciones para la distribución de los valores.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Valor de inicialización
(Opcional)

Un valor que se utilizará para reiniciar el generador de números aleatorios.

Puede ser un número entero o de punto flotante. No se permiten rásteres como entrada.

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). El rango de valores permitidos para el valor de inicialización es de -231+1 a 231 (o de -2.147.483.647 a 2.147.483.648).

Double
Tamaño de celda de salida
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.

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

El ráster de salida de los valores distribuidos en forma aleatoria con un rango de 0,0 a 1,0.

Raster

CreateRandomRaster({seed_value}, {cell_size}, {extent})
NombreExplicaciónTipo de datos
seed_value
(Opcional)

Un valor que se utilizará para reiniciar el generador de números aleatorios.

Puede ser un número entero o de punto flotante. No se permiten rásteres como entrada.

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). El rango de valores permitidos para el valor de inicialización es de -231+1 a 231 (o de -2.147.483.647 a 2.147.483.648).

Double
cell_size
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.

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

El ráster de salida de los valores distribuidos en forma aleatoria con un rango de 0,0 a 1,0.

Raster

Muestra de código

Ejemplo 1 de CreateRandomRaster (ventana de Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRandRaster = CreateRandomRaster(100, 2, Extent(0, 0, 150, 150))
outRandRaster.save("C:/sapyexamples/output/outrandom")
Ejemplo 2 de CreateRandomRaster (secuencia de comandos independiente)

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

# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a raster of random floating point values
#              between 0 and 1
# 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
seedValue = 1
cellSize = 2
extent = Extent(0, 0, 150, 150)

# Execute CreateRandomRaster
outRandomRaster = CreateRandomRaster(seedValue, cellSize, extent) 

# Save the output 
outRandomRaster.save("C:/sapyexamples/output/outrand")

Temas relacionados