Краткая информация
Создает пустой набор растровых данных.
Использование
Когда вы создаете набор растровых данных, вы создаете пустое местоположение, которое будет содержать один набор растровых данных. Затем вы можете составить мозаику или загрузить наборы растровых данных в это местоположение.
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF или набор растровых данных любой базы геоданных.
При хранении набора растровых данных в файле JPEG, файле JPEG 2000 или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в настройках Параметров среды.
Формат GIF поддерживает только одноканальные наборы растровых данных.
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных.
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
Синтаксис
CreateRasterDataset_management (out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {compression}, {pyramid_origin})| Параметр | Объяснение | Тип данных |
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 баз геоданных. Ключевые слова конфигурации устанавливаются администратором базы геоданных. | String |
pyramids (дополнительно) | Укажите, строить ли пирамидные слои. Для уровней пирамидных слоев выберите число -1 и больше. Если значение равно 0, пирамидные слои не будут построены, если значение равно -1, автоматически будет выбрано корректное число уровней пирамидных слоев, которые будут созданы. Метод пересчета пирамидных слоев определяет, как данные будут пересчитаны при построении пирамидных слоев.
Тип сжатия пирамид определяет метод, который используется при сжатии пирамидных слоев.
| Pyramid |
tile_size (дополнительно) | Ширина листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси x. По умолчанию значение ширины листа равно 128. Высота листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси y. По умолчанию значение высоты листа равно 128. Размер листа используют только базы геоданных и многопользовательские базы геоданных. | Tile Size |
compression (дополнительно) | Определите тип сжатия для хранения набора растровых данных.
| String |
compression (дополнительно) | Тип сжатия определяет метод сжатия данных, который будет использован для хранения наборов растровых данных.
Качество сжатия JPEG и JPEG 2000 может варьироваться от 1 до 100. Чем больше число – тем лучше качество изображения, но меньше сжатие. | Compression |
pyramid_origin (дополнительно) | Исходная точка для пирамидных слоев растра. Рекомендуется установить эту точку, если вы планируете построить большую мозаику в файловой или многопользовательской базе геоданных, особенно если вы планируете составлять для них мозаику с течением времени (например, для обновления). Точка привязки пирамидных слоёв соответствует верхнему левому углу набора растровых данных. Если Вы установили координаты точки привязки пирамиды растра файловой или многопользовательской базы геоданных, то при обновлении растра (присоединении дополнительного растра при помощи мозаики) пирамидные слои будут строиться частично – только для нового участка растра. Частичные пирамидные слои, обновляющие части пирамидного слоя, которые не существуют из-за новых мозаичных наборов данных. Поэтому устанавливать точку привязки пирамиды нужно с учетом того, что полная мозаика растра будет ниже и правее этой точки. Однако, не следует устанавливать слишком большую точку привязки пирамидного слоя. | Point |
Пример кода
CreateRasterDataset, пример 1 (окно Python)
Это пример 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", "")
CreateRasterDataset, пример 2 (автономный скрипт)
Это пример скрипта 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}
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")
Параметры среды
- Текущая рабочая область (Current Workspace)
- Временная рабочая область (Scratch Workspace)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Растр привязки (Snap Raster)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Размер ячейки (Cell size)
- Пирамидные слои (Pyramid)
- Статистика растра (Raster Statistics)
- Сжатие (Compression)
- Размер листа (Tile Size)