Подпись | Описание | Тип данных |
Входной куб Пространство-Время | Куб Пространство-Время, который будет описан. У файлов куба пространство-время расширение - .nc; они создаются разнообразными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей. | File |
Выходная таблица характеристик (Дополнительный) | Таблица, содержащая итоговую информацию о входном кубе пространство-время. | Table |
Объекты выходного пространственного экстента (Дополнительный) | Класс объектов, содержащий прямоугольник, соответствующий пространственному экстенту входного куба пространство-время. | Feature Class |
Краткая информация
Суммирует содержание и характеристики в кубе Пространство-Время netCDF. Инструмент описывает временной и пространственный экстент куба пространство-время, переменные в кубе, анализ, выполненный для каждой переменной и темы отображения 2D и 3D, доступные для каждой переменной.
Иллюстрация
Использование
Этот инструмент использует файлы netCDF, созданные инструментами в Наборе инструментов Углубленный анализ пространственно-временных закономерностей.
Этот инструмент потенциально можно применять для следующих случаев:
- Определить время и геометрию куба пространство-время Это пригодится при выборе подходящих параметров в инструментах групп Анализ пространственно-временных закономерностей и Прогнозирование временных рядов.
- Просмотреть историю анализа, выполненного для куба пространство-время Посмотреть, какие Темы отображения доступны для инструментов Визуализация куба Пространство-Время в 2D и Визуализация куба Пространство-Время в 3D.
Сообщения геообработки, описывающие характеристики и содержание куба пространство-время. Чтобы получить доступ к сообщениям, поместите курсор мыши над индикатором выполнения и щелкните всплывающую кнопку или разверните раздел сообщений в панели Геообработка. Сообщения включают следующую информацию:
- Дату и время создания куба пространство-время.
- Версию ArcGIS AllSource, используемую для создания куба пространство-время.
- Тип куба пространство-время. Возможные типы: Куб заданных местоположений, Куб сетки, Куб заданных местоположений (из многомерного растра), Куб прогноза и Поднабор куба. Более подробно о различных типах кубов пространство-время см. Как работает инструмент Создать куб Пространство-Время.
Примечание:
Если куб пространство-время был создан с использованием инструмента Создать куб пространство-время из многомерного растрового слоя, в ArcGIS Pro 2.8 или более ранней версии, тип отображения будет Куб заданных местоположений, а не Куб заданных местоположений (из многомерного растра).
- Раздел Характеристики куба пространство-время, описывающий свойства пространства и времени в кубе пространство-время. Подробнее см. раздел Как работает инструмент Создать куб Пространство-Время.
- Раздел Содержание куба пространство-время, где каждая строка соответствует переменной во входном кубе пространство-время. Каждая строка содержит суммарную статистику для переменной, указание на инструмент, с помощью которого была создана переменная (вместе с типом агрегации и заполнения) и опции тем отображения, доступные для инструментов Визуализация куба Пространство-Время в 2D и Визуализация куба Пространство-Время в 3D.
- Если куб пространство-время был создан с использованием инструмента Создать куб Пространство-Время по агрегации точек, сообщения будут содержать один или несколько подразделов, в разделе Местоположения и бины куба пространство-время. Подраздел Количество и каждый дополнительный подраздел Поле суммирования содержит число бинов и местоположения, в которых содержится хотя бы одна точка. Разреженность (процент бинов, в которых не содержится ни одной точки) также указан в таблицу, в подразделе Количество.
- Если куб пространство-время был создан при помощи инструмента из группы инструментов Прогнозирование временных рядов, в сообщениях будет подраздел Подробности прогноза, в котором приводится информация о примененных методах прогнозирования.
- Сообщения будут включать один или несколько разделов под заголовком Тренды куба пространство-время. В этом разделе приводится обзор Статистики трендов Манна-Кендалла для каждой переменной в кубе пространство-время.
Если значение указано для параметра Выходные характеристики куба пространство-время, инструмент создает таблицу, в которой будут приведены характеристики пространства и времени входного куба пространство-время. Значения в таблице характеристик также отображаются в сообщениях геообработки. Эти значения могут использоваться в ModelBuilder для создания рабочего процесса анализа пространства и времени.
Если для параметра Объекты выходного пространственного экстента указано значение, инструмент создаст класс полигональных объектов, содержащий прямоугольник, представляющий экстент входного куба пространство-время. Если куб пространство-время был создан при помощи инструмента Создать Куб пространство-время из указанных местоположений, использующий одну точку, вместо полигонального будет создан класс точечных объектов. Если куб пространство-время был создан с применением шаблона куба, экстент будет соответствовать шаблону куба.
Значение параметра Объекты выходного пространственного экстента может не отражать экстент местоположений куба пространство-время, если указан шаблон куба или использован параметр среды Экстент при создании куба пространство-время.
Параметры
arcpy.stpm.DescribeSpaceTimeCube(in_cube, {out_characteristics_table}, {out_spatial_extent})
Имя | Описание | Тип данных |
in_cube | Куб Пространство-Время, который будет описан. У файлов куба пространство-время расширение - .nc; они создаются разнообразными инструментами в наборе инструментов Углубленный анализ пространственно-временных закономерностей. | File |
out_characteristics_table (Дополнительный) | Таблица, содержащая итоговую информацию о входном кубе пространство-время. | Table |
out_spatial_extent (Дополнительный) | Класс объектов, содержащий прямоугольник, соответствующий пространственному экстенту входного куба пространство-время. | Feature Class |
Пример кода
Пример скрипта в окне Python для использования функции DescribeSpaceTimeCube.
import arcpy
arcpy.stpm.DescribeSpaceTimeCube("input_cube.nc")
Следующий автономный 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")