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

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

Краткая информация

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

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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Выходное местоположение

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

Workspace
Имя набора растровых данных с расширением

Имя и формат создаваемого набора растровых данных.

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

Для растров на основе файлов используйте соответствующее расширение, чтобы указать формат для создания следующим образом:

  • .tif – растр TIFF
  • .img – растр ERDAS IMAGINE
  • .crf – растр CRF
  • Нет расширения – Esri Grid
String
Распределение
(Дополнительный)

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

Каждый тип имеет одну или две настройки для управления распределением.

  • Равномерное – равномерное распределение с указанным диапазоном от Минимального до Максимального значений. Значения по умолчанию: 0,0 для Минимума и 1.0 для Максимума. Это значение по умолчанию.
  • Целочисленное – целочисленное распределение с указанным диапазоном от Минимального до Максимального значений. Значения по умолчанию: 1 для Minimum и 10 для Maximum.
  • Нормальное – нормальное распределение с указанными значениями Среднего и Среднеквадратичного отклонения. Значения по умолчанию: 0.0 для Среднего и 1.0 для Среднеквадратичного отклонения.
  • Экспоненциальное – экспоненциальное распределение с заданным Средним значением. Значение, предлагаемое по умолчанию, равно 1.0.
  • Пуассона – распределение Пуассона с заданным средним значением. Значение, предлагаемое по умолчанию, равно 1.0.
  • Гамма – гамма-распределение с заданными значениями Альфа и Бета. Значения по умолчанию: 1.0 для Альфа и 1.0 для Бета.
  • Биномиальное – биномиальное распределение с заданным значением N и Вероятность. Значения по умолчанию: 10 для N и 0.5 для Probability.
  • Геометрическое – геометрическое распределение с заданным значением Вероятности. Значение, предлагаемое по умолчанию, равно 0.5.
  • Отрицательное биномиальное – распределение Паскаля с заданными значениями r и вероятности. Значения по умолчанию: 10,0 для r и 0,5 для Вероятности.

Чтобы изменить значение по умолчанию, щелкните на нем в таблице и введите новое значение.

String
Выходной экстент
(Дополнительный)

Экстент выходного набора растровых данных.

  • Текущий экстент отображения Вид карты — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
  • Нарисовать экстент Закончить прямым углом - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта.
    Примечание:

    Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Среды диалогового окна инструмента.

    Примечание:

    Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент.

  • Экстент слоя Слой — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.

    У каждого слоя карте есть следующие опции:

    • Все объекты Выбрать все - экстент всех объектов слоя.
    • Выбранные объектыОбласть из выбранных объектов - экстент всех выбранных объектов слоя.
    • Отображаемые объекты Extent Indicator - экстент всех отображаемых объектов слоя.
      Примечание:

      Экстенты опций Выбранные объекты Область из выбранных объектов и Отображаемые объекты Extent Indicator доступны только для векторных слоев.

  • Обзор Обзор — Экстент будет основан на существующем наборе данных.
  • Буфер обмена Вставить - экстент может быть скопирован в буфер обмена и вставлен из него.
    • Копировать экстент Копировать - копирует координаты экстента и систему координат в буфер обмена.
    • Использовать Вставить экстент Вставить - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты.
    Примечание:

    Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка.

  • Сбросить экстент Сбросить — Экстент будет сброшен до значения по умолчанию.
  • Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.
    Внимание:

    На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.

Extent
Размер ячейки
(Дополнительный)

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

Double
Построить атрибутивную таблицу растра
(Дополнительный)

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

Этот параметр не имеет никакого эффекта, если выходной растр имеет значения с плавающей точкой.

  • Отмечено – таблица атрибутов растра будет безусловно построена для целочисленных выходных растров. Это значение по умолчанию.
  • Не отмечено – таблица атрибутов растра не будет строиться для целочисленных выходных растров, если число уникальных значений больше или равно 65535. Если число уникальных значений меньше 65535, то будет построена таблица атрибутов растра.
Boolean

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

ПодписьОписаниеТип данных
Выходной набор растровых данных

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

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

arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})
ИмяОписаниеТип данных
out_path

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

Workspace
out_name

Имя и формат создаваемого набора растровых данных.

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

Для растров на основе файлов используйте соответствующее расширение, чтобы указать формат для создания следующим образом:

  • .tif – растр TIFF
  • .img – растр ERDAS IMAGINE
  • .crf – растр CRF
  • Нет расширения – Esri Grid
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} и {Probability}. Значение {N} относится к типу long и по умолчанию равно 10. Значение {Probability} относится к типу double и по умолчанию равно 0,5.
  • GEOMETRIC {Probability} – геометрическое распределение с заданным значением {Probability}. Значение по умолчанию - 0,5. Значение относится к типу двойной точности.
  • NEGATIVE BINOMIAL {r}, {Probability} – распределение Паскаля с указанными значениями {r} и {Probability}. Значение {r} относится к типу double и по умолчанию равно 10,0. Значение {Probability} относится к типу double и по умолчанию равно 0,5.
String
raster_extent
(Дополнительный)

Экстент выходного набора растровых данных.

  • MAXOF – Будет использоваться максимальный экстент всех входных данных.
  • MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных.
  • DISPLAY — Экстент равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent — будет использоваться экстент указанного объекта.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
Extent
cellsize
(Дополнительный)

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

Double
build_rat
(Дополнительный)

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

Этот параметр не имеет никакого эффекта, если выходной растр имеет значения с плавающей точкой.

  • BUILDТаблица атрибутов растра будет безусловно построена для целочисленных выходных растров. Это значение по умолчанию.
  • DO_NOT_BUILDТаблица атрибутов растра не будет строиться для целочисленных выходных растров, если число уникальных значений больше или равно 65535. Если число уникальных значений меньше 65535, то будет построена таблица атрибутов растра.
Boolean

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

ИмяОписаниеТип данных
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: Да

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