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

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

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

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

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

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

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

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

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

Растровый слой

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: Да

Связанные разделы