Поднабор куба пространство-время (Углубленный анализ пространственно-временных закономерностей)

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

Создает поднабор куба пространство-время по пространственному экстенту, пространству или времени.

Инструмент экспортирует местоположения и бины входного куба пространство-время, которые соответствуют выбранному критерию методов поднабора. Инструмент может создать пространственный поднабор куба пространство-время по объектам, экстенту или местоположениям другого куба пространство-время. Инструмент может создать временной поднабор куба пространство-время по временному интервалу, временному экстенту другого куба пространство-время, или удалив временные шаги в начале или в конце куба пространство-время. Выходной куб пространство-время будет включать все переменные, созданные инструментами группы Создание куба пространство-время.

Иллюстрация

Иллюстрация инструмента Поднабор куба пространство-время

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

  • Этот инструмент использует файлы 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 для визуализации значений куба пространство-время. Затем примените инструмент Создать куб пространство-время из указанных местоположений для создания нового куба пространство-время из выходных объектов. Выбор переменной интереса.
  • Если ваш временной поднабор - куб прогноза, но все временные шаги пронозирования удалены, выходной куб пространство-время больше не будет кубом прогноза. Результирующий куб пространства-времени может быть использован как входной любым инструментом группы Прогнозирование временных рядов.

Параметры

ПодписьОписаниеТип данных
Входной куб пространство-время

Куб пространство-время, из которого будет создан поднабор. У файлов куба пространство-время расширение - .nc; они создаются разнообразными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей.

File
Выходной куб пространство-время

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

File
Метод пространственного поднабора

Определяет метод, который будет использован для создания пространственного поднабора входного куба пространство-время. Местоположения входного куба пространство-время, отвечающие этому критерию пространственного поднабора, будут включены в выходной куб пространство-время.

  • ОбъектыКласс объектов полигонов, точек или линий, который будет использован для определения поднабора во входном кубе пространство-время. Параметр Пространственные отношения определяет, как векторный слой соотносится с поднабором куба пространство-время.
  • ЭкстентЭкстент, указанный в параметре Экстент будет использован для создания пространственного поднабора входного куба пространство-время. Выходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые пересекают экстент.
  • Куб пространство-времяМестоположения куба пространство-время, указанные в параметре Входной пространственный поднабор куба, будут использованы для создания поднабора куба пространство-время. Параметр Пространственные отношения определяет, как этот куб пространство-время соотносится с поднабором входного куба пространство-время.
  • НетПространственный поднабор не применим к входному кубу пространство-время.
  • ОбъектыКласс объектов полигонов, точек или линий, который будет использован для определения поднабора во входном кубе пространство-время. Параметр spatial_relationship определяет, как векторный слой соотносится с поднабором куба пространство-время.
  • ЭкстентЭкстент, указанный в параметре spatial_extent будет использован для создания пространственного поднабора входного куба пространство-время. Выходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые пересекают экстент.
  • Куб пространство-времяМестоположения куба пространство-время, указанные в параметре in_spatial_cube, будут использованы для создания поднабора куба пространство-время. Параметр spatial_relationship определяет, как этот куб пространство-время соотносится с поднабором входного куба пространство-время.
  • НетПространственный поднабор не применим к входному кубу пространство-время.
String
Метод временного поднабора

Определяет метод, который будет использован для создания временного поднабора входного куба пространство-время. Временные шаги входного куба пространство-время, отвечающие этому критерию временного поднабора, будут включены в выходной куб пространство-время.

  • Определен пользователемВременной диапазон, определенный значениями Время начала или Время окончания в параметре Временной интервал поднабора будет использован для создания временного поднабора входного куба пространство-время.
  • Число временных шаговЧисло временных шагов в промежутке от начала до окончания входного куба пространство-время будет использовано для создания временного поднабора входного куба пространство-время. Число временных шагов для удаления определяется значениями От начала или От окончания параметра Число временных шагов для удаления.
  • Куб пространство-времяВременной экстент куба пространство-время, указанные в параметре Входной временной поднабор куба, будут использованы для создания временного поднабора куба пространство-время.
  • НетВременной поднабор не применим к входному кубу пространство-время.
String
Входные объекты поднабора
(Дополнительный)

Класс объектов, содержащий полигоны, точки или линии для определения поднабора в кубе пространство-время. Пространственные отношения между входными объектами поднабора и кубом пространство-время указываются в параметре Пространственные отношения.

Feature Layer
Пространственное отношение
(Дополнительный)

Определяет пространственные отношения между Входными объектами поднабора или Входным пространственным поднабором куба и входным кубом пространство-время для создания поднабора куба пространство-время. Доступные опции пространственных отношений зависят от геометрии входного куба пространство-время и входных объектов поднабора или входного пространственного поднабора куба.

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

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

Extent
Входной пространственный поднабор куба
(Дополнительный)

Куб пространство-время, который определяет пространственный поднабор входного куба пространство-время. Пространственные отношения между входным пространственным поднабором куба и кубом пространство-время указываются в параметре Пространственные отношения.

File
Временной интервал поднабора
(Дополнительный)

Временной интервал, который определяет временной поднабор входного куба пространство-время. Все временные шаги в пределах этого временного интервала, или которые содержат значения Времени начала или Времени окончания, будут включены в выходной куб пространство-время.

Value Table
Число временных шагов для удаления
(Дополнительный)

Число временных шагов от времени начала или времени окончания входного куба пространство-время, которые будут удалены в выходном кубе пространство-время.

Value Table
Входной временной поднабор куба
(Дополнительный)

Куб пространство-время, который определяет временной поднабор входного куба пространство-время. Временной экстент временного поднабора куба определяет временной экстент выходного куба пространство-время. Все временные шаги в пределах временного экстента входного временного поднабора куба, или которые содержат время начала или время окончания временного поднабора куба будут включены в выходной куб пространство-время.

File

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

Определяет метод, который будет использован для создания пространственного поднабора входного куба пространство-время. Местоположения входного куба пространство-время, отвечающие этому критерию пространственного поднабора, будут включены в выходной куб пространство-время.

  • FEATURESКласс объектов полигонов, точек или линий, который будет использован для определения поднабора во входном кубе пространство-время. Параметр spatial_relationship определяет, как векторный слой соотносится с поднабором куба пространство-время.
  • EXTENTЭкстент, указанный в параметре spatial_extent будет использован для создания пространственного поднабора входного куба пространство-время. Выходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые пересекают экстент.
  • SPACE_TIME_CUBEМестоположения куба пространство-время, указанные в параметре in_spatial_cube, будут использованы для создания поднабора куба пространство-время. Параметр spatial_relationship определяет, как этот куб пространство-время соотносится с поднабором входного куба пространство-время.
  • NONEПространственный поднабор не применим к входному кубу пространство-время.
String
temporal_subset_method

Определяет метод, который будет использован для создания временного поднабора входного куба пространство-время. Временные шаги входного куба пространство-время, отвечающие этому критерию временного поднабора, будут включены в выходной куб пространство-время.

  • USER_DEFINEDВременной диапазон, определенный значениями времени начала или времени окончания в параметре time_span_subset будет использован для создания временного поднабора входного куба пространство-время.
  • NUMBER_OF_TIME_STEPSЧисло временных шагов в промежутке от начала до окончания входного куба пространство-время будет использовано для создания временного поднабора входного куба пространство-время. Число временных шагов для удаления определяется значениями от начала или от окончания параметра remove_time_steps для удаления.
  • SPACE_TIME_CUBEВременной экстент куба пространство-время, указанные в параметре in_temporal_cube, будут использованы для создания временного поднабора куба пространство-время.
  • NONEВременной поднабор не применим к входному кубу пространство-время.
String
in_subset_features
(Дополнительный)

Класс объектов, содержащий полигоны, точки или линии для определения поднабора в кубе пространство-время. Пространственные отношения между входными объектами поднабора и кубом пространство-время указываются в параметре spatial_relationship.

Feature Layer
spatial_relationship
(Дополнительный)

Пространственные отношения между in_subset_features или in_spatial_cube куба и входным кубом пространство-время для создания поднабора куба пространство-время. Доступные опции пространственных отношений зависят от геометрии входного куба пространство-время и входных объектов поднабора или входного пространственного поднабора куба.

  • INTERSECTВыходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые пересекают in_subset_features или in_spatial_cube. Это значение по умолчанию
  • CONTAINSВыходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые содержат in_subset_features или in_spatial_cube.
  • WITHINВыходной куб пространство-время будет включать все местоположения входного куба пространство-время, которые находятся внутри in_subset_features или in_spatial_cube.
  • HAVE_THEIR_CENTER_INВыходной куб пространство-время будет включать все местоположения входного куба пространство-время, центр которых находится внутри 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

Пример кода

SubsetSpaceTimeCube, пример 1 (окно Python)

Скрипт 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")
SubsetSpaceTimeCube, пример 2 (автономный скрипт)

Следующий автономный 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")