Crear ráster aleatorio (Administración de datos)

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

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
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. UNIFORM {Mínimo}, {Máximo}: distribución uniforme con el rango definido. Los valores predeterminados son 0,0 para {Mínimo} y 1,0 para {Máximo}. Ambos valores son de tipo doble. INTEGER {Mínimo}, {Máximo}: distribución de enteros con el rango definido. Los valores predeterminados son 1 para {Mínimo} y 10 para {Máximo}. Ambos valores son de tipo largo. NORMAL {Valor medio}, {Desviación estándar}: distribución normal con una {Desviación estándar} y un {Valor medio} definidos. Los valores predeterminados son 0,0 para {Valor medio} y 1,0 para {Desviación estándar}. Ambos valores son de tipo doble. EXPONENTIAL {Valor medio}: distribución exponencial con un {Valor medio} definido. El valor predeterminado es 1.0. El valor es de tipo doble. POISSON {Valor medio}: distribución Poisson con un {Valor medio} definido. El valor predeterminado es 1.0. El valor es de tipo doble. GAMMA {Alfa}, {Beta}: distribución Gamma con {Alpha} y {Beta} definidos. Los valores predeterminados son 1,0 para {Alfa} y 1,0 para {Beta}. Ambos valores son de tipo doble. BINOMIAL {N}, {Probabilidad}: distribución binomial con {Probabilidad} y {N} definidas. {N} es de tipo largo con un valor predeterminado de 10. {Probabilidad} es de tipo doble con un valor predeterminado de 0,5. GEOMETRIC {Probabilidad}: distribución geométrica con una {Probabilidad} definida. El valor predeterminado es 0.5. El valor es de tipo doble. NEGATIVE BINOMIAL {r}, {Probabilidad}: distribución Pascal con {Probabilidad} y {r} definidas. {r} es de tipo doble con un valor predeterminado de 10,0. {Probabilidad} es de tipo doble con un valor predeterminado de 0,5.	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

Extensión, Sistema de coordenadas de salida, Pirámide

Información de licenciamiento

• Basic: Requiere 3D Analyst o Spatial Analyst
• Standard: Requiere 3D Analyst o Spatial Analyst
• Advanced: Sí