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.

Parámetros

EtiquetaExplicaciónTipo de datos
Localización de salida

Carpeta o geodatabase en la que se guardará el dataset ráster de salida.

Workspace
Nombre de dataset ráster con extensión

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
Distribución
(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.

  • Uniforme: distribución uniforme con el rango definido entre los valores mínimo y máximo. Los valores predeterminados son 0,0 para Mínimo y 1,0 para Máximo. Esta es la opción predeterminada.
  • Entero: distribución de enteros con el rango definido entre los valores mínimo y máximo. Los valores predeterminados son 1 para Mínimo y 10 para Máximo.
  • Normal: distribución normal con valores de media y desviación estándar definidos. Los valores predeterminados son 0,0 para Valor medio y 1,0 para Desviación estándar.
  • Exponencial: distribución exponencial con un valor de media definido. El valor predeterminado es 1.0.
  • Poisson: distribución Poisson con un valor de media definido. El valor predeterminado es 1.0.
  • Gamma: distribución gamma con valores alfa y beta definidos. Los valores predeterminados son 1,0 para Alfa y 1,0 para Beta.
  • Binomial: distribución binomial con valores N y de probabilidad definidos. Los valores predeterminados son 10 para N y 0,5 para Probabilidad.
  • Geométrica: distribución geométrica con un valor de probabilidad definido. El valor predeterminado es 0,5.
  • Binomial negativa: distribución Pascal con valores r y de probabilidad definidos. Los valores predeterminados son 10,0 para r y 0,5 para Probabilidad.

Para editar el valor predeterminado, haga clic en el valor de la tabla e introduzca el nuevo valor.

String
Extensión de salida
(Opcional)

Extensión del dataset ráster de salida.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent
Tamaño de celda
(Opcional)

Resolución espacial del dataset ráster de salida.

Double
Construir tabla de atributos ráster
(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.

  • Activado: se creará incondicionalmente una tabla de atributos de ráster para los rásteres de salida de entero. Esta es la opción predeterminada.
  • Desactivado: 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

EtiquetaExplicaciónTipo de datos
Dataset ráster de salida

El dataset ráster de salida.

Dataset ráster

arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})
NombreExplicaciónTipo 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 usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • 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.

  • BUILDSe 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_BUILDNo 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

NombreExplicaciónTipo 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)

Información de licenciamiento

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

Temas relacionados