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

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

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

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

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

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

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

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

      Примечание:

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

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

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

Параметры

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

Многомерный растр в 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

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

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

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

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})
ИмяОписаниеТип данных
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Многомерный растр с одним срезом буде конвертирован в растр без измерений.
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. Если для параметра 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

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

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