Доступно с лицензией Advanced.
Сводка
Создает набор растровых данных случайных значений с распределением, которое задано.
Использование
Вы можете сохранить выходные данные в Esri Grid, CRF, IMG, TIFF или в любой набор растровых данных базы геоданных.
Значения, заданные в ячейках выходного растра, являются производными от генератора случайных чисел и выбранного типа распределения. Существует несколько генераторов случайных чисел. Посмотрите параметры среды для Генератора случайных чисел, чтобы выбрать какой генератор использовать. Генератор случайных чисел запускает поток случайных чисел, исходя из типа генератора и начального значения. Эти числа определяются произвольно, значения находятся в диапазоне от 0 до 1. Каждое значение не зависит от остальных.
Генераторы случайных чисел используют различные типы распределения, присваивая (или преобразовывая) значения выходным растровым данным. Распределения обычно дают различные результаты, и применяемое распределение определяется конечным использованием растра. Если произвольный растр призван смоделировать какие-либо природные явления, выбираемый тип распределения должен как можно лучше описывать функционирование этого явления.
Описание распределений и то, как они обычно используются см. в разделе Распределения для присвоения произвольных значений.
Время обработки равномерного, целочисленного, обычного и экспоненциального распределения не зависит от используемых аргументов, при этом время обработки биномиального, геометрического, гамма-распределения, а также распределения Пуассона и Паскаля могут значительно меняться в зависимости от аргументов.
Если не предусмотрено никакого значения, вычисляется значение по умолчанию для параметра размера ячейки. Значение основывается на размере экстента.
В диалоговом окне инструмента значения, представленные в параметре Выходной экстент, соответствуют системе координат карты. Во время работы инструмента экстент проецируется в Выходную систему координат, как она задана в параметрах среды.
Синтаксис
arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})
Parameter | Объяснение | Тип данных |
out_path | Папка или база геоданных, где будет располагаться выходной набор растровых данных. | Workspace |
out_name | Имя и формат создаваемого набора растровых данных. Чтобы сохранить выходные данные в виде набора растровых данных в базе геоданных, не добавляйте расширение файла к имени набора растровых данных. Для растров на основе файлов используйте соответствующее расширение, чтобы указать формат для создания следующим образом:
| String |
distribution (Дополнительный) | Указывает, какой метод распределения случайных значений будет использоваться. Каждый тип имеет одну или две настройки для управления распределением.
| String |
raster_extent (Дополнительный) | Экстент выходного набора растровых данных.
| Extent |
cellsize (Дополнительный) | Пространственное разрешение выходного растрового набора данных. | Double |
build_rat (Дополнительный) | Указывает, будет ли инструмент без условий строить таблицу атрибутов растра для выходного растра, в которой выбранное распределение приводит к целочисленному выходному растру. Этот параметр не имеет никакого эффекта, если выходной растр имеет значения с плавающей точкой.
| Boolean |
Производные выходные данные
Name | Объяснение | Тип данных |
out_raster_dataset | Выходной набор растровых данных. | Набор растровых данных |
Пример кода
В этом примере создается выходной растр случайных значений с нормальным распределением в заданном экстенте и с заданным размером ячеек.
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)
В этом примере создается выходной растр случайных значений с распределением Пуассона в заданном экстенте и с определенным размером ячеек.
# 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)
Environments
Информация о лицензиях
- Basic: Требуется Дополнительный модуль 3D Analyst или Spatial Analyst
- Standard: Требуется Дополнительный модуль 3D Analyst или Spatial Analyst
- Advanced: Да