Сводка
Редактирует многомерный растр, добавляя и удаляя переменные или измерения.
Использование
Воспользуйтесь этим инструментом для редактирования многомерного растра. Это не приводит к созданию нового набора данных, а только изменяет многомерный растр. Чтобы создать набор, воспользуйтесь инструментом Поднабор многомерных растров или Копировать растр перед внесением дополнительных изменений этим инструментом.
Целевой и входной растры должны быть в формате Cloud Raster Format (CRF). В настоящий момент другие форматы этим инструментом не поддерживаются. Чтобы конвертировать набор данных мозаики многомерных растров или слой многомерного растра в файл .crf, используйте инструмент Копировать растр, выберите CRF для исходного формата и обработку набора данных, как многомерного.
Параметром Режим управления задается тип выполняемой операции редактирования. Существует шесть опций:
- Добавить измерение - добавляет измерение в набор данных. Необходимо задать имя, описание и единицу измерения. После добавления измерения могут быть присоединены срезы другого многомерного набора данных с таким же измерением.
Если целевой растр - стандартный растр .crf, при добавлении измерения целевой растр становится многомерным, и в свойства растра добавляется Многомерная информация.
- Удалить измерение - удаляет измерение из набора данных. Если измерение только одно, в наборе данных может быть лишь один срез.
- Присоединить срезы - добавляет срезы одного или нескольких многомерных растров в конец стека срезов целевого многомерного растра. Имена переменной и измерения многомерных растров должны точно совпадать, и между растрами не может быть перекрывающихся значений измерений. Присоединяемые срезы должны иметь значения измерений, которые идут после значений измерений целевого многомерного растра.
- Заменить срезы - удаляет срезы из целевого многомерного растра и заменяет их срезами другого многомерного растра. Имена переменной и измерения многомерных растров должны точно совпадать, и заменены будут только перекрывающиеся срезы.
- Присоединить переменные - добавляет переменные одного или нескольких многомерных растров в конец списка переменных целевого многомерного растра. Если имя переменной уже существует в целевом многомерном растре, она добавлена не будет. Ели несколько входных многомерных растров содержат переменную с одинаковым именем, в целевой многомерный растр будет добавлена переменная из первого входного растра в списке.
- Удалить переменные - удаляет из многомерного растра одну или несколько переменных и соответствующие срезы. В многомерном растре должна оставаться хотя бы одна переменная.
- Добавить измерение - добавляет измерение в набор данных. Необходимо задать имя, описание и единицу измерения. После добавления измерения могут быть присоединены срезы другого многомерного набора данных с таким же измерением.
Для использования опции Присоединить срезы, Заменить срезы и Присоединить переменные у входных данных должны быть одинаковые пространственная привязка, пространственный экстент и размер ячейки.
Синтаксис
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})| Parameter | Объяснение | Тип данных |
target_multidimensional_raster | Многомерный растр в формате Cloud Raster Format (.crf), который следует изменить. | Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File |
manage_mode (Дополнительный) | Задает тип изменений, выполняемых для целевого растра.
| String |
variables [variables,...] (Дополнительный) | Переменная или переменные, которые будут изменены в выходном многомерном растре. Этот параметр необходим, если выполняемая операция - это изменение имеющейся переменной. Если переменная не задана, будет изменена первая переменная целевого много мерного растра. | String |
in_multidimensional_rasters [in_multidimensional_rasters,...] (Дополнительный) | Многомерные наборы растровых данных, содержащие срезы или переменные, добавляемые в целевой многомерный растр. Этот параметр требуется, когда для параметра manage_mode задано APPEND_SLICES, REPLACE_SLICES или APPEND_VARIABLES. | Raster Layer; Image Service |
dimension_name (Дополнительный) | Имя измерения, добавляемого в свойства растра. Этот параметр требуется, когда для manage_mode задано ADD_DIMENSION. | String |
dimension_value (Дополнительный) | Значение измерения для добавления. Это может быть одно значение или диапазон значений. Для задания диапазона значений введите разделенные запятыми минимально и максимальное значения. Например, для нового измерения высоты можно ввести 0,10, чтобы создать измерение, в котором в первом срезе будет содержаться информация для первых 10 метров высоты. Этот параметр требуется, когда для manage_mode задано ADD_DIMENSION. | String |
dimension_description (Дополнительный) | Описание нового измерения, добавляемого в свойства растра для метаданных. Этот параметр активен, если для manage_mode задано ADD_DIMENSION. | String |
dimension_unit (Дополнительный) | Единица нового измерения, добавляемого в свойства растра для метаданных. Этот параметр активен, если для manage_mode задано ADD_DIMENSION. | String |
update_statistics (Дополнительный) | Задает возможность пересчета статистики для каждого многомерного набора растровых данных.
| Boolean |
update_transpose (Дополнительный) | Задает возможность пересчета транспонирования для каждого многомерного набора растровых данных.
| Boolean |
Производные выходные данные
| Name | Объяснение | Тип данных |
| updated_target_multidimensional_raster | Измененный многомерный растр. | Растровый слой |
Пример кода
В этом примере выполняется присоединение срезов в конец многомерного растра и обновляется статистика.
# Import system modules
import arcpy
# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
"C:/data/temp1980_1990.crf", "APPEND_SLICES", "Temp",
["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"],None,
None,None, None, "UPDATE_STATISTICS")В этом примере выполняется замена срезов, добавляется переменная и измерение целевого многомерного растра.
# Import system modules
import arcpy
# Define input parameters
target_multidimensional_raster = "C:/data/hycom.crf"
manage_mode_replace = "REPLACE_SLICES"
manage_mode_append = "APPEND_VARIABLES"
manage_mode_newDimension = "ADD_DIMENSION"
variables = "water_temp"
replace_multidimensional_rasters = "C:/new_data/new_hycom1985.crf"
salinity_multidimensional_raster = "C:/data/salinity.crf"
dimension_name = "Depth"
dimension_value = "0,5"
dimension_description = "Depth at 5m increments"
dimension_unit = "meter"
update_stats = "UPDATE_STATISTICS"
update_transpose = "UPDATE_TRANSPOSE"
# Replace existing slices with new slices
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster,manage_mode_replace,
variables, replace_multidimensional_rasters)
# Append salinity variable
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_append,
'', salinity_multidimensional_raster)
# Add a new dimension, depth, for the water temperature variable
# Depth will be measured in 5 meter increments
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
variables, None, dimension_name, dimension_value, dimension_description, dimension_unit,
update_stats, update_transpose)В этом примере из многомерного растра с одним срезом удаляются измерения.
# Import system modules
import arcpy
# Define input parameters
target_multidimensional_raster = "C:/data/precip.crf"
manage_mode = "REMOVE_DIMENSION"
# Remove dimension to make input data dimensionless
arcpy.ManageMultidimensionalRaster_md(target_multidimensional_raster,
manage_mode)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да