Создать набор растровых данных (Create Raster Dataset) (Управление данными (Data Management))
Краткая информация
Создает набор растровых данных как файл или в базе геоданных.
Использование
-
Когда вы создаете набор растровых данных, вы создаете пустое местоположение, которое будет содержать один набор растровых данных. Затем вы можете составить мозаику или загрузить наборы растровых данных в это местоположение.
-
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF или набор растровых данных любой базы геоданных.
-
При хранении набора растровых данных в файле JPEG, файле JPEG 2000 или базе геоданных, вы можете указать тип Сжатия (Compression) и Качество сжатия (Compression Quality) в настройках Параметров среды.
-
Формат GIF поддерживает только одноканальные наборы растровых данных.
-
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных.
-
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
Синтаксис
| Параметр | Объяснение | Тип данных |
out_path |
Выходное местоположение, которое будет содержать набор растровых данных. | Workspace; Raster Catalog |
out_name |
Название выходного набора растровых данных. При сохранении набора растровых данных в формате файла, вы должны указать соответствующее расширение:
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в файле JPEG, файле JPEG 2000, файле TIFF или базе геоданных, вы можете указать тип и качество сжатия. | String |
cellsize (дополнительно) |
Размер ячейки нового набора растровых данных. | Double |
pixel_type |
Задает тип данных значений ячеек. Значение по умолчанию - 8-битное целое без знака. Не все форматы растров поддерживают любую глубину значений растра. Отметьте опцию Поддерживаемые файловые форматы наборов растровых данных, чтобы обеспечить, что используемый формат будет поддерживать нужный тип данных.
| String |
raster_spatial_reference (дополнительно) |
Система координат набора растровых данных. Если система координат не задана, то будет использоваться система координат, установленная в параметрах среды. | Coordinate System |
number_of_bands |
Количество цветовых каналов в наборе растровых данных. | Long |
config_keyword (дополнительно) |
Определяет параметры хранения (конфигурации) для файловых или ArcSDE баз геоданных. Персональные базы геоданных не используют ключевые слова конфигурации. Ключевые слова конфигурации ArcSDE устанавливаются администратором базы геоданных. | String |
pyramids (дополнительно) |
Укажите, строить ли пирамидные слои. Для уровней пирамидных слоев выберите число -1 и больше. Если значение равно 0, пирамидные слои не будут построены, если значение равно -1, автоматически будет выбрано корректное число уровней пирамидных слоев, которые будут созданы. Метод пересчета пирамидных слоев определяет, как данные будут пересчитаны при построении пирамидных слоев.
Тип сжатия пирамид определяет метод, который используется при сжатии пирамидных слоев.
| Pyramid |
tile_size (дополнительно) |
Ширина листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси x. По умолчанию значение ширины листа равно 128. Высота листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси y. По умолчанию значение высоты листа равно 128. Только файловые или ArcSDE базы геоданных поддерживают данный параметр. | Tile Size |
compression (дополнительно) |
Тип сжатия определяет метод сжатия данных, который будет использован для хранения наборов растровых данных.
Качество сжатия JPEG и JPEG 2000 может варьироваться от 1 до 100. Чем больше число – тем лучше качество изображения, но меньше сжатие. | Compression |
pyramid_origin (дополнительно) |
Исходная точка для пирамидных слоев растра. Рекомендуется установить эту точку, если вы планируете построить большую мозаику в файловой базе геоданных или базе геоданных ArcSDE, особенно если вы планируете составлять для них мозаику с течением времени (например, для обновления). Точка привязки пирамидных слоёв соответствует верхнему левому углу набора растровых данных. Если Вы установили координаты точки привязки пирамиды растра файловой или ArcSDE базы геоданных, то при обновлении растра (присоединении дополнительного растра при помощи мозаики) пирамидные слои будут строиться частично – только для нового участка растра. Частичные пирамидные слои, обновляющие части пирамидного слоя, которые не существуют из-за новых мозаичных наборов данных. Поэтому устанавливать точку привязки пирамиды нужно с учетом того, что полная мозаика растра будет ниже и правее этой точки. Однако, не следует устанавливать слишком большую точку привязки пирамидного слоя. | Point |
Пример кода
Это пример Python для инструмента Создать набор растровых данных (Create Raster Dataset).
import arcpy
arcpy.CreateRasterDataset_management("c:/data", "EmptyTIFF.tif", "2",
"8_BIT_UNSIGNED", "World_Mercator.prj",
"3", "", "PYRAMIDS -1 NEAREST JPEG",
"128 128", "NONE", "")
Это пример скрипта Python для инструмента Создать набор растровых данных (Create Raster Dataset).
##==================================
##Create Raster Dataset
##Usage: CreateRasterDataset_management out_path out_name {cellsize} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED
## | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT
## | 64_BIT {raster_spatial_reference} number_of_bands {config_keyword} {pyramids} {tile_size}
## {compression} {pyramid_origin}
try:
import arcpy
arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
##Create a empty TIFF format Raster Dataset with the following parameters
##Cellsize: 2
##Pixel type: 8 Bit Unsigned Integer
##Number of Bands: 3
##Pyramid: Build full pyramids with NEAREST interpolation and JPEG compression
##Compression: NONE
##Projection: World_Mercator
##Tile size: 128 128
arcpy.CreateRasterDataset_management("CreateRD","EmptyTIFF.tif","2","8_BIT_UNSIGNED",\
"World_Mercator.prj", "3", "", "PYRAMIDS -1 NEAREST JPEG",\
"128 128", "NONE", "")
##Create a SDE Raster Dataset
##No Spatial Reference, with Pyramid Origin
arcpy.CreateRasterDataset_management("CreateRD\\CreateRD.gdb","NewRD","10","16_BIT_UNSIGNED",\
"", "1", "MAX_FILE_SIZE_4GB", "PYRAMIDS 3 BILINEAR DEFAULT",\
"128 128", "JPEG2000 80", "-20037508.34278775 30198185.16987658")
except:
print "Create Raster Dataset example failed."
print arcpy.GetMessages()