Описание куба пространство-время (Инструменты пространственно-временных закономерностей)

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

Суммирует содержание и характеристики в кубе Пространство-Время netCDF. Инструмент описывает временной и пространственный экстент куба пространство-время, переменные в кубе пространство-время, анализ, выполненный для каждой переменной и 2D и 3D темы отображения, доступные для каждой переменной.

Иллюстрация

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

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

Этот инструмент принимает файлы netCDF, созданные различными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей.

Более подробно о создании куба пространство-время
Этот инструмент потенциально можно применять для следующих случаев:
- Определить время и геометрию куба пространство-время Это может помочь при выборе подходящих параметров для инструментов в группе инструментов Анализ пространственно-временных закономерностей и группе инструментов Прогнозирование временных рядов.
- Просмотреть историю анализа, выполненного для куба пространство-время Это показывает, какие темы отображения доступны для инструментов Визуализация куба Пространство-Время в 2D и Визуализация куба Пространство-Время в 3D. Опции тем отображения для слоя куба пространство-время не перечислены.
  
  Более подробно о темах визуализации отображения для слоя куба пространство-время
Сообщения геообработки, описывающие характеристики и содержание куба пространство-время. Чтобы получить доступ к сообщениям, поместите курсор мыши над индикатором выполнения и щелкните всплывающую кнопку или разверните раздел сообщений в панели Геообработка. Сообщения включают следующую информацию:
- Дату и время создания куба пространство-время.
- Версию ArcGIS Pro, используемую для создания куба пространство-время.
- Тип куба пространство-время. Возможные типы: Куб заданных местоположений, Куб сетки, Куб заданных местоположений (из многомерного растра), Куб прогноза и Поднабор куба. Более подробно о различных типах кубов пространство-время см. Как работает инструмент Создать куб Пространство-Время.
  
  Примечание:
  
  Если куб пространство-время был создан с использованием инструмента Создать куб пространство-время из многомерного растрового слоя в ArcGIS Pro 2.8 или более ранней версии, типом отображения будет Куб заданных местоположений, а не Куб заданных местоположений (из многомерного растра).
- Раздел Характеристики куба пространство-время, описывающий свойства пространства и времени в кубе пространство-время. Более подробно об этих характеристиках см. Как работает инструмент Создать куб пространство-время.
- Раздел Содержание куба пространство-время, где каждая строка соответствует переменной во входном кубе пространство-время. Каждая строка содержит суммарную статистику для переменной, указание на инструмент, с помощью которого была создана переменная (вместе с типами агрегации и заполнения), опции тем отображения, доступные для визуализации в слое куба пространство-время и инструменты в группе Визуализация куба пространство-время.
- Если куб пространство-время был создан с использованием инструмента Создать куб пространство-время по агрегации точек, сообщения будут содержать один или несколько подразделов в разделе Местоположения и бины куба пространство-время. Подраздел Количество и каждый дополнительный подраздел Поле суммирования содержит число бинов и местоположения, в которых содержится хотя бы одна точка. Разреженность (процент бинов, в которых не содержится ни одной точки) также указан в таблице, в подразделе Количество.
- Если куб пространство-время был создан при помощи инструмента из группы инструментов Прогнозирование временных рядов, в сообщениях будет подраздел Подробности прогноза, в котором приводится информация о примененных методах прогнозирования.
- Сообщения будут включать один или несколько разделов под заголовком Тренды куба пространство-время. В этом разделе приводится обзор Статистики трендов Манна-Кендалла для каждой переменной в кубе пространство-время.
Если для параметра Таблица выходных характеристик задано значение, инструмент создает таблицу, в которой будут приведены характеристики пространства и времени входного куба пространство-время. Значения в таблице характеристик также отображаются в сообщениях геообработки. Эти значения могут использоваться в ModelBuilder для создания рабочего процесса анализа пространства и времени.
Если для параметра Объекты выходного пространственного экстента указано значение, инструмент создаст класс полигональных объектов, содержащий прямоугольник, представляющий экстент входного куба пространство-время. Если куб пространство-время был создан при помощи инструмента Создать куб пространство-время из указанных местоположений, использующий одну точку, вместо полигонального будет создан класс точечных объектов. Если куб пространство-время был создан с применением шаблона куба, экстент будет соответствовать шаблону куба.
Значение параметра Объекты выходного пространственного экстента может не отражать экстент местоположений куба пространство-время, если указан шаблон куба или использован параметр среды Экстент при создании куба пространство-время.

Подпись	Объяснение	Тип данных
Входной куб пространство-время	Куб пространство-время для описания. Кубы пространство-время имеют расширение файла `.nc` и создаются с помощью различных инструментов в наборе инструментов Углубленный анализ пространственно-временных закономерностей.	File
Выходная таблица характеристик (Дополнительный)	Таблица, содержащая итоговую информацию о входном кубе пространство-время.	Table
Объекты выходного пространственного экстента (Дополнительный)	Класс объектов, содержащий прямоугольник, соответствующий пространственному экстенту входного куба пространство-время.	Feature Class

arcpy.stpm.DescribeSpaceTimeCube(in_cube, {out_characteristics_table}, {out_spatial_extent})

Имя	Объяснение	Тип данных
in_cube	Куб пространство-время для описания. Кубы пространство-время имеют расширение файла `.nc` и создаются с помощью различных инструментов в наборе инструментов Углубленный анализ пространственно-временных закономерностей.	File
out_characteristics_table (Дополнительный)	Таблица, содержащая итоговую информацию о входном кубе пространство-время.	Table
out_spatial_extent (Дополнительный)	Класс объектов, содержащий прямоугольник, соответствующий пространственному экстенту входного куба пространство-время.	Feature Class

Пример кода

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

Следующий скрипт окна Python демонстрирует использование функции DescribeSpaceTimeCube.

import arcpy
arcpy.stpm.DescribeSpaceTimeCube("input_cube.nc")

DescribeSpaceTimeCube, пример 2 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует, как использовать функцию DescribeSpaceTimeCube.

# Use the output from the Describe Space Time Cube tool to
# test whether a set of space-time cubes match a set of criteria. Input the
# space-time cubes that pass the criteria to the Evaluate Forecasts By Location
# tool.

# Import system modules
import os
import glob
import arcpy

# Set Workspace
arcpy.env.workspace = r"C:\Describe"
out_gdb = os.path.join(arcpy.env.workspace, "GDB.gdb")
arcpy.env.overwriteOutput = True

# Assign global variables
check_fields = ['MIN_X', 'MIN_Y', 'MAX_X', 'MAX_Y', 'NUM_FORECAST',
          'FIRST_FORECAST_START', 'FIRST_FORECAST_END',
          'LAST_FORECAST_START','LAST_FORECAST_END', 'VALIDATION_TIME_STEPS']

# Iterate through all the space-time cubes in a folder
evaluate_cubes = ''

for cube in glob.glob(os.path.join(arcpy.env.workspace, '*.nc')):
    cube_suffix = os.path.basename(cube)
    cube_name = os.path.splitext(cube_suffix)[0]

    out_describe_fc_name = ("describe" + "_{}").format(cube_name)
    out_table = os.path.join(out_gdb, out_describe_fc_name)

    # Run the Describe Space Time Cube tool and save a characteristics table into a GDB
    arcpy.stpm.DescribeSpaceTimeCube(cube, out_table, None)
    lstFields = arcpy.ListFields(out_table)

    for field in lstFields:
        # Check if the space-time cube is a forecast cube
        if field.name == "NUM_FORECAST":
            with arcpy.da.SearchCursor(out_table, check_fields) as cursor:
                # Check if the extent, start forecast, end forecast, and validation steps
                # are all the same
                for row in cursor:
                    if str(row[0]) == '-13847325.1116' and str(row[1]) == '3833847.5631' and \
                       str(row[2]) == '-12704362.5439' and str(row[3]) == '5161307.7693' and \
                       str(row[4]) == '14' and str(row[5]) == '2022-02-27 00:00:02' and \
                       str(row[6]) == '2022-02-28 00:00:01' and str(row[7]) == '2022-03-12 00:00:01' and \
                       str(row[8]) == '2022-03-13 00:00:01' and str(row[9]) == '14':

                        # Add the space-time cubes that match the criteria to a string
                        # that will be input into the Evaluate Forecasts By Location tool
                        evaluate_cubes += cube + ';'

# Run the Evaluate Forecasts By Location tool
evaluate_output = os.path.join(out_gdb, "Evaluate_Covid19_Forecasts")

arcpy.stpm.EvaluateForecastsByLocation(evaluate_cubes.replace('\\', '/'), evaluate_output, None, "USE_VALIDATION")

Параметры среды

Этот инструмент не использует параметры среды геообработки.

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да