Копировать растр (Copy Raster) (Управление данными)

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

Резюме

Создает копию набора растровых данных, загружает наборы растровых данных в каталог растров или конвертирует набор данных мозаики в набор растровых данных.

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

Синтаксис

CopyRaster_management (in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap})
ПараметрОбъяснениеТип данных
in_raster

Имя и местоположение копируемого набора растровых данных.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
out_rasterdataset

Имя и местоположение создаваемого набора растровых данных.

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

  • .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 или базе геоданных, вы можете указать тип и качество сжатия.

Raster Dataset; Raster Catalog
config_keyword
(дополнительно)

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

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

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

Используйте эту опцию для удаления нежелательных значений, созданных вокруг растровых данных. Указанное значение будет отделено от остальных значений набора растровых данных. Например, значение 0 по границам набора растровых данных будет отделено от значения 0 внутри набора растровых данных.

Указанное значение элемента растра будет записано в выходной набор растровых данных как NoData (Нет Данных).

Чтобы игнорировать значения фона для растров персональной базы геоданных или отдельных файловых растров, значение Игнорировать значение фона должно быть установлено на то же значение, что и NoData. Растры ArcSDE и файловой базы геоданных будут работать без этого дополнительного шага.

Double
nodata_value
(дополнительно)

Все элементы растра с указанными значениями будут записаны в выходной набор растровых данных как NoData (Нет Данных).

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

Входной 1-битный набор растровых данных может быть конвертирован в 8-битный набор растровых данных. В этой конвертации значение 1 во входном наборе растровых данных поменяется на 255 в выходном наборе растровых данных. Это полезно при импорте 1-битного набора растровых данных в ArcSDE. 1-битовый набор растровых данных имеет 8-битовые пирамидные слои при хранении в файловой системе, но в ArcSDE 1-битовый набор растровых данных может иметь только 1-битовый пирамидный слой, что делает отображение непривлекательным. Конвертируя данные в 8 бит в ArcSDE, пирамидные слои строятся, как 8 бит вместо 1 бит, что приведет к нормальному отображению набора растровых данных.

  • Нет сжатия (NONE) —Конвертация не будет выполняться. Это значение используется по умолчанию.
  • ОдинБит-в-8Бит (OneBitTo8Bit) —Входной растр будет конвертирован.
Boolean
colormap_to_RGB
(дополнительно)

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

  • Нет сжатия (NONE) —Не произойдет никакой конвертации. Это значение используется по умолчанию.
  • Цветовая карта в RGB (ColormapToRGB) —Входной набор данных будет конвертирован.
Boolean
pixel_type
(дополнительно)

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

Тем не менее, если выбран тип пиксела, отличный от типа пиксела входного класса, значения ячеек не пересчитываются. Если выбран тип пиксела с меньшим диапазоном, значения растра, выходящие за пределы данного диапазона, будут потеряны.

  • 1_BIT —1-битовое целое число без знака. Значение может равняться 0 или 1.
  • 2_BIT —2-битовое целое число без знака. Поддерживаются значения от 0 до 3.
  • 4_BIT —4-битовое целое число без знака. Поддерживаются значения от 0 до 15.
  • 8_BIT_UNSIGNED —8-битовый тип данных без знака. Поддерживаются значения от 0 до 255.
  • 8_BIT_SIGNED —8-битовый тип данных со знаком. Поддерживаются значения от -128 до 127.
  • 16_BIT_UNSIGNED —16-битовый тип данных без знака. Значения в диапазоне от 0 до 65,535.
  • 16_BIT_SIGNED —16-битовый тип данных со знаком. Значения находятся в диапазоне от -32.768 до 32.767.
  • 32_BIT_UNSIGNED —32-битовый тип данных без знака. Значения в диапазоне от 0 до 4,294,967,295.
  • 32_BIT_SIGNED —32-битовый тип данных со знаком. Значения находятся в диапазоне от -2.147.483.648 до 2.147.483.647.
  • 32_BIT_FLOAT —32-битовый тип данных с поддержкой десятичных знаков.
  • 64_BIT —64-битовый тип данных с поддержкой десятичных знаков.
String
scale_pixel_value
(дополнительно)

Если тип пикселов в выходных данных отличается от входных (например, 16 бит и 8 бит) можно использовать подгонку значений к новому диапазону; иначе, значения, не укладывающиеся в новый диапазон, будут отброшены.

Если битовая глубина повышается, например, 8 бит конвертируется в 16 бит, минимальное и максимальное 8-битовые значения конвертируются в минимум и максимум в 16-битном диапазоне. Если битовая глубина понижается, например, 16 бит конвертируется в 8 бит, минимальное и максимальное 16-битовые значения конвертируются в минимум и максимум в 8-битном диапазоне.

  • NONE —Значения пикселов не меняются и не масштабируются. Все значения, не укладывающиеся в диапазон, будут отброшены. Это значение используется по умолчанию.
  • ScalePixelValue —Значения пикселов будут изменены в соответствии с заданным типом пикселов. При изменении глубины пикселов растр будет отображаться без изменений, но его значения будут изменены в соответствии с заданной битовой глубиной.
Boolean
RGB_to_Colormap
(дополнительно)

Можно конвертировать 8-битовый, 3-канальный (RGB) набор растровых данных в одноканальный растр с цветовой картой.

Эта операция позволяет подавить цветовой шум, который часто присутствует на сканированных изображениях, с помощью изучения статистики набора растровых данных и классификации значений в 255 квантилей.

Этот метод очень хорошо подходит для изображений, захваченных с экрана, сканированных карт или документов. Однако, его не рекомендуется использовать для спутниковых и аэрофотоснимков, или для тематических растровых данных.

  • NONE —Выходные данные остаются трехканальными (RGB). Конвертация к цветовой карте не выполняется. Это значение используется по умолчанию.
  • RGBToColormap —Создается одноканальный растр с цветовой картой, использующей 255 цветов.
Boolean

Пример кода

CopyRaster пример 1 (окно Python)

Это пример скрипта Python для CopyRaster.

import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
                           "c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
                           "0","9","","","8_BIT_UNSIGNED")
CopyRaster пример 2 (автономный скрипт)

Пример скрипта Python для CopyRaster.

##====================================
##Copy Raster
##Usage: CopyRaster_management in_raster out_rasterdataset {config_keyword} {background_value} {nodata_value} {NONE | OneBitTo8Bit} 
##                             {NONE | ColormapToRGB} {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED 
##                             | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
try:
    import arcpy
    arcpy.env.workspace = r"C:\PrjWorkspace"
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
    ##Copy 1 BIT 
    arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()

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

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

Обзор группы инструментов Растр (Raster)
Параметры среды для растровых данных
Поддерживаемые форматы файлов наборов растровых данных

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

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
Информация об авторском праве © Esri, 1995-2013. Все права защищены.
9/10/2013