Создать произвольный растр (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 года). Диапазон допустимых значений для начального значения от -231+1 до 231 (или от -2.147.483.647 до 2.147.483.648).

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

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

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

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

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

Экстентом будет значение, устанавливаемое в параметрах среды. Если специально не установлено, то используются значения по умолчанию 0, 0, 250, 250.

Envelope; Extent

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

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

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

Raster

CreateRandomRaster({seed_value}, {cell_size}, {extent})
ИмяОписаниеТип данных
seed_value
(Дополнительный)

Начальное значение, используемое генератором случайных чисел.

Это может быть целое или с плавающей точкой число. Не допускается использование растров как входных данных.

Генератор случайных чисел автоматически использует текущее значение системных часов (количество секунд, начиная с 1 января 1970 года). Диапазон допустимых значений для начального значения от -231+1 до 231 (или от -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")

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

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

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