Поднабор многомерных растров (Многомерные данные)

Сводка

Создает поднабор многомерного растра путем разрезания данных по определенным переменным и измерениям.

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

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

  • Поддерживаются следующие многомерные наборы растровых данных: Облачный растр (CRF), многомерные наборы данных мозаики или многомерные растровые слои, созданные из файлов netCDF, GRIB или HDF.

  • Этот инструмент создает набор многомерных растровых данных в облачном растровом формате (CRF). Другие форматы выходных данных в настоящее время не поддерживаются.

  • Параметр Определение измерения используется для создания срезов измерений с использованием интервала, значения или диапазона значений. Например, если у вас есть данные о солености океана за 10 лет, собираемые ежемесячно до глубины 500 метров через каждые 2 метра, вы можете использовать различные опции определения измерения для следующих сценариев:

    • Извлечение данных о солености воды в январе за 10-летний период. Выберите По значениям, установите для Размер StdTime, а для Значения выберите Январь.
    • Срез данных о солености воды на глубине от 0 до 150 метров. Выберите По диапазону, для Измерение выберите StdZ, Минимальное значение задайте как -150, а Максимальное значение как 0.
    • Извлечение данных о солености воды в первую декаду января в течение 10-летнего периода. Выберите По итерации, для Измерение выберите StdTime, для Начало первой итерации и Конец первой итерации задайте соответствующие начало и окончание периода итерации, для Шаг установите 1, для Единицы выберите Годы.

  • По умолчанию многомерные выходные растровые данные сжимаются, тип сжатия – LZ77. Однако рекомендуется изменить тип сжатия на LERC и настроить максимальное значение ошибки, основываясь на ваших данных. Например, если вы ожидаете, что результаты анализа будут иметь точность до трех знаков после запятой, используйте 0,001 для максимального значения ошибки. Лучше избегать ненужных требований к точности, так как они увеличат время обработки и размер хранилища.

    Чтобы изменить тип сжатия, измените настройки параметров среды.

Синтаксис

arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit})
ParameterОбъяснениеТип данных
in_multidimensional_raster

Входной многомерный набор растровых данных.

К поддерживаемым входным данным относятся файлы netCDF, GRIB, HDF или CRF, многомерный набор данных мозаики или многомерный растровый слой.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
out_multidimensional_raster

Выходной многомерный набор растровых данных.

Raster Dataset
variables
[variables,...]
(Дополнительный)

Переменные, которые будут включены в выходной многомерный растр. Если переменная не указана, используются все.

String
dimension_def
(Дополнительный)

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

  • ALLБудет использоваться полный диапазон каждого измерения. Это значение по умолчанию.
  • BY_RANGESСрезы измерения будут сделаны с использованием диапазона или списка диапазонов.
  • BY_ITERATIONСрезы измерения будут сделаны в соответствии с заданным размером интервала.
  • BY_VALUEСрезы измерения будут сделаны с использованием списка значений измерения.
String
dimension_ranges
[dimension_ranges,...]
(Дополнительный)

Диапазон или список диапазонов для указанного измерения.

Создает срезы данных на основе имени измерения и минимального и максимального значений диапазона. Этот параметр необходим, если для параметра dimension_def задано BY_RANGES.

Value Table
dimension_values
[dimension_values,...]
(Дополнительный)

Список значений для указанного измерения. Этот параметр необходим, если для параметра dimension_def задано BY_VALUE.

Value Table
dimension
(Дополнительный)

Измерение, по которому будут нарезаться переменные. Этот параметр необходим, если для параметра dimension_def задано BY_ITERATION.

String
start_of_first_iteration
(Дополнительный)

Начало первого интервала. Этот интервал используется для итерации набора данных. Этот параметр необходим, если параметр dimension_def установлен на BY_ITERATION.

String
end_of_first_iteration
(Дополнительный)

Окончание первого интервала. Этот интервал используется для итерации набора данных. Этот параметр необходим, если параметр dimension_def установлен на BY_ITERATION.

String
iteration_step
(Дополнительный)

Частота, с которой будут сделаны срезы данных. Этот параметр необходим, если параметр dimension_def установлен на BY_ITERATION.

Double
iteration_unit
(Дополнительный)

Задает единицу итерации. Этот параметр необходим, если для параметра dimension_def задано BY_ITERATION, а для параметра dimension - StdTime.

  • HOURSЗаданная единица времени - часы.
  • DAYSЗаданная единица времени - дни.
  • WEEKSЗаданная единица времени - недели.
  • MONTHSЗаданная единица времени - месяцы.
  • YEARSЗаданная единица времени - годы.
String

Пример кода

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

Извлекает поднабор переменных из многомерного растра, используя метод BY_RANGES.

# Import system modules
import arcpy

# Execute
arcpy.md.SubsetMultidimensionalRaster(
	"C:\data\Ocean_Data.crf", "C:\data\Ocean_Data_Subset.crf", 
	"salinity", "BY_RANGES", "StdZ -500 -100")
SubsetMultidimensionalRaster, пример 2 (автономный скрипт)

Извлечение переменной температуры воды из многомерного растра с использованием метода BY_VALUE

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"

#Execute

arcpy.md.SubsetMultidimensionalRaster(
	in_multidimensional_raster, out_multidimensional_raster, 
	variables, dimension_def, dimension_values)
SubsetMultidimensionalRaster, пример 3 (автономный скрипт)

Извлечение переменной солености воды из многомерного растра с использованием метода BY_ITERATION.

# Import system modules
import arcpy
 
# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster =  r"C:\data\salinity_slice.crf"
variables = "salinity"
dimension_def = "BY_ITERATION"
dimension = "StdTime"
start_of_first_iteration = "2009-01-01"
end_of_first_iteration = "2009-01-10"
iteration_step = "1"
iteration_unit = "YEARS"
 
#Execute
 
arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit)

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

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

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