Подпись | Описание | Тип данных |
Входной растр | Набор растровых данных или набор данных мозаики для копирования. | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
Выходной набор растровых данных | Имя и формат создаваемого набора растровых данных.
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в формате JPEG, JPEG 2000, TIFF или в базе геоданных, вы можете указать тип и качество сжатия. | Raster Dataset |
Ключевое слово конфигурации (Дополнительный) | Параметры хранения (конфигурация) для базы геоданных. Ключевые слова конфигурации устанавливаются администратором базы геоданных. | String |
Игнорировать значение фона (Дополнительный) | Удаление нежелательных значений, созданных вокруг растровых данных. Указанное значение будет отделено от остальных значений набора растровых данных. Например, значение 0 по границам набора растровых данных будет отделено от значения 0 внутри набора растровых данных. Указанное значение элемента растра будет записано в выходной набор растровых данных как NoData. Чтобы игнорировать значения фона для отдельных файлов растров, значение Игнорировать значение фона должно быть тем же, что и Значение NoData. Растры многопользовательской базы данных и базы геоданных будут работать без этого дополнительного шага. | Double |
Значение NoData (Дополнительный) | Все элементы растра с указанными значениями будут записаны в выходной набор растровых данных как NoData. | String |
Конвертировать 1-битовые данные в 8-битовые (Дополнительный) | Определите, будет ли входной 1-битовый набор растровых данных конвертирован в 8-битный набор растровых данных. При этом конвертировании значение 1 во входном наборе растровых данных будет изменено на 255 в выходном наборе растровых данных. Это подходит при импорте 1-битового набора растровых данных в базу геоданных. При хранении в файловой системе у 1-битового растра будут 8-битовые пирамидные слои, но в базе геоданных у 1-битовых растровых наборов данных могут быть только 1-битовые пирамидные слои, что приводит к их низкокачественному отображению. При конвертации данных в 8-битовые в базе геоданных пирамидные слои строятся как 8-битовые вместо 1-битовых, что приведет к нормальному отображению набора растровых данных.
| Boolean |
Цветовая карта в RGB (Дополнительный) | Определите, будет ли входной набор растровых данных конвертирован в трехканальный выходной набор растровых данных, если входной набор растровых данных включает цветовую карту. Это полезно при создании мозаики из растров с разными цветовыми картами.
| Boolean |
Тип пиксела (Дополнительный) | Задает битовую глубину или радиометрическое разрешение, которое будет использоваться для набора растровых или мозаичных данных. Если не определено, будет использоваться значение из первого набора растровых данных.
| String |
Масштабировать значение пиксела (Дополнительный) | Определяет, будут ли масштабироваться значения пикселов. Если выходной тип пиксела отличается от входного (например, 16 бит и 8 бит), вы можете масштабировать значения, чтобы они соответствовали новому диапазону; в противном случае значения, не попадающие в новый диапазон пикселов, будут отброшены. Если битовая глубина повышается, например, 8 бит конвертируется в 16 бит, минимальное и максимальное 8-битовые значения конвертируются в минимум и максимум в 16-битном диапазоне. Если битовая глубина понижается, например, 16 бит конвертируется в 8 бит, минимальное и максимальное 16-битовые значения конвертируются в минимум и максимум в 8-битном диапазоне.
| Boolean |
RGB в цветовую карту (Дополнительный) | Указывает, будет ли конвертирован 8-битовый, 3-канальный (RGB) набор растровых данных в одноканальный растр с цветовой картой. Эта операция уменьшает шум, который нередко присутствует в отсканированных изображениях и идеально подходит для экранных снимков, отсканированных карт или отсканированных документов. Но его не рекомендуется использовать для спутниковых и аэроснимков, или для тематических растровых данных.
| Boolean |
Формат (Дополнительный) | Задает формат выходного растра.
| String |
Применить преобразование (Дополнительный) | Указывает, будет ли к выходному растру применено преобразование, связанное со входным растром. Входной растр может иметь связанное с ним преобразование, которое не сохраняется во входных данных, например файл привязки или геометрическую функцию.
| Boolean |
Обработать как многомерный (Дополнительный) | Задает, будет ли входной набор данных мозаики обработан как многомерный набор растровых данных.
| Boolean |
Построить многомерное транспонирование (Дополнительный) | Задает, будет ли построено транспонирование для входного многомерного набора растровых данных, чтобы оптимизировать доступ к данным. Транспонирование разделит многомерные данные вдоль каждого измерения для оптимизации производительности при доступе к значениям пикселов во всех срезах.
| Boolean |
Краткая информация
Сохраняет копию набора растровых данных или конвертирует набор данных мозаики в набор растровых данных.
Использование
Вы можете сохранить выходные данные в форматах BIL, BIP, BMP, BSQ, CRF, ENVI DAT, ERDAS IMAGINE, GIF, JPEG, JPEG 2000, MRF, NetCDF, PNG, TIFF или Esri Grid , а также в любом наборе растровых данных базы геоданных.
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При сохранении набора растровых данных в формате файла укажите расширение файла следующим образом:
- .bil для Esri BIL
- .bip для Esri BIP
- .bmp для BMP
- .bsq для Esri BSQ
- .crf для CRF
- .dat для ENVI DAT
- .img для ERDAS IMAGINE
- .gif для GIF
- .jpg для JPEG
- .jp2 для JPEG 2000
- .mrf для MRF
- .nc для NetCDF
- .png для PNG
- .tif для TIFF и Cloud Optimized GeoTIFF
- .zarr для Zarr
- Нет расширения для Esri Grid
Этот инструмент можно использовать для масштабирования типа пиксела от одной битовой глубины до другой. При изменении глубины пикселов растр будет отображаться без изменений, но его значения будут изменены в соответствии с заданной битовой глубиной.
Выходные данные для этого инструмента – всегда набор растровых данных. Инструмент может обрабатывать набор данных мозаики, но на выходе все равно будет создан набор растровых данных; из содержания набора данных мозаики будет создана мозаика для получения единого набора растровых данных.
Если вы отметили опцию Использовать файл привязки для определения координат растра в опциях Растры и изображения, будет записан файл привязки. Если файл привязки существует, он будет перезаписан. В выходной пространственной привязке возможен сдвиг на полпиксела.
Чтобы игнорировать значения фона для отдельных файлов растров, значение Игнорировать значение фона должно быть тем же, что и Значение NoData. Растры файловой базы геоданных и растры базы геоданных ArcSDE будут работать без этого дополнительного шага.
При хранении набора растровых данных в файле формата JPEG, файле JPEG 2000 или базе геоданных, вы можете указать значения Тип сжатия и Качество сжатия в Параметрах среды геообработки.
Формат GIF поддерживает только одноканальные наборы растровых данных.
После создания файл .mrf нельзя скопировать, переименовать или удалить в ArcGIS AllSource. Файл .mrf может указывать на данные, которые находятся где-то еще, и определить статус допустимости чтения или записи файла не всегда возможно.
Параметр Тип пиксела определяет битовую глубину выходного набора растровых данных. Если выбран другой тип пиксела, значения растра пересчитываются. Если выбран тип пиксела с меньшим диапазоном, значения растра, выходящие за пределы данного диапазона, будут потеряны. Более подробно о возможностях битовой глубины для поддерживаемых форматов экспорта см. Список поддерживаемых сенсоров.
Создание файла в формате Cloud Optimized GeoTIFF (COG) из любого растра с помощью инструмента - это двухступенчатый процесс, который включает правильную организацию внутренней структуры GeoTIFF со спецификацией COG. Первый шаг - создание временного файла формата GeoTIFF из входного растра с пирамидными слоями, статистикой и другими метаданными. Временный файл GeoTIFF затем копируется для формирования файла формата COG.
Для генерации файла формата COG необходимо свободное место на диске, объемом, как минимум, в два раза больше исходного изображения, что также зависит от степени сжатия входного файла и формата выходного файла COG.
Тип формата NetCDF, поддерживаемый для выходных данных, соответствует Соглашениям о метаданных NetCDF Климат и прогноз (CF).
Формат NetCDF поддерживает только одноканальные данные. Для многомерных и многоканальных данных, например спутниковых снимков, будет использован только первый канал.
Параметр Построить многомерное транспонирование предназначен для оптимизации доступа к данным. По умолчанию файл .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})
Имя | Описание | Тип данных |
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.management.CopyRaster('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
##Copy 1 BIT
arcpy.management.CopyRaster("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
arcpy.management.CopyRaster("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.management.CopyRaster(
"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")