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

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

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

Иллюстрация

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

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

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

    Более подробно о создании куба пространство-время

  • Этот инструмент потенциально можно применять для следующих случаев:

  • Сообщения геообработки, описывающие характеристики и содержание куба пространство-время. Чтобы получить доступ к сообщениям, поместите курсор мыши над индикатором выполнения и щелкните всплывающую кнопку или разверните раздел сообщений в панели Геообработка. Сообщения включают следующую информацию:

    • Дату и время создания куба пространство-время.
    • Версию ArcGIS AllSource, используемую для создания куба пространство-время.
    • Тип куба пространство-время. Возможные типы: Куб заданных местоположений, Куб сетки, Куб заданных местоположений (из многомерного растра), Куб прогноза и Поднабор куба. Более подробно о различных типах кубов пространство-время см. Как работает инструмент Создать куб Пространство-Время.
      Примечание:

      Если куб пространство-время был создан с использованием инструмента Создать куб пространство-время из многомерного растрового слоя, в ArcGIS Pro 2.8 или более ранней версии, тип отображения будет Куб заданных местоположений, а не Куб заданных местоположений (из многомерного растра).

    • Раздел Характеристики куба пространство-время, описывающий свойства пространства и времени в кубе пространство-время. Подробнее см. раздел Как работает инструмент Создать куб Пространство-Время.
    • Раздел Содержание куба пространство-время, где каждая строка соответствует переменной во входном кубе пространство-время. Каждая строка содержит суммарную статистику для переменной, указание на инструмент, с помощью которого была создана переменная (вместе с типом агрегации и заполнения) и опции тем отображения, доступные для инструментов Визуализация куба Пространство-Время в 2D и Визуализация куба Пространство-Время в 3D.
    • Если куб пространство-время был создан с использованием инструмента Создать куб Пространство-Время по агрегации точек, сообщения будут содержать один или несколько подразделов, в разделе Местоположения и бины куба пространство-время. Подраздел Количество и каждый дополнительный подраздел Поле суммирования содержит число бинов и местоположения, в которых содержится хотя бы одна точка. Разреженность (процент бинов, в которых не содержится ни одной точки) также указан в таблицу, в подразделе Количество.
    • Если куб пространство-время был создан при помощи инструмента из группы инструментов Прогнозирование временных рядов, в сообщениях будет подраздел Подробности прогноза, в котором приводится информация о примененных методах прогнозирования.
    • Сообщения будут включать один или несколько разделов под заголовком Тренды куба пространство-время. В этом разделе приводится обзор Статистики трендов Манна-Кендалла для каждой переменной в кубе пространство-время.
  • Если значение указано для параметра Выходные характеристики куба пространство-время, инструмент создает таблицу, в которой будут приведены характеристики пространства и времени входного куба пространство-время. Значения в таблице характеристик также отображаются в сообщениях геообработки. Эти значения могут использоваться в 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 Forecast 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 Forecast by Location tool
                        evaluate_cubes += cube + ';'


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

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

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

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