Сводка
Создает поднабор многомерного растра путем разрезания данных по определенным переменным и измерениям.
Использование
Этот инструмент создает многомерный растровый слой из многомерного растра или набора данных мозаики путем извлечения поднабора переменных. Например, у вас есть набор данных мозаики, который содержит данные о среднемесячных уровнях осадков за 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 (Дополнительный) | Определяет метод, который будет использоваться для среза измерения.
| 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.
| String |
Пример кода
Извлекает поднабор переменных из многомерного растра, используя метод 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")Извлечение переменной температуры воды из многомерного растра с использованием метода 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)Извлечение переменной солености воды из многомерного растра с использованием метода 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)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да