Создать произвольный растр (Управление данными)

Доступно с лицензией Advanced.

Сводка

Создает набор растровых данных случайных значений с распределением, которое может быть задано.

Использование

  • Вы можете сохранить выходные данные в Esri Grid, CRF, IMG, TIFF или в любой набор растровых данных базы геоданных.

  • Значения, заданные в ячейках выходного растра, являются производными от генератора случайных чисел и выбранного типа распределения. Для использования доступны несколько генераторов случайных чисел; тот, который требуется использовать, указывается в разделе Случайные числа диалогового окна Параметры среды. Генератор случайных чисел запускает поток случайных чисел, исходя из типа генератора и начального значения. Эти числа определяются произвольно, значения находятся в диапазоне от 0 до 1. Каждое значение не зависит от остальных.

    Генераторы случайных чисел используют различные типы распределения, присваивая (или преобразовывая) значения выходным растровым данным. Распределения в целом дают разные результаты, и конечного использование растра определяет, какое распределение выбрать. Если произвольный растр призван смоделировать какие-либо природные явления, выбираемый тип распределения должен как можно лучше описывать функционирование этого явления.

    Описание распределений и то, как они в целом используются см. в разделе Распределения для присвоения произвольных значений.

  • Время обработки равномерного, целочисленного, обычного и экспоненциального распределения не зависит от используемых аргументов, при этом время обработки биномиального, геометрического, гамма-распределения, а также распределения Пуассона и Паскаля могут значительно меняться в зависимости от аргументов.

  • Если не предусмотрено никакого значения, вычисляется значение по умолчанию для параметра размера ячейки. Значение основывается на размере экстента.

  • В диалоговом окне инструмента, значения, представленные в параметре Выходной экстент, соответствуют системе координат карты. Во время работы инструмента экстент проецируется в Выходную систему координат, если она задана в параметрах среды.

Синтаксис

CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize})
ParameterОбъяснениеТип данных
out_path

Выберите папку или базу геоданных, где будет храниться набор растровых данных.

Workspace
out_name

Укажите имя и, если необходимо, расширение для выходного набора данных.

При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно.

Для сохранения выходных данных в формате наборов растровых данных Esri Grid или набора растровых данных в базе геоданных не требуется указывать расширение файла для имени набора растровых данных. Для сохранения набора растровых данных в одном из доступных форматов файлов растров укажите расширение tif, чтобы вывести растр в формате TIFF, или .img для получения растра ERDAS IMAGINE.

При сохранении набора растровых данных в файл TIFF или в базе геоданных можно задать тип и качество сжатия.

String
distribution
(Дополнительный)

Укажите, какой будет использоваться метод распределения случайных значений.

  • UNIFORM {Minimum}, {Maximum} – равномерное распределение значений с заданным диапазоном. Значения по умолчанию: 0.0 для {Minimum} и 1.0 для {Maximum}. Оба значения относятся к типу double (число двойной точности).
  • INTEGER {Minimum}, {Maximum} – целочисленное распределение с заданным диапазоном. Значения по умолчанию: 1 для {Minimum} и 10 для {Maximum}. Оба значения относятся к типу long.
  • NORMAL {Mean}, {Standard Deviation} – Нормальное распределение значений с установленным средним значением {Mean} и средним квадратическим отклонением {Standard Deviation}. Значения по умолчанию: 0,0 для {Mean} и 1,0 для {Standard Deviation}. Оба значения относятся к типу double (число двойной точности).
  • EXPONENTIAL {Mean} – Экспоненциальное распределение с установленным средним значением {Mean}. Значение по умолчанию - 1,0. Значение относится к типу двойной точности.
  • POISSON {Mean} – Распределение Пуассона с установленным средним значением {Mean}. Значение по умолчанию - 1,0. Значение относится к типу двойной точности.
  • GAMMA {Alpha}, {Beta} – Гамма-распределение с установленным {Alpha} и {Beta}. Значения по умолчанию: 1,0 для {Alpha} и 1,0 для {Beta}. Оба значения относятся к типу double (число двойной точности).
  • BINOMIAL {N}, {Probability} – Биномиальное распределение с установленными N и вероятностью. Значение {N} относится к типу длинное целое и по умолчанию равно 10. Вероятность относится к типу double (число двойной точности) и по умолчанию равно 0,5.
  • GEOMETRIC {Probability} – геометрическое распределение с установленной вероятностью {Probability}. Значение по умолчанию - 0,5. Значение относится к типу двойной точности.
  • NEGATIVE BINOMIAL {r}, {Probability} – Распределение Паскаля с установленными значениями {r} и вероятности {Probability}. Значение {r} относится к типу double (число двойной точности) и по умолчанию равно 10,0. Вероятность относится к типу double (число двойной точности) и по умолчанию равно 0,5.
String
raster_extent
(Дополнительный)

Установите экстент выходного набора растровых данных.

Extent
cellsize
(Дополнительный)

Задайте пространственное разрешение выходного набора растровых данных.

Double

Производные выходные данные

NameОбъяснениеТип данных
out_raster_dataset

Выходной набор растровых данных.

Набор растровых данных

Пример кода

CreateRandomRaster, пример 1 (окно Python)

В этом примере создается выходной растр случайных значений с нормальным распределением в заданном экстенте и с заданным размером ячеек.

import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast", 
                                    "NORMAL 3.0", "0 0 500 500", 50)
CreateRandomRaster, пример 2 (автономный скрипт)

В этом примере создается выходной растр случайных значений с распределением Пуассона в заданном экстенте и с определенным размером ячеек.

# 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)

Информация о лицензиях

  • Basic: Требуется Дополнительный модуль 3D Analyst или Spatial Analyst
  • Standard: Требуется Дополнительный модуль 3D Analyst или Spatial Analyst
  • Advanced: Да

Связанные разделы