Сводка
Сохраняет копию набора растровых данных или конвертирует набор данных мозаики в набор растровых данных.
Использование
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, CRF, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, MRF, 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
- .mrf для MRF
- .crf для CRF
- Нет расширения для Esri Grid
Этот инструмент может использоваться для изменения битовой глубины пикселов. При изменении глубины пикселов растр будет отображаться без изменений, но его значения будут изменены в соответствии с заданной битовой глубиной.
Выходные данные для этого инструмента – всегда набор растровых данных. Инструмент может обрабатывать набор данных мозаики, но на выходе все равно будет создан набор растровых данных – из содержания набора данных мозаики будет создана мозаика для получения единого набора растровых данных.
Если вы отметили опцию Использовать файл привязки для определения координат растра в Опциях ArcMap, будет записан файл привязки. Если такой файл уже существует, он будет перезаписан. В выходной пространственной привязке возможен сдвиг на полпиксела.
Чтобы игнорировать значения фона для растров персональной базы геоданных или отдельных файлов растров, значение Игнорировать значение фона должно быть таким же, как значение NoData. Растры файловой базы геоданных и растры базы геоданных ArcSDE будут работать без этого дополнительного шага.
При хранении набора растровых данных в файле JPEG файле JPEG 2000 или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в Параметрах среды.
Формат GIF поддерживает только одноканальные наборы растровых данных.
Параметр Тип пиксела определяет битовую глубину выходного набора растровых данных. Если выбран другой тип пиксела, значения растра пересчитываются. Если выбран тип пиксела с меньшим диапазоном, значения растра, выходящие за пределы данного диапазона, будут потеряны. Более подробно о возможностях битовой глубины для поддерживаемых форматов экспорта, см. Поддерживаемые форматы файлов наборов растровых данных.
Синтаксис
arcpy.management.CopyRaster(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 | Набор растровых данных или набор данных мозаики, который вы хотите копировать. | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
out_rasterdataset | Имя и формат создаваемого набора данных.
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в файлах JPEG, JPEG 2000, TIFF или в базе геоданных, вы можете указать тип и качество сжатия. | Raster Dataset |
config_keyword (Дополнительный) | Определяет параметры хранения (конфигурации) для файловых или многопользовательских баз геоданных. Ключевые слова конфигурации устанавливаются администратором базы геоданных. | 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 |
Пример кода
CopyRaster, пример 1 (окно 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")
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да