Сводка
Создает пустой набор растровых данных.
Использование
Когда вы создаете набор растровых данных, вы создаете пустое местоположение, которое будет содержать один набор растровых данных. Затем вы можете составить мозаику или загрузить наборы растровых данных в это местоположение.
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF или набор растровых данных любой базы геоданных.
При хранении набора растровых данных в файле JPEG файле JPEG 2000 или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в Параметрах среды.
Формат GIF поддерживает только одноканальные наборы растровых данных.
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных.
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
Синтаксис
arcpy.management.CreateRasterDataset(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 (Дополнительный) | Задает тип сжатия для хранения набора растровых данных.
| Compression |
pyramid_origin (Дополнительный) | Исходная точка для пирамидных слоев растра. Рекомендуется установить эту точку, если вы планируете построить большую мозаику в файловой или многопользовательской базе геоданных, особенно если вы планируете составлять для них мозаику с течением времени (например, для обновления). Точка привязки пирамидных слоёв соответствует верхнему левому углу набора растровых данных. Если Вы установили координаты точки привязки пирамидных слоев растра файловой или многопользовательской базы геоданных, то при обновлении растра (присоединении дополнительного растра при помощи мозаики) пирамидные слои будут строиться частично – только для нового участка растра. Частичные пирамидные слои, обновляющие части пирамидного слоя, которые не существуют из-за новых мозаичных наборов данных. Поэтому устанавливать точку привязки пирамиды желательно с учетом того, что полная мозаика растра будет ниже и правее этой точки. Однако не следует устанавливать слишком большую точку привязки пирамидного слоя. | Point |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_raster_dataset | Выходной набор растровых данных. | Raster Dataset |
Пример кода
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")
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да