Краткая информация
Создает пустой набор растровых данных.
Использование
Когда вы создаете набор растровых данных, вы создаете пустое местоположение, которое будет содержать один набор растровых данных. Затем вы можете составить мозаику или загрузить наборы растровых данных в это местоположение.
Вы можете сохранить выходные данные в формат 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}, {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 |
pyramid_origin (Дополнительный) | Точка привязки пирамидных слоев растра. Рекомендуется установить эту точку, если вы планируете построить большую мозаику в файловой или многопользовательской базе геоданных, особенно если вы планируете составлять для них мозаику с течением времени (например, для обновления). Точка привязки пирамидных слоёв соответствует верхнему левому углу набора растровых данных. Если Вы установили координаты точки привязки пирамидных слоев растра файловой или многопользовательской базы геоданных, то при обновлении растра (присоединении дополнительного растра при помощи мозаики) пирамидные слои будут строиться частично – только для нового участка растра. Частичные пирамидные слои, обновляющие части пирамидного слоя, которые не существуют из-за новых мозаичных наборов данных. Поэтому устанавливать точку привязки нужно с учетом того, что полная мозаика растра будет ниже и правее этой точки. Однако не следует устанавливать слишком большую точку привязки пирамидного слоя. | Point |
Пример кода
CreateRasterDataset, пример 1 (окно Python)
Это пример Python для инструмента CreateRasterDataset.
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 для инструмента CreateRasterDataset.
##==================================
##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)
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да