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

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

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

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

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

  • Поддерживаемые многомерные наборы растровых данных включают Cloud Raster Format (CRF), многомерные наборы данных мозаики или многомерные растровые слои, созданные с помощью файлов netCDF, GRIB или HDF.

  • Этот инструмент создает многомерный набор растровых данных в формате Cloud Raster Format (CRF). В настоящее время другие форматы выхода не поддерживаются.

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

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

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

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

Параметры

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

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

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

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Выходной многомерный растр

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

Raster Dataset
Переменные
(Дополнительный)

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

String
Определение измерения
(Дополнительный)

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

  • ВсеБудет использоваться полный диапазон каждого измерения. Это значение по умолчанию
  • По диапазонуСрезы измерения будут сделаны с использованием диапазона или списка диапазонов.
  • По итераторуСрезы измерения будут сделаны в соответствии с заданным размером интервала.
  • По значениямСрезы измерения будут сделаны с использованием списка значений измерения.
String
Диапазон
(Дополнительный)

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

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

Value Table
Значения
(Дополнительный)

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

Value Table
Измерение
(Дополнительный)

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

String
Начало первой итерации
(Дополнительный)

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

String
Окончание первой итерации
(Дополнительный)

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

String
Шаг
(Дополнительный)

Частота, с которой будут сделаны срезы данных. Этот параметр необходим, если для параметра Определение измерения задано По итератору.

Double
Единицы измерения
(Дополнительный)

Задает единицу итерации, которая будет использоваться. Этот параметр необходим, если для параметра Определение измерения установлено По итератору, а параметр Измерение установлен как StdTime.

  • ЧасыЗаданной единицей времени будет час.
  • ДниЗаданной единицей времени будут сутки.
  • НеделиЗаданной единицей времени будет неделя.
  • МесяцыЗаданной единицей времени будет месяц.
  • ГодыЗаданной единицей времени будет год.
String

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

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