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

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

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

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

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

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

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

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

    Примечание:

    Если входной набор данных CRF не является многомерным растром, вы не можете использовать этот инструмент для создания многомерного растра. Вместо этого используйте инструмент Задать свойства растра для создания многомерного растра.

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

• Параметр Единица сокращения определяет используемую единицу измерения даты и времени. Этот параметр необходим, если для параметра manage_mode задано TRUNCATE_DIMENSION_VALUES, а параметр Имя измерения установлен на StdTime.

• Параметр Единица сокращения имеет следующие опции для усечения значений даты: Год, Месяц, День, Час, Минута и Секунда. Например, если значение измерения времени равно 2013-03-19T12:30:00, опция Час будет сокращать значения после часов, в результате чего значение измерения станет 2013-03-19T12:00:00. При использовании параметра Месяц значение измерения станет 2013-03-01T00:00:00. Этот параметр применяется только в том случае, если значение параметра Имя измерения основано на времени.

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

• Удаление срезов из CRF требует сложных файловых операций. Это может повлиять на производительность удаления срезов из CRF, хранящегося в облаке.

Параметры

Диалог

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

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

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

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}, {truncation_unit}, {startEnd_keyword}, {dimension_def}, {min_value}, {max_value})

Имя	Описание	Тип данных
target_multidimensional_raster	Многомерный растр в формате 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—Многомерный растр с одним срезом буде конвертирован в растр без измерений. TRUNCATE_DIMENSION_VALUES—Значения измерений будут изменены путем сокращения значений даты или выбора начального и конечного значений, если значения измерений являются диапазонами. REMOVE_SLICES—Срез или диапазон срезов будет удален из входного многомерного растра.	String
variables [variables,...] (Дополнительный)	Переменная или переменные, которые будут изменены в выходном многомерном растре. Этот параметр необходим, если выполняемая операция - это изменение имеющейся переменной. Если переменная не задана, будет изменена первая переменная целевого много мерного растра.	String
in_multidimensional_rasters [in_multidimensional_rasters,...] (Дополнительный)	Многомерные наборы растровых данных, содержащие срезы или переменные, добавляемые в целевой многомерный растр. Этот параметр необходим, если параметр manage_mode задан как APPEND_SLICES, REPLACE_SLICES или APPEND_VARIABLES.	Raster Dataset; Raster Layer; Image Service
dimension_name (Дополнительный)	Имя измерения, которое нужно добавить или удалить из свойств растра. Этот параметр необходим, если параметр manage_mode установлен на ADD_DIMENSION, TRUNCATE_DIMENSION_VALUES или REMOVE_SLICES. Если для параметра manage_mode задано значение REMOVE_DIMENSION, указанное измерение может содержать только одно значение. Если значение не указано для этого параметра, и входные данные содержат только один срез, все измерения будут удалены.	String
dimension_value (Дополнительный)	Значение измерения для добавления или удаления. Это может быть одно значение или диапазон значений. Для задания диапазона значений введите разделенные запятыми минимально и максимальное значения. Например, для нового измерения высоты можно ввести 0,10, чтобы создать измерение, в котором в первом срезе будет содержаться информация для первых 10 метров высоты. Этот параметр необходим, если для параметра manage_mode задано ADD_DIMENSION или REMOVE_SLICES, а для параметра dimension_def задано BY_VALUES. Если для параметра manage_mode задано значение REMOVE_SLICES, значение должно быть единственным.	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
truncation_unit (Дополнительный)	Задает используемую единицу измерения даты и времени. Этот параметр необходим, если для параметра manage_mode задано TRUNCATE_DIMENSION_VALUES, а для параметра dimension_name - STDTIME. SECOND—Указанной единицей измерения времени для сокращения будут секунды. MINUTE—Указанной единицей измерения времени для сокращения будут минуты. HOUR—Указанной единицей измерения времени для сокращения будут часы. DAY—Указанной единицей измерения времени для сокращения будут дни. MONTH—Указанной единицей измерения времени для сокращения будут месяцы. YEAR—Указанной единицей измерения времени для сокращения будут годы.	String
startEnd_keyword (Дополнительный)	Указывает, как будет сокращено значение измерения. Это параметр активен, когда для параметра manage_mode задано TRUNCATE_DIMENSION_VALUES. START—Значение измерения будет сокращено на начальном значении. END—Значение измерения будет сокращено на конечном значении. BOTH—Значение измерения будет сокращено на начальном и конечном значениях.	String
dimension_def (Дополнительный)	Указывает, как будут сделаны срезы измерения. BY_VALUES—Срезы измерения будут сделаны с использованием списка значений измерения. Это значение по умолчанию BY_RANGES—Срезы измерения будут сделаны с использованием диапазона.	String
min_value (Дополнительный)	Минимальное значение диапазона срезов, которое будет удалено. Это параметр активен, когда для параметра dimension_def задано BY_RANGES.	String
max_value (Дополнительный)	Максимальное значение диапазона срезов, которое будет удалено. Это параметр активен, когда для параметра dimension_def задано BY_RANGES.	String

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

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

Пример кода

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.md.ManageMultidimensionalRaster(target_multidimensional_raster,
	manage_mode)

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

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

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

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