Disponible con una licencia Advanced.
Resumen
Crea un dataset ráster de valores aleatorios con una distribución que puede definir el usuario.
Uso
Puede guardar la salida en un ráster de Cuadrícula de Esri, CRF, IMG, TIFF o dataset ráster de geodatabase.
Los valores asignados a cada celda en el ráster de salida se derivan del generador de números aleatorios y del tipo de distribución seleccionada. Existen muchos generadores de números aleatorios disponibles para su uso y el que desee utilizar se identifica en la Configuración del entorno, en la sección Números aleatorios. El generador de números aleatorios inicia una transmisión de números aleatorios basados en el tipo de generador y un valor seed. Estos números se determinan al azar y los valores se encuentran entre 0 y 1. Cada valor es independiente de los demás valores.
Existen varios tipos de distribución disponibles para los generadores de números aleatorios al asignar (o transformar) los valores en el ráster de salida. Las distribuciones en general producen distintos resultados, y es el usuario final del ráster el que determina la distribución que se elegirá. Si el ráster aleatorio tiene el fin de modelar un fenómeno natural, la distribución seleccionada será la mejor representación del proceso del fenómeno.
Para obtener una descripción de las distribuciones y la manera en que generalmente se utilizan, consulte Distribuciones para la asignación de valores aleatorios.
Los tiempos de procesamiento de las distribuciones Uniforme, Entero, Normal y Exponencial son independientes de sus argumentos, mientras que los tiempos de procesamiento de las distribuciones Poisson, Gamma, Binomial, Geométrica y Pascal pueden variar de manera considerable cuando cambian los argumentos.
Si no se provee un valor para el parámetro de tamaño de la celda, se calculará un valor predeterminado. Este valor está basado en el tamaño de la extensión.
En el cuadro de diálogo de la herramienta, los valores presentados en el parámetro Extensión de salida están en el sistema de coordenadas del mapa. Durante la ejecución de la herramienta, la extensión se proyecta al Sistema de coordenadas de salida si así se especifica en la configuración del entorno.
Sintaxis
arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize})
Parámetro | Explicación | Tipo de datos |
out_path | Seleccione una carpeta o geodatabase donde se va a almacenar el dataset ráster. | Workspace; Raster Catalog |
out_name | Especifique un nombre y, si es necesario, una extensión para el dataset ráster de salida. Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Para almacenar la salida como un ráster de Cuadrícula de Esri o como un dataset ráster en una geodatabase, no se debe agregar ninguna extensión de archivo al nombre del dataset ráster. Para almacenar el dataset ráster con uno de los formatos de ráster de archivo disponibles, especifique la extensión tif para generar un ráster TIFF o .img para generar un ráster ERDAS IMAGINE. Cuando almacena el dataset ráster en un archivo TIFF, o en un ráster de geodatabase, puede especificar un tipo de compresión y la calidad de compresión. | String |
distribution (Opcional) | Especifique el método de distribución de valores aleatorios que va a utilizar.
| String |
raster_extent (Opcional) | Establezca la extensión del dataset ráster de salida. | Extent |
cellsize (Opcional) | Defina la resolución espacial del dataset ráster de salida. | Double |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_raster_dataset | El dataset ráster de salida. | Dataset ráster |
Muestra de código
Ejemplo 1 de CreateRandomRaster (ventana de Python)
En este ejemplo se crea un ráster de salida de valores aleatorios con una distribución normal utilizando el tamaño y la extensión de celda definidos.
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)
Ejemplo 2 de CreateRandomRaster (secuencia de comandos independiente)
Este ejemplo crea un ráster de salida de valores aleatorios con una distribución Poisson con el tamaño y la extensión de celda definido.
# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a random raster dataset based on a
# user-specified distribution and extent.
# Requirements: None
# Import system modules
import arcpy
# Set local variables
outPath = "c:/output"
outFile = "randrast02"
distribution = "POISSON 6.4"
outExtent = "250 250 750 750"
cellSize = 25
# Execute CreateRandomRaster
arcpy.CreateRandomRaster_management(outPath, outFile, distribution,
outExtent, cellSize)
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst o Spatial Analyst
- Standard: Requiere 3D Analyst o Spatial Analyst
- Advanced: Sí