Создать набор растровых данных (Create Raster Dataset) (Управление данными (Data Management))

Уровень лицензии:BasicStandardAdvanced

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

Создает набор растровых данных как файл или в базе геоданных.

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

Синтаксис

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

Название выходного набора растровых данных.

При сохранении набора растровых данных в формате файла, вы должны указать соответствующее расширение:

  • .bil – Esri BIL
  • .bip – Esri BIP
  • .bmp – BMP
  • .bsq – Esri BSQ
  • .dat – Envi Dat
  • .gif – GIF
  • .img – ERDAS IMAGINE
  • .jpg – JPEG
  • .jp2 – JPEG 2000
  • .png – PNG
  • .tif – TIFF
  • нет расширения для Esri Grid

При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно.

При хранении набора растровых данных в файле JPEG, файле JPEG 2000, файле TIFF или базе геоданных, вы можете указать тип и качество сжатия.

String
cellsize
(дополнительно)

Размер ячейки нового набора растровых данных.

Double
pixel_type

Задает тип данных значений ячеек. Значение по умолчанию - 8-битное целое без знака.

Не все форматы растров поддерживают любую глубину значений растра. Отметьте опцию Поддерживаемые файловые форматы наборов растровых данных, чтобы обеспечить, что используемый формат будет поддерживать нужный тип данных.

  • 1_BIT1-битовое целое число без знака. Значение может равняться 0 или 1.
  • 2_BIT2-битовое целое число без знака. Поддерживаются значения от 0 до 3.
  • 4_BIT4-битовое целое число без знака. Поддерживаются значения от 0 до 15.
  • 8_BIT_UNSIGNED8-битовый тип данных без знака. Поддерживаются значения от 0 до 255.
  • 8_BIT_SIGNED8-битовый тип данных со знаком. Поддерживаются значения от -128 до 127.
  • 16_BIT_UNSIGNED16-битовый тип данных без знака. Значения в диапазоне от 0 до 65,535.
  • 16_BIT_SIGNED16-битовый тип данных со знаком. Значения находятся в диапазоне от -32.768 до 32.767.
  • 32_BIT_UNSIGNED32-битовый тип данных без знака. Значения в диапазоне от 0 до 4,294,967,295.
  • 32_BIT_SIGNED32-битовый тип данных со знаком. Значения находятся в диапазоне от -2.147.483.648 до 2.147.483.647.
  • 32_BIT_FLOAT32-битовый тип данных с поддержкой десятичных знаков.
  • 64_BIT64-битовый тип данных с поддержкой десятичных знаков.
String
raster_spatial_reference
(дополнительно)

Система координат набора растровых данных.

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

Coordinate System
number_of_bands

Количество цветовых каналов в наборе растровых данных.

Long
config_keyword
(дополнительно)

Определяет параметры хранения (конфигурации) для файловых или ArcSDE баз геоданных. Персональные базы геоданных не используют ключевые слова конфигурации.

Ключевые слова конфигурации ArcSDE устанавливаются администратором базы геоданных.

String
pyramids
(дополнительно)

Укажите, строить ли пирамидные слои.

Для уровней пирамидных слоев выберите число -1 и больше. Если значение равно 0, пирамидные слои не будут построены, если значение равно -1, автоматически будет выбрано корректное число уровней пирамидных слоев, которые будут созданы.

Метод пересчета пирамидных слоев определяет, как данные будут пересчитаны при построении пирамидных слоев.

  • NEAREST – используется метод ближайшего соседа для номинальных данных или наборов растровых данных с цветовыми схемами, например данные по землепользованию или изображения в псевдоцветах.
  • BILINEAR – Метод билинейной интерполяции лучше всего подходит для непрерывных данных, таких как спутниковые снимки или аэрофотоснимки.
  • CUBIC – Метод кубической свертки также используется для непрерывных данных, таких как спутниковые снимки или аэрофотоснимки. Метод подобен методу билинейной интерполяции, но для пересчета используется большее количество ячеек.

Тип сжатия пирамид определяет метод, который используется при сжатии пирамидных слоев.

  • DEFAULT – Использует сжатие, которое обычно используется форматом набора растровых данных.
  • LZ77 – Сжатие без потерь. Значения ячеек в растре не будут изменяться.
  • JPEG – Сжатие с потерями.
  • NONE – Сжатие данных не производится.
Pyramid
tile_size
(дополнительно)

Ширина листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси x. По умолчанию значение ширины листа равно 128.

Высота листа определяет количество пикселов, которые будут храниться в каждом листе. Укажите количество пикселов по оси y. По умолчанию значение высоты листа равно 128.

Только файловые или ArcSDE базы геоданных поддерживают данный параметр.

Tile Size
compression
(дополнительно)

Тип сжатия определяет метод сжатия данных, который будет использован для хранения наборов растровых данных.

  • LZ77Без потерь.
  • JPEGС потерями. Использует настройки качества сжатия.
  • JPEG 2000С потерями. Использует настройки качества сжатия.
  • PackBitsБез потерь. Только для формата TIFF.
  • LZWБез потерь.
  • RLEБез потерь.
  • CCITT GROUP 3Без потерь. Только для формата TIFF.
  • CCITT GROUP 4Без потерь. Только для формата TIFF.
  • CCITT (1D)Без потерь. Только для формата TIFF.
  • НетБез сжатия данных.

Качество сжатия JPEG и JPEG 2000 может варьироваться от 1 до 100. Чем больше число – тем лучше качество изображения, но меньше сжатие.

Compression
pyramid_origin
(дополнительно)

Исходная точка для пирамидных слоев растра. Рекомендуется установить эту точку, если вы планируете построить большую мозаику в файловой базе геоданных или базе геоданных ArcSDE, особенно если вы планируете составлять для них мозаику с течением времени (например, для обновления).

Точка привязки пирамидных слоёв соответствует верхнему левому углу набора растровых данных.

Если Вы установили координаты точки привязки пирамиды растра файловой или ArcSDE базы геоданных, то при обновлении растра (присоединении дополнительного растра при помощи мозаики) пирамидные слои будут строиться частично – только для нового участка растра. Частичные пирамидные слои, обновляющие части пирамидного слоя, которые не существуют из-за новых мозаичных наборов данных. Поэтому устанавливать точку привязки пирамиды нужно с учетом того, что полная мозаика растра будет ниже и правее этой точки. Однако, не следует устанавливать слишком большую точку привязки пирамидного слоя.

Point

Пример кода

Создать набор растровых данных. Пример 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", "")
Создать набор растровых данных. Пример 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}
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()

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

Связанные темы

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

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014