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

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

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

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

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

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

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

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

    • Извлечение данных о солености воды в январе за 10-летний период. Выберите По значениям, установите для Размер StdTime, а для Значения выберите Январь.
    • Срез данных о солености воды на глубине от 0 до 150 метров. Выберите По диапазону, для Измерение выберите StdZ, Минимальное значение задайте как -150, а Максимальное значение как 0.
    • Извлечение данных о солености воды в первую декаду января в течение 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: Да

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