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

Сводка

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

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

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

  • Поддерживаются следующие наборы многомерных растровых данных: netCDF, GRIB, HDF и CRF Esri. Также поддерживаются наборы многомерных данных мозаики.

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

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

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

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

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

Синтаксис

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
SubMultidim = SubsetMultidimensionalRaster("C:\data\Ocean_Data.crf", "salinity", "BY_RANGES", "StdZ -500 -100")

# Save Output
SubMultidim.save("C:\data\Halocline.crf")
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: Да

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