Краткая информация
Сохраняет копию набора растровых данных или конвертирует набор данных мозаики в набор растровых данных.
Использование
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF или набор растровых данных любой базы геоданных.
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При сохранении набора растровых данных в формате файла, вы должны указать соответствующее расширение:
- .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
Этот инструмент может использоваться для изменения битовой глубины пикселов. При изменении глубины пикселов растр будет отображаться без изменений, но его значения будут изменены в соответствии с заданной битовой глубиной.
Выходные данные для этого инструмента – всегда набор растровых данных. Инструмент может обрабатывать набор данных мозаики, но на выходе все равно будет создан набор растровых данных – содержание набора данных мозаики будет сложено для получения единого набора растровых данных.
Если вы отметили опцию Использовать файл привязки для определения координат растра (Use world file to define the coordinates of the raster) в Опциях ArcMap (ArcMap Options), будет записан файл привязки. Если файл привязки уже существует, он будет перезаписан. В выходной пространственной привязке возможен сдвиг на полпиксела.
Чтобы игнорировать значения фона для растров персональной базы геоданных или отдельных файлов растров, значение Игнорировать значение фона (Ignore Background Value) должно быть таким же, как значение NoData (Нет данных). Растры файловой базы геоданных и растры базы геоданных ArcSDE будут работать без этого дополнительного шага.
При хранении набора растровых данных в файле JPEG, файле JPEG 2000 или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в настройках Параметров среды.
Формат GIF поддерживает только одноканальные наборы растровых данных.
Параметр Тип пиксела определяет битовую глубину выходного набора растровых данных. Если выбран другой тип пиксела, значения растра пересчитываются. Если выбран тип пиксела с меньшим диапазоном, значения растра, выходящие за пределы данного диапазона, будут потеряны. Более подробно о возможностях битовой глубины для поддерживаемых форматов экспорта см. Поддерживаемые форматы файлов наборов растровых данных.
Синтаксис
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 | Имя и формат создаваемого набора данных.
При сохранении набора растровых данных в базе геоданных не требуется вводить расширение файла для имени набора растровых данных. При хранении набора растровых данных в файле JPEG, файле JPEG 2000, файле TIFF или базе геоданных, вы можете указать тип и качество сжатия. | Raster Dataset |
config_keyword (дополнительно) | Определяет параметры хранения (конфигурации) для файловых или ArcSDE баз геоданных. Ключевые слова конфигурации устанавливаются администратором базы геоданных. | String |
background_value (дополнительно) | Используйте эту опцию для удаления нежелательных значений, созданных вокруг растровых данных. Указанное значение будет отделено от остальных значений набора растровых данных. Например, значение 0 по границам набора растровых данных будет отделено от значения 0 внутри набора растровых данных. Указанное значение элемента растра будет записано в выходной набор растровых данных как NoData (Нет Данных). Чтобы игнорировать значения фона для отдельных файлов растров и растров базы геоданных, значение Игнорировать значение фона (Ignore Background Value) должно быть тем же, что и NoData. Растры многопользовательской базы и базы геоданных будут работать без этого дополнительного шага. | Double |
nodata_value (дополнительно) | Все элементы растра с указанными значениями будут записаны в выходной набор растровых данных как NoData. | String |
onebit_to_eightbit (дополнительно) | Выберите, будет ли входной 1-битный набор растровых данных конвертирован в 8-битный набор растровых данных. В этой конвертации значение 1 во входном наборе растровых данных поменяется на 255 в выходном наборе растровых данных. Это подходит при импорте 1-битного набора растровых данных в базу геоданных. 1-битовый набор растровых данных имеет 8-битовые пирамидные слои при хранении в файловой системе, но в базе геоданных 1-битовый набор растровых данных может иметь только 1-битовый пирамидный слой, что делает отображение непривлекательным. При конвертации данных в 8-битовые в базе геоданных пирамидные слои строятся как 8-битовые вместо 1-битовых, что приведет к нормальному отображению набора растровых данных.
| Boolean |
colormap_to_RGB (дополнительно) | Если входной набор растровых данных имеет цветовую карту, выходной набор растровых данных может быть конвертирован в трехканальный выходной набор растровых данных. Это полезно при создании мозаики из растров с разными цветовыми картами.
| Boolean |
pixel_type (дополнительно) | Укажите глубину цвета в битах (радиометрическое разрешение) растра или набора данных мозаики. Если она не указана, будет взято соответствующее значение первого растрового набора.
| String |
scale_pixel_value (дополнительно) | Если тип пикселов в выходных данных отличается от входных (например, 16 бит и 8 бит) можно использовать подгонку значений к новому диапазону; иначе, значения, не укладывающиеся в новый диапазон, будут отброшены. Если битовая глубина повышается, например, 8 бит конвертируется в 16 бит, минимальное и максимальное 8-битовые значения конвертируются в минимум и максимум в 16-битном диапазоне. Если битовая глубина понижается, например, 16 бит конвертируется в 8 бит, минимальное и максимальное 16-битовые значения конвертируются в минимум и максимум в 8-битном диапазоне.
| Boolean |
RGB_to_Colormap (дополнительно) | Конвертирует 8-битовый, 3-канальный (RGB) набор растровых данных в одноканальный растр с цветовой картой. Эта операция уменьшает шум, который нередко присутствует в отсканированных изображениях и идеально подходит для экранных снимков, отсканированных карт или отсканированных документов. Однако, его не рекомендуется использовать для спутниковых и аэрофотоснимков, или для тематических растровых данных.
| 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}
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","","")
Параметры среды
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Пирамидные слои (Pyramid)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Географические преобразования (Geographic Transformations)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)
- Метод интерполяции (Resampling Method)
- NoData