Сводка
Сохраняет копию набора растровых данных или конвертирует набор данных мозаики в набор растровых данных.
Использование
Вы можете сохранить выходные данные в формат 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
Этот инструмент можно использовать для масштабирования типа пиксела от одной битовой глубины до другой. Когда вы масштабируете глубину пикселов, ваш растр будет отображаться так же, но значения будут масштабированы до новой указанной битовой глубины.
Выходные данные для этого инструмента – всегда набор растровых данных. Этот инструмент будет принимать набор данных мозаики в качестве входных данных, но на выходе будет набор растровых данных - содержимое набора данных мозаики будет разбито на мозаику для создания набора растровых данных.
Если вы отметили опцию Использовать файл привязки для определения координат растра в Опциях, будет записан файл привязки. Если файл привязки существует, он будет перезаписан. В выходной пространственной привязке возможен сдвиг на полпиксела.
Чтобы игнорировать значения фона для отдельных файлов растров, значение Игнорировать значение фона должно быть тем же, что и NoData. Растры файловой базы геоданных и растры базы геоданных ArcSDE будут работать без этого дополнительного шага.
При хранении набора растровых данных в файле JPEG файле JPEG 2000 или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в Параметрах среды.
Формат GIF поддерживает только одноканальные наборы растровых данных.
Параметр Тип пиксела определяет битовую глубину выходного набора растровых данных. Если выбран другой тип пиксела, значения растра пересчитываются. Если выбран тип пиксела с меньшим диапазоном, значения растра, выходящие за пределы данного диапазона, будут потеряны. Более подробно о возможностях битовой глубины для поддерживаемых форматов экспорта см. Список поддерживаемых сенсоров.
Параметр Построить многомерное транспонирование применяется для оптимизации доступа к данным. По умолчанию файл CRF хранит каждый многомерный срез в отдельной папке, а каждый срез разбивается на листы. При выполнении транспонирования данные будут разбиваться по размеру, а не по срезам или листам, что ускоряет и упрощает проведение такого анализа, как временное профилирование.
Когда вы указываете экстент за пределами набора растровых данных, область, не содержащая данных, заполняется значениями NoData.
Синтаксис
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}, {process_as_multidimensional}, {build_multidimensional_transpose})| Parameter | Объяснение | Тип данных |
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 |
process_as_multidimensional (Дополнительный) | Устанавливает, будет ли выполняться обработка входного набора данных мозаики как набора многомерных растровых данных.
| Boolean |
build_multidimensional_transpose (Дополнительный) | Устанавливает, следует ли создавать транспонирование для входного набора многомерных растровых данных с разбивкой этих данных по размеру с целью оптимизации производительности при доступе к значениям пикселов во всех срезах.
| Boolean |
Пример кода
Пример скрипта 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}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy Multidimensional Raster Dataset to a new multidimensional dataset in Cloud raster format and with transpose for faster data access
arcpy.CopyRaster_management('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
##Copy 1 BIT
arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
##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")
except:
print "Copy Raster example failed."
print arcpy.GetMessages()Это пример скрипта 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}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy to new multidimensional dataset in cloud raster format and with transpose for faster data access
arcpy.CopyRaster_management(
"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да