Подпись | Описание | Тип данных |
Входной куб пространство-время | Куб пространство-время, из которого будет создан поднабор. У файлов куба пространство-время расширение - .nc; они создаются разнообразными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей. | File |
Выходной куб пространство-время | Поднабор куба пространство-время, который отвечает пространственным и временным критериям, указанным в параметрах Метод пространственного поднабора и Метод временного поднабора. Переменные анализа, хранящиеся во входном кубе пространство-время, будут исключены из выходного куба пространство-время. | File |
Метод пространственного поднабора | Определяет метод, который будет использован для создания пространственного поднабора входного куба пространство-время. Местоположения входного куба пространство-время, отвечающие этому критерию пространственного поднабора, будут включены в выходной куб пространство-время.
| String |
Метод временного поднабора | Определяет метод, который будет использован для создания временного поднабора входного куба пространство-время. Временные шаги входного куба пространство-время, отвечающие этому критерию временного поднабора, будут включены в выходной куб пространство-время.
| String |
Входные объекты поднабора (Дополнительный) | Класс объектов, содержащий полигоны, точки или линии для определения поднабора в кубе пространство-время. Пространственные отношения между входными объектами поднабора и кубом пространство-время указываются в параметре Пространственные отношения. | Feature Layer |
Пространственное отношение (Дополнительный) | Определяет пространственные отношения между Входными объектами поднабора или Входным пространственным поднабором куба и входным кубом пространство-время для создания поднабора куба пространство-время. Доступные опции пространственных отношений зависят от геометрии входного куба пространство-время и входных объектов поднабора или входного пространственного поднабора куба.
| String |
Экстент (Дополнительный) | Пространственный экстент, который определяет пространственный поднабор входного куба пространство-время. Выходной куб пространство-время будет включать местоположения входного куба пространство-время, которые пересекают экстент. | Extent |
Входной пространственный поднабор куба (Дополнительный) | Куб пространство-время, который определяет пространственный поднабор входного куба пространство-время. Пространственные отношения между входным пространственным поднабором куба и кубом пространство-время указываются в параметре Пространственные отношения. | File |
Временной интервал поднабора (Дополнительный) | Временной интервал, который определяет временной поднабор входного куба пространство-время. Все временные шаги в пределах этого временного интервала, или которые содержат значения Времени начала или Времени окончания, будут включены в выходной куб пространство-время. | Value Table |
Число временных шагов для удаления (Дополнительный) | Число временных шагов от времени начала или времени окончания входного куба пространство-время, которые будут удалены в выходном кубе пространство-время. | Value Table |
Входной временной поднабор куба (Дополнительный) | Куб пространство-время, который определяет временной поднабор входного куба пространство-время. Временной экстент временного поднабора куба определяет временной экстент выходного куба пространство-время. Все временные шаги в пределах временного экстента входного временного поднабора куба, или которые содержат время начала или время окончания временного поднабора куба будут включены в выходной куб пространство-время. | File |
Краткая информация
Создает поднабор куба пространство-время по пространственному экстенту, пространству или времени.
Инструмент экспортирует местоположения и бины входного куба пространство-время, которые соответствуют выбранному критерию методов поднабора. Инструмент может создать пространственный поднабор куба пространство-время по объектам, экстенту или местоположениям другого куба пространство-время. Инструмент может создать временной поднабор куба пространство-время по временному интервалу, временному экстенту другого куба пространство-время, или удалив временные шаги в начале или в конце куба пространство-время. Выходной куб пространство-время будет включать все переменные, созданные инструментами группы Создание куба пространство-время.
Иллюстрация
Использование
Этот инструмент использует файлы netCDF, созданные инструментами в Наборе инструментов Углубленный анализ пространственно-временных закономерностей.
Ниже приведены потенциальные варианты применения этого инструмента:
- Использование класса объектов на территорию Африки для создания пространственного поднабора исходного куба пространство-время с данными на весь мир.
- Использование куба пространство-время на территорию Калифорнии для создания пространственного поднабора исходного куба пространство-время с данными на всю территорию США.
- Применение пространственного поднабора для удаления шагов куба пространство-время в начале или в конце исходного куба пространство-время, где много бинов с пустыми значениями.
- Применение временного поднабора для удаления результатов прогнозирования из куба пространство-время. Затем используется инструмент группы Прогнозирование временных рядов с кубом пространство-время.
Переменные анализа, хранящиеся во входном кубе пространство-время, не переносятся в выходной поднабор куба пространство-время. Результаты анализа входного куба пространство-время основываются на его пространственно-временной структуре. Если создан поднабор куба пространство-время, результаты анализа в нем могут быть некорректны. Для восстановления переменных анализа, перезапустите инструменты группы Анализ пространственно-временных закономерностей и группы Прогнозирование временных рядов с выходным поднабором куба пространство-время.с выходным поднабором куба пространство-время.
Инструмент создает сообщения геообработки. Чтобы получить доступ к сообщениям, поместите курсор мыши над индикатором выполнения и щелкните всплывающую кнопку или разверните раздел сообщений в панели Геообработка. Сообщения включают следующую информацию:
- Раздел Сводная информация поднабора, где сравниваются характеристики входного куба пространство-время с характеристиками поднабора куба пространство-время.
Раздел Характеристики куба пространство-время, описывающий свойства пространства и времени в кубе пространство-время. В этом разделе значение Временного экстента входных объектов указывает временной экстент объектов, использованных для создания исходного куба пространство-время. Это значение не изменяется, если вы создаете поднабор куба пространство-время Более подробно об этих характеристиках см. как работает инструмент Создать куб пространство-время.
- Раздел Содержание куба пространство-время, где каждая строка соответствует переменной во входном кубе пространство-время. Каждая строка содержит суммарную статистику для переменной, указание на инструмент, с помощью которого была создана переменная (вместе с типом агрегации и заполнения) и опции тем отображения, доступные для инструментов Визуализация куба пространство-время в 2D и Визуализация куба пространство-время в 3D.
- Если куб пространство-время был создан с использованием инструмента Создать куб пространство-время по агрегации точек, сообщения будут содержать один или несколько подразделов, в разделе Местоположения и бины куба пространство-время. Подраздел Количество и каждый дополнительный подраздел Поле суммирования содержит число бинов и местоположения, в которых содержится хотя бы одна точка. Разреженность (процент бинов, в которых не содержится ни одной точки) также указан в подразделе Количество.
- Если куб пространство-время был создан при помощи инструмента из группы инструментов Прогнозирование временных рядов, в сообщениях будет подраздел Подробности прогноза, в котором приводится информация о примененных методах прогнозирования. В этом разделе временной экстент, используемый для прогнозирования, указывает временной экстент объектов, использованных для создания исходного куба пространство-время. Это значение не изменяется, если вы создаете поднабор куба пространство-время
- Сообщения будут включать один или несколько разделов под заголовком Тренды куба пространство-время. В этом разделе приводится обзор Статистики трендов Манна-Кендалла для каждой переменной в кубе пространство-время.
Если параметр Метод пространственного поднабора установлен на Объекты, убедитесь, что система координат входного поднабора объектов соответствует системе координат входного куба пространство-время. Используйте инструмент Проецировать для изменения системы координат входного поднабора объектов. Если система координат не соответствует, поднабор может не получится, или местоположения выходного куба пространство-время могут быть в неожиданных местах.
Применение пространственного поднабора не меняет геометрию местоположений куба пространство-время. Каждое местоположение включается или исключается из выходного куба пространство-время на основании выбранного пространственного критерия поднабора.
Применение временного поднабора не меняет временной интервал в кубе пространство-время или временной экстент бинов. Каждый бин включается или исключается из выходного куба пространство-время на основании выбранного временного критерия поднабора. Если параметр Временной метод поднабора установлен на Определен пользователем или Куб пространство-время, а указанное время начала и время окончания в пределах бина, весь бин будет включен в выходной куб пространство-время. В этом случае временной интервал выходного куба пространство-время может не соответствовать указанному времени начала или окончания, или интервалу временного поднабора куба. Например, если в кубе пространство-время задан интервал временного шага в один месяц, а временной поднабор куба пространство-время попадает в интервал между 24.01.2020 и 24.12.2020, временной интервал выходного куба будет охватывать период с 01.01.2020 до 31.12.2020.
Каждый временной шаг в кубе пространство-время исключен из времени начала бина, и включен во время окончания. Например, если время начала бина 1.01.2020 12:00:00, а время окончания 1.01.2021 12:00:00, бин будет включать данные после 1.01.2020 12:00:00 AM и далее, или до 1.01.2021 12:00:00. Если столбец Время начала параметра Временной интервал поднабора указан как 1.01.2021 12:00:00 выходной поднабор куба пространство-время начнется с 1.01.2020 12:00:00, то есть данные от 1.01.2021 12:00:00 AM будут включены в выходной поднабор куба пространство-время.
Если к кубу пространство-время применяется временной поднабор, выходной куб пространство-время должен содержать, как минимум, 10 временных шагов, чтобы инструмент запустился.
Если инструмент создают поднабор куба из указанных местоположений, любое местоположение, не соответствующее критерию поднабора, удаляется из выходного куба пространство-время. Но если инструмент создает поднабор куба сетки, местоположения, которые не соответствуют критерию, только маскируются в выходном кубе пространство-время. Маскированные местоположения остаются в кубе пространство-время, но исключаются из анализа.
Если куб пространство-время был создан с помощью инструмента Создать куб пространство-время по агрегации точек, в нем могут быть переменные, которые относится к разным местоположениям под маской. Это влияет, на то, как инструмент Поднабор куба пространство-время применяет пространственный поднабор.
- Если куб пространство-время задан как Входной пространственный поднабор куба, местоположения переменной Количество будут использованы для создания пространственного поднабора входного куба пространство-время.
- Если куб пространство-время задан как входной куб пространство-время, и инструмент применяет пространственный поднабор, каждая переменная должна присутствовать, как минимум, в одном местоположении в выходном поднаборе куба пространство-время, иначе инструмент не запустится.
- Контролирует, какая переменная куба пространство-время определяет пространственный поднабор при повторном построении куба пространство-время с использованием только переменной интереса. Сначала используйте инструмент Визуализация куба Пространство-Время в 3D для визуализации значений куба пространство-время. Затем примените инструмент Создать куб пространство-время из указанных местоположений для создания нового куба пространство-время из выходных объектов. Выбор переменной интереса.
Если ваш временной поднабор - куб прогноза, но все временные шаги пронозирования удалены, выходной куб пространство-время больше не будет кубом прогноза. Результирующий куб пространства-времени может быть использован как входной любым инструментом группы Прогнозирование временных рядов.
Параметры
arcpy.stpm.SubsetSpaceTimeCube(in_cube, out_cube, spatial_subset_method, temporal_subset_method, {in_subset_features}, {spatial_relationship}, {spatial_extent}, {in_spatial_cube}, {time_span_subset}, {remove_time_steps}, {in_temporal_cube})
Имя | Описание | Тип данных |
in_cube | Куб пространство-время, из которого будет создан поднабор. У файлов куба пространство-время расширение - .nc; они создаются разнообразными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей. | File |
out_cube | Поднабор куба пространство-время, который отвечает пространственным и временным критериям, указанным в параметрах spatial_subset_method и temporal_subset_method. Переменные анализа, хранящиеся во входном кубе пространство-время, будут исключены из выходного куба пространство-время. | File |
spatial_subset_method | Определяет метод, который будет использован для создания пространственного поднабора входного куба пространство-время. Местоположения входного куба пространство-время, отвечающие этому критерию пространственного поднабора, будут включены в выходной куб пространство-время.
| String |
temporal_subset_method | Определяет метод, который будет использован для создания временного поднабора входного куба пространство-время. Временные шаги входного куба пространство-время, отвечающие этому критерию временного поднабора, будут включены в выходной куб пространство-время.
| String |
in_subset_features (Дополнительный) | Класс объектов, содержащий полигоны, точки или линии для определения поднабора в кубе пространство-время. Пространственные отношения между входными объектами поднабора и кубом пространство-время указываются в параметре spatial_relationship. | Feature Layer |
spatial_relationship (Дополнительный) | Пространственные отношения между in_subset_features или in_spatial_cube куба и входным кубом пространство-время для создания поднабора куба пространство-время. Доступные опции пространственных отношений зависят от геометрии входного куба пространство-время и входных объектов поднабора или входного пространственного поднабора куба.
| String |
spatial_extent (Дополнительный) | Пространственный экстент, который определяет пространственный поднабор входного куба пространство-время. Выходной куб пространство-время будет включать местоположения входного куба пространство-время, которые пересекают экстент. | Extent |
in_spatial_cube (Дополнительный) | Куб пространство-время, который определяет пространственный поднабор входного куба пространство-время. Пространственные отношения между входным пространственным поднабором куба и кубом пространство-время указываются в параметре spatial_relationship. | File |
time_span_subset [time_span_subset,...] (Дополнительный) | Временной интервал, который определяет временной поднабор входного куба пространство-время. Все временные шаги в пределах этого временного интервала, или которые содержат значения времени начала или времени окончания, будут включены в выходной куб пространство-время. | Value Table |
remove_time_steps [remove_time_steps,...] (Дополнительный) | Число временных шагов от времени начала или времени окончания входного куба пространство-время, которые будут удалены в выходном кубе пространство-время. | Value Table |
in_temporal_cube (Дополнительный) | Куб пространство-время, который определяет временной поднабор входного куба пространство-время. Временной экстент временного поднабора куба определяет временной экстент выходного куба пространство-время. Все временные шаги в пределах временного экстента входного временного поднабора куба, или которые содержат время начала или время окончания временного поднабора куба будут включены в выходной куб пространство-время. | File |
Пример кода
Скрипт Python, демонстрирующий использование функции SubsetSpaceTimeCube.
import arcpy
arcpy.env.workspace = "C:\STPM"
arcpy.stpm.SubsetSpaceTimeCube("input_cube.nc", "subset_cube.nc",
"SPACE_TIME_CUBE", "NONE", None, None, None,
"spatial_subset_cube.nc")
Следующий автономный Python скрипт демонстрирует, как использовать функцию SubsetSpaceTimeCube.
# Use the Subset Space Time Cube tool to subset a space-time cube by time
# and space.
# Import system modules
import arcpy
import os
# Set workspace
arcpy.env.workspace = r"C:\Analysis"
gdb = os.path.join(arcpy.env.workspace, "continents.gdb")
arcpy.env.overwriteOutput = True
# Temporally subset a space-time cube
temperature_stc = "Temperature_STC.nc"
temporal_subset_stc = "Temperature_STC_temporal_subset.nc"
arcpy.stpm.SubsetSpaceTimeCube(temperature_stc, temporal_subset_stc, "NONE",
"USER_DEFINED", None, "", "DEFAULT", None,
"1/1/2012 1/1/2022")
# Spatially subset the data for every continent in the space-time cube
continents = ["Africa", "North_America", "Antarctica", "South_America", "Asia",
"Europe", "Australia"]
for continent in continents:
feature = os.path.join(gdb, c)
arcpy.stpm.SubsetSpaceTimeCube(temporal_subset_stc,
continent + "_temperature_subset.nc",
"FEATURES", "NONE", feature, "INTERSECT")