Создать произвольный растр (Spatial Analyst)

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

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

Создает растр случайных значений с плавающей запятой в диапазоне от 0,0 до 1,0 в пределах экстента и размера ячейки окна анализа.

Инструмент Создать произвольный растр в группе инструментов Управление данными предоставляет улучшенную функциональность или производительность.

Иллюстрация

OutRas = CreateRandomRaster()

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

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

  Примечание:

  Значения, показанные на рисунке выше, являются репрезентативными. Фактические значения будут разными при каждом запуске инструмента.

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

• Значения ячеек будут иметь точность до 7 цифр после запятой.

• Многократное использование начального значения или значения по умолчанию не дает возможности создать такой растр.

• Вы можете изменить начальный объект с помощью параметра для получения разных начальных точек для генератора произвольных чисел.

• Для генерации значений используется алгоритм ACM генератора 599 случайных чисел.

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

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

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

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

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

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

• См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Диалог

Подпись	Описание	Тип данных
Начальное значение (Дополнительный)	Начальное значение, используемое генератором случайных чисел. Это может быть целое или с плавающей точкой число. Не допускается использование растров как входных данных. Генератор случайных чисел автоматически использует текущее значение системных часов (количество секунд, начиная с 1 января 1970 года). Диапазон допустимых значений для начального значения от -2^31+1 до 2^31 (или от -2.147.483.647 до 2.147.483.648).	Double
Размер выходной ячейки (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
Выходной экстент (Дополнительный)	Экстент выходного набора растровых данных. Экстентом будет значение параметра среды, если оно было специально задано. Если оно специально не было задано, то значением по умолчанию будет 0, 0, 250, 250.	Envelope; Extent

Возвращаемое значение

Подпись	Описание	Тип данных
Выходной растр	Выходной растр произвольно распределенных значений с диапазоном от 0,0 до 1,0	Raster

Python

CreateRandomRaster({seed_value}, {cell_size}, {extent})

Имя	Описание	Тип данных
seed_value (Дополнительный)	Начальное значение, используемое генератором случайных чисел. Это может быть целое или с плавающей точкой число. Не допускается использование растров как входных данных. Генератор случайных чисел автоматически использует текущее значение системных часов (количество секунд, начиная с 1 января 1970 года). Диапазон допустимых значений для начального значения от -2^31+1 до 2^31 (или от -2.147.483.647 до 2.147.483.648).	Double
cell_size (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
extent (Дополнительный)	Экстент выходного набора растровых данных. Extent относится к классу Python. В этом инструменте он представлен в виде Extent(XMin, YMin, XMax, YMax), где XMin и YMin определяют нижнюю левую координату экстента, а XMax и YMax определяют верхнюю правую координату. Координаты указываются в тех же единицах измерения карты, что и в настройках параметров среды Выходная система координат. Экстентом будет значение параметра среды, если оно было специально задано. Если оно специально не было задано, то значением по умолчанию будет 0, 0, 250, 250.	Envelope; Extent

Возвращаемое значение

Имя	Описание	Тип данных
out_raster	Выходной растр произвольно распределенных значений с диапазоном от 0,0 до 1,0	Raster

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRandRaster = CreateRandomRaster(100, 2, Extent(0, 0, 150, 150))
outRandRaster.save("C:/sapyexamples/output/outrandom")

CreateRandomRaster, пример 2 (автономный скрипт)

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

# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a raster of random floating point values
#              between 0 and 1
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
seedValue = 1
cellSize = 2
extent = Extent(0, 0, 150, 150)

# Execute CreateRandomRaster
outRandomRaster = CreateRandomRaster(seedValue, cellSize, extent) 

# Save the output 
outRandomRaster.save("C:/sapyexamples/output/outrand")

Параметры среды

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

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

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst