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

Disponible con una licencia Advanced.

Resumen

Crea un dataset ráster de valores aleatorios con la distribución que defina.

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. Hay varios generadores de números aleatorios disponibles. Revise el entorno Generador de números aleatorios para determinar el que se va a utilizar. 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 el usuario final del ráster es quien determina la distribución que se va a utilizar. Si el ráster aleatorio sirve para modelar un fenómeno natural, la distribución seleccionada debería 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 del 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}, {build_rat})

Parámetro	Explicación	Tipo de datos
out_path	Carpeta o geodatabase en la que se guardará el dataset ráster de salida.	Workspace
out_name	Nombre y formato del dataset ráster que está creando. Para almacenar la salida como un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Para los rásteres basados en archivos, utilice la extensión adecuada para especificar el formato que se va a crear de la siguiente manera: .tif: ráster TIFF .img: ráster ERDAS IMAGINE .crf: ráster CRF Sin extensión: cuadrícula de Esri	String
distribution (Opcional)	Especifica el método de distribución de valores aleatorios que se va a utilizar. Cada tipo tiene una o dos configuraciones para controlar la distribución. UNIFORM {Minimum}, {Maximum}: distribución uniforme con el rango definido. Los valores predeterminados son 0,0 para {Minimum} y 1,0 para {Maximum}. Ambos valores son de tipo doble. INTEGER {Minimum}, {Maximum}: distribución de enteros con el rango definido. Los valores predeterminados son 1 para {Minimum} y 10 para {Maximum}. Ambos valores son de tipo largo. NORMAL {Mean}, {Standard Deviation}: distribución normal con los valores {Standard Deviation} y {Mean} definidos. Los valores predeterminados son 0,0 para {Mean} y 1,0 para {Standard Deviation}. Ambos valores son de tipo doble. EXPONENTIAL {Mean}: distribución exponencial con un valor {Mean} definido. El valor predeterminado es 1.0. El valor es de tipo doble. POISSON {Mean}: distribución Poisson con un valor {Mean} definido. El valor predeterminado es 1.0. El valor es de tipo doble. GAMMA {Alpha}, {Beta}: distribución gamma con los valores {Beta} y {Alpha} definidos. Los valores predeterminados son 1,0 para {Alpha} y 1,0 para {Beta}. Ambos valores son de tipo doble. BINOMIAL {N}, {Probability}: distribución binomial con los valores {Probability} y {N} definidos. El valor {N} es de tipo largo con un valor predeterminado de 10. El valor {Probability} es de tipo doble con un valor predeterminado de 0,5. GEOMETRIC {Probability}: distribución geométrica con un valor {Probability} definido. El valor predeterminado es 0.5. El valor es de tipo doble. NEGATIVE BINOMIAL {r}, {Probability}: distribución Pascal con los valores {Probability} y {r} definidos. El valor {r} es de tipo doble con un valor predeterminado de 10,0. El valor {Probability} es de tipo doble con un valor predeterminado de 0,5.	String
raster_extent (Opcional)	Extensión del dataset ráster de salida. MAXOF: se utilizará la extensión máxima de todas las entradas. MINOF: se utilizará el área mínima en común de todas las entradas. DISPLAY: la extensión es igual a la visualización actual. Nombre de capa: se utilizará la extensión de la capa especificada. Objeto de Extent: se utilizará la extensión del objeto especificado. Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.	Extent
cellsize (Opcional)	Resolución espacial del dataset ráster de salida.	Double
build_rat (Opcional)	Especifica si la herramienta construirá incondicionalmente una tabla de atributos de ráster para el ráster de salida en el que la distribución seleccionada genere un ráster de salida de entero. Este parámetro no tiene efecto si el ráster de salida es de punto flotante. BUILD —Se creará incondicionalmente una tabla de atributos de ráster para los rásteres de salida de entero. Esta es la opción predeterminada. DO_NOT_BUILD —No se creará una tabla de atributos de ráster para rásteres de salida de entero si el número de valores únicos es mayor o igual que 65535. Si el número de valores únicos es menor que 65535, se creará una tabla de atributos de ráster.	Boolean

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í