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

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

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

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

Иллюстрация

Иллюстрация инструмента Создать нормальный растр
OutRas = CreateNormalRaster(1, 0 0 4 4)
Примечание: Выходные данные являются представительными. Фактические значения будут разными при каждом выполнении инструмента.

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

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

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

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

  • Для выходных значений среднее будет составлять 0.0, а среднеквадратическое отклонение - 1.0. Если вы предполагаете другое значение среднеквадратического отклонения, умножьте выходной растр на это значение. Если вы предполагаете другое значение среднего, прибавьте к выходному растру это значение. Например, чтобы создать нормальный растр, среднее значение для ячеек которого было бы равно 39, а среднеквадратическое отклонение - 2.5, умножьте результат инструмента Создать нормальный растр на 2.5, затем добавьте 39.

    • В Алгебре карт это можно сделать, например, следующим образом:

      import arcpy
      from arcpy import env
      from arcpy.sa import *
      env.workspace = "C:/data"
      outNorm = CreateNormalRaster(1, Extent(0, 0, 100, 100)) * 2.5 + 39
      outNorm.save("C:/output/norm2")

  • Генератор случайных чисел автоматически использует текущее значение системных часов (количество секунд, начиная с 1 января 1970 года). Повторная инициализация инструмента Создать произвольный растр также повторно инициализирует инструмент Создать нормальный растр.

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

Envelope; Extent

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

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

Выходной растр значений, соответствующих нормальному распределению, со средним 0.0, и среднеквадратическим отклонением - 1.0.

Raster

CreateNormalRaster({cell_size}, {extent})
ИмяОписаниеТип данных
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

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNormalRaster = CreateNormalRaster(2, Extent(0, 0, 150, 150))
outNormalRaster.save("C:/sapyexamples/output/outnormal")
CreateNormalRaster, пример 2 (автономный скрипт)

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

# Name: CreateNormalRaster_Ex_02.py
# Description: Creates a raster of random values from a normal distribution
# 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
cellSize = 2
extent = Extent(0, 0, 150, 150)

# Execute CreateNormalRaster
outNormalRaster = CreateNormalRaster(cellSize, extent) 

# Save the output 
outNormalRaster.save("C:/sapyexamples/output/outnormraster")

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

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

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