Управлять многомерным растром (Многомерные данные)

Краткая информация

Редактирует многомерный растр, добавляя и удаляя переменные или измерения.

Использование

• Воспользуйтесь этим инструментом для редактирования многомерного растра. Это не приводит к созданию нового набора данных, а только изменяет многомерный растр. Чтобы создать набор, воспользуйтесь инструментом Поднабор многомерных растров или Копировать растр перед внесением дополнительных изменений этим инструментом.

• Целевой и входной растры должны быть в формате Cloud Raster Format (CRF). В настоящий момент другие форматы этим инструментом не поддерживаются. Чтобы конвертировать набор данных мозаики многомерных растров или слой многомерного растра в файл .crf, используйте инструмент Копировать растр, выберите CRF для исходного формата и обработку набора данных, как многомерного.

• Параметром Режим управления задается тип выполняемой операции редактирования. Существует шесть опций:

  • Добавить измерение - добавляет измерение в набор данных. Необходимо задать имя, описание и единицу измерения. После добавления измерения могут быть присоединены срезы другого многомерного набора данных с таким же измерением.

    Если целевой растр - стандартный растр .crf, при добавлении измерения целевой растр становится многомерным, и в свойства растра добавляется Многомерная информация.

  • Удалить измерение - удаляет измерение из набора данных. Если измерение только одно, в наборе данных может быть лишь один срез.
  • Присоединить срезы - добавляет срезы одного или нескольких многомерных растров в конец стека срезов целевого многомерного растра. Имена переменной и измерения многомерных растров должны точно совпадать, и между растрами не может быть перекрывающихся значений измерений. Присоединяемые срезы должны иметь значения измерений, которые идут после значений измерений целевого многомерного растра.
  • Заменить срезы - удаляет срезы из целевого многомерного растра и заменяет их срезами другого многомерного растра. Имена переменной и измерения многомерных растров должны точно совпадать, и заменены будут только перекрывающиеся срезы.
  • Присоединить переменные - добавляет переменные одного или нескольких многомерных растров в конец списка переменных целевого многомерного растра. Если имя переменной уже существует в целевом многомерном растре, она добавлена не будет. Ели несколько входных многомерных растров содержат переменную с одинаковым именем, в целевой многомерный растр будет добавлена переменная из первого входного растра в списке.
  • Удалить переменные - удаляет из многомерного растра одну или несколько переменных и соответствующие срезы. В многомерном растре должна оставаться хотя бы одна переменная.

• Для использования опции Присоединить срезы, Заменить срезы и Присоединить переменные у входных данных должны быть одинаковые пространственная привязка, пространственный экстент и размер ячейки.

Параметры

Диалог

Подпись	Описание	Тип данных
Целевой многомерный растр	Многомерный растр в формате Cloud Raster Format (.crf), который следует изменить.	Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
Режим управления (Дополнительный)	Задает тип изменений, выполняемых для целевого растра. Добавить измерение—Измерение будет добавлено во входной многомерный растр. Присоединить срезы—Срезы входных многомерных растров будут добавлены в конец срезов измерения. Это значение по умолчанию. Присоединить переменные—Будут добавлены переменные входных многомерных растров. Заменить срезы—Имеющиеся срезы будут заменены срезами другого многомерного растра на определенных значениях измерений. Удалить переменные—Из многомерного растра будут удалены переменные. Удалить измерение—Многомерный растр с одним срезом буде конвертирован в растр без измерений.	String
Переменные (Дополнительный)	Переменная или переменные, которые будут изменены в выходном многомерном растре. Этот параметр необходим, если выполняемая операция - это изменение имеющейся переменной. Если переменная не задана, будет изменена первая переменная целевого много мерного растра.	String
Входные многомерные растры (Дополнительный)	Многомерные наборы растровых данных, содержащие срезы или переменные, добавляемые в целевой многомерный растр. Этот параметр необходим, если задан Режим управления Присоединить срезы, Заменить срезы или Присоединить переменные.	Raster Layer; Image Service
Название измерения (Дополнительный)	Имя измерения, добавляемого в свойства растра. Этот параметр необходим, если для Режима управления выбрано Добавить измерение.	String
Значение измерения (Дополнительный)	Значение измерения для добавления. Это может быть одно значение или диапазон значений. Для задания диапазона значений введите разделенные запятыми минимально и максимальное значения. Например, для нового измерения высоты можно ввести 0,10, чтобы создать измерение, в котором в первом срезе будет содержаться информация для первых 10 метров высоты. Этот параметр необходим, если для Режима управления выбрано Добавить измерение.	String
Описание измерения (Дополнительный)	Описание нового измерения, добавляемого в свойства растра для метаданных. Этот параметр активен, если для Режима управления выбрано Добавить измерение.	String
Единицы измерений измерения (Дополнительный)	Единица нового измерения, добавляемого в свойства растра для метаданных. Этот параметр активен, если для Режима управления выбрано Добавить измерение.	String
Обновить статистику (Дополнительный)	Задает возможность пересчета статистики для каждого многомерного набора растровых данных. Отмечено – статистика будет заново рассчитана. Это значение по умолчанию. Не отмечено – статистика не будет заново рассчитывается.	Boolean
Обновить транспонирование (Дополнительный)	Задает возможность пересчета транспонирования для каждого многомерного набора растровых данных. Отмечено – транспонирование будет пересчитано. Если транспонирование отсутствует, будет построено новое транспонирование. Это значение по умолчанию. Не отмечено – транспонирование пересчитываться не будет.	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Целевой многомерный растр	Измененный многомерный растр.	Растровый слой

Python

arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})

Имя	Описание	Тип данных
target_multidimensional_raster	Многомерный растр в формате Cloud Raster Format (.crf), который следует изменить.	Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
manage_mode (Дополнительный)	Задает тип изменений, выполняемых для целевого растра. ADD_DIMENSION—Измерение будет добавлено во входной многомерный растр. APPEND_SLICES—Срезы входных многомерных растров будут добавлены в конец срезов измерения. Это значение по умолчанию. APPEND_VARIABLES—Будут добавлены переменные входных многомерных растров. REPLACE_SLICES—Имеющиеся срезы будут заменены срезами другого многомерного растра на определенных значениях измерений. DELETE_VARIABLES—Из многомерного растра будут удалены переменные. REMOVE_DIMENSION—Многомерный растр с одним срезом буде конвертирован в растр без измерений.	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 (Дополнительный)	Задает возможность пересчета статистики для каждого многомерного набора растровых данных. UPDATE_STATISTICS—Статистика будет рассчитываться заново. Это значение по умолчанию. NO_UPDATE_STATISTICS—Статистика не будет рассчитываться заново.	Boolean
update_transpose (Дополнительный)	Задает возможность пересчета транспонирования для каждого многомерного набора растровых данных. UPDATE_TRANSPOSE—Транспонирование будет пересчитано. Если транспонирование отсутствует, будет построено новое транспонирование. Это значение по умолчанию. NO_UPDATE_TRANSPOSE—Транспонирование пересчитываться не будет.	Boolean

Производные выходные данные

Имя	Описание	Тип данных
updated_target_multidimensional_raster	Измененный многомерный растр.	Растровый слой

Пример кода

ManageMultidimensionalRaster, пример 1 (окно Python)

В этом примере выполняется присоединение срезов в конец многомерного растра и обновляется статистика.

# 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")

ManageMultidimensionalRaster, пример 2 (автономный скрипт)

В этом примере выполняется замена срезов, добавляется переменная и измерение целевого многомерного растра.

# 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)

ManageMultidimensionalRaster, пример 3 (автономный скрипт)

В этом примере из многомерного растра с одним срезом удаляются измерения.

# 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)

Параметры среды

Коэффициент параллельной обработки

Особые случаи

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да