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

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

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

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

Иллюстрация

OutRas = CreateConstantRaster(2)

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

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

• Постоянное значение должно быть представлено числом. Допустимо использовать общепринятые научные обозначения (например 3.048e-4 для 0.003048).

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Постоянное значение	Постоянное значение, которое будет присвоено всем ячейкам выходного растра.	Double
Тип выходных данных (Дополнительный)	Тип данных выходного набора растровых данных. Если указан тип данных с плавающей точкой, значения ячеек в выходном растре будут иметь точность только до постоянного значения 7 знаков после запятой, независимо от выходного формата. Integer—Будет создан целочисленный набор растровых данных. Float—Будет создан растр с плавающей точкой.	String
Размер выходной ячейки (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
Выходной экстент (Дополнительный)	Экстент выходного набора растровых данных. Экстентом будет значение, устанавливаемое в параметрах среды. Если специально не установлено, то используются значения по умолчанию 0, 0, 250, 250.	Envelope; Extent

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр, для которого каждая ячейка будет иметь заданное константное значение.	Raster

Python

CreateConstantRaster(constant_value, {data_type}, {cell_size}, {extent})

Имя	Описание	Тип данных
constant_value	Постоянное значение, которое будет присвоено всем ячейкам выходного растра.	Double
data_type (Дополнительный)	Тип данных выходного набора растровых данных. INTEGER—Будет создан целочисленный набор растровых данных. FLOAT—Будет создан растр с плавающей точкой. Если указан тип данных с плавающей точкой, значения ячеек в выходном растре будут иметь точность только до постоянного значения 7 знаков после запятой, независимо от выходного формата.	String
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	Выходной растр, для которого каждая ячейка будет иметь заданное константное значение.	Raster

Пример кода

Создать константный растр. Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outConstRaster = CreateConstantRaster(12.7, "FLOAT", 2, Extent(0, 0, 250, 250))
outConstRaster.save("C:/sapyexamples/output/outconst2")

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

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

# Name: CreateConstantRaster_Ex_02.py
# Description: Creates a raster from a constant value
# Requirements: Spatial Analyst Extension

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

# Set local variables
constantValue = 12
cellSize = 2
outExtent = Extent(0, 0, 250, 250)

# Execute CreateConstantRaster
outConstRaster = CreateConstantRaster(constantValue, "FLOAT", cellSize,
                                      outExtent)

# Save the output 
outConstRaster.save("C:/sapyexamples/output/outconst")

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

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

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

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