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

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

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

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

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

  • Целевой и входной растры должны быть в формате 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, который будет изменен.

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

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

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

Измененный многомерный растр.

Raster Layer

arcpy.management.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})
ИмяОписаниеТип данных
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Значения измерений будут изменены путем сокращения значений даты или выбора начального и конечного значений, если значения измерений являются диапазонами.
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. Если для параметра manage_mode задано значение REMOVE_DIMENSION, указанное измерение может содержать только одно значение. Если значение параметра dimension_name не задано и входные данные содержат только один срез, все измерения будут удалены.

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

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

ИмяОписаниеТип данных
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"

# Replace existing slices with new slices
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_replace, 
	variables, replace_multidimensional_rasters)

# Append salinity variable
arcpy.md.ManageMultidimensionalRaster(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.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit)
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)