Краткая информация
Сохраняет копию набора растровых данных или конвертирует набор данных мозаики в набор растровых данных.
Использование
Вы можете сохранить выходные данные в формат 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
Этот инструмент может использоваться для изменения битовой глубины пикселов. При изменении глубины пикселов растр будет отображаться без изменений, но его значения будут изменены в соответствии с заданной битовой глубиной.
Выходные данные для этого инструмента – всегда набор растровых данных. Инструмент может обрабатывать набор данных мозаики, но на выходе все равно будет создан набор растровых данных – содержание набора данных мозаики будет сложено для получения единого набора растровых данных.
Если вы отметили опцию Использовать файл привязки для определения координат растра в Опциях ArcMap, будет записан файл привязки. Если файл привязки уже существует, он будет перезаписан. В выходной пространственной привязке возможен сдвиг на полпиксела.
Чтобы игнорировать значения фона для растров персональной базы геоданных или отдельных файлов растров, значение Игнорировать значение фона должно быть таким же, как значение 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}, {format}, {transform})
Параметр | Объяснение | Тип данных |
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. Чтобы игнорировать значения фона для отдельных файлов растров и растров базы геоданных, значение Игнорировать значение фона должно быть тем же, что и 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 |
format (Дополнительный) | Формат выходного растра.
| String |
transform (Дополнительный) | Выберите, применять ли преобразование, связанное со входным растром, к выходному.
| Boolean |
Пример кода
Пример 1 функции CopyRaster (окно Python)
Это пример скрипта 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},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform})
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","","")
##Copy to cloud raster format
arcpy.CopyRaster_management("slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev", format="CRF", transform="Transform")
except:
print "Copy Raster example failed."
print arcpy.GetMessages()
CopyRaster, пример 2 (автономный скрипт)
Пример скрипта Python для инструмента CopyRaster.
##====================================
##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},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform})
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy to cloud raster format
arcpy.CopyRaster_management(
"slope_elev.tif", "https://s3.amazonaws.com/S3Storage/slope_elev",
format="CRF")
Параметры среды
- Сжатие (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
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да