使用时序模型进行预测 (GeoAI 工具)

汇总

将使用基于深度学习的时间序列预测模型来预测时空立方体每个位置的值，该模型已使用训练时序预测模型工具进行训练。

用法

必须为 ArcGIS Pro 中的 Python 安装适当的深度学习框架。

了解如何安装 ArcGIS 深度学习框架
输入是 Esri 模型定义文件 (.emd) 或深度学习包文件 (.dlpk)，可使用训练时序预测模型工具进行创建。
此工具接受通过聚合点创建时空立方体、通过已定义位置创建时空立方体以及通过多维栅格图层创建时空立方体和子集化时空立方体工具创建的 netCDF 数据。
该工具将使用基于深度学习的时间序列预测模型。深度学习模型具有很强的学习能力，适用于遵循复杂趋势且难以用简单数学函数建模的时间序列。但是，它们需要更多的训练数据来学习这些复杂趋势，并且在训练和推断过程中需要使用更多的计算资源。使用 GPU 可以提高工具的性能。
可使用异常值选项参数检测每个位置的时间序列值中在统计上显著的异常值。

了解有关检测时间序列异常值的详细信息
该工具支持使用利用模型扩展功能创建的第三方时间序列模型。模型可扩展性功能可使用自定义深度学习模型文件 (.dlpk) 启用时间序列预测任务；该文件无需使用训练时序预测模型工具进行创建。

了解有关将第三方时间序列模型与 ArcGIS 配合使用的详细信息。
要使用 GPU 运行此工具，请将处理器类型环境设置为 GPU。如果您具有多个 GPU，则改为指定 GPU ID 环境。
该工具将使用单一的全球预测模型，该模型已根据来自每个位置的时间序列数据进行训练。
输出要素参数值将添加到内容窗格中，并基于保存的最佳模型预测时间步长进行渲染。
该工具会创建地理处理消息和弹出图表，以用于了解和可视化预测结果。这些消息将包含有关时空立方体结构以及均方根误差值的汇总统计数据的信息。可以使用浏览导航工具单击要素以在弹出窗格中显示一个折线图，图中会显示该时空立方体的值以及该位置的拟合值和预测值。
有关运行此工具的要求以及您可能遇到的问题的信息，请参阅深度学习常见问题。

标注	说明	数据类型
输入时间序列数据	包含将用于预测未来时间步长的变量的 netCDF 立方体。该文件必须具有 `.nc` 文件扩展名，并且必须是使用通过聚合点创建时空立方体、通过已定义位置创建时空立方体或通过多维栅格图层创建时空立方体工具创建的。	File
模型定义	将用于进行预测的经过训练的深度学习模型文件（`.dlpk` 或 `.emd`）。该模型可以使用训练时序预测模型工具进行训练。该 `.dlpk` 文件也可以是第三方时间序列模型。注意：第三方时间序列模型 `.dlpk` 文件可能包含有害代码。仅当您信任模型的源时才能使用这些模型。	File
输出要素	时空立方体中所有位置的包含了预测值的输出要素类将存储为字段。图层显示了最后时间步长的预测结果，并包含了为每个位置显示时间序列和预测的弹出图表。注: 当使用第三方时间序列模型时，模型参数将根据 `.dlpk` 文件中指定的参数进行更新。要了解有关定义模型参数的详细信息，请参阅在 ArcGIS 中使用第三方时间序列模型中的 getParameterInfo 部分。	Feature Class
预测时间步长数	一个正整数，指定将用于预测分析变量的时间步长数。默认值为 2。对于单步预测，该值不能超过输入时空立方体中总时间步数的 50％；对于多步预测，该值不能超过训练时序预测模型工具中序列长度参数值的 50％。	Long
匹配解释变量（可选）	字段名称从预测集到训练集的映射。如果训练集和预测集的字段名称不同，请使用此参数。值为预测数据集中与输入时间序列数据中的字段名称相匹配的字段名称。值表列： Prediction—The field names in the prediction dataset. Training—The field names in the input time series data.	Value Table
输出立方体（可选）	输出时空立方体（`.nc` 文件），其中包含输入时空立方体的值，并追加了预测时间步长。使用可视化 3D 时空立方体工具同时查看所有观察值和预测值。	File
异常值选项（可选）	指定是否将识别具有统计意义的时间序列异常值。无—不会识别异常值。这是默认设置。识别异常值—将使用广义 ESD 测试来识别异常值。	String
置信度级别（可选）	指定将用于时间序列异常值测试的置信度。 90%—测试置信度将为 90％。这是默认设置。 95%—测试置信度将为 95％。 99%—测试置信度将为 99％。	String
最大异常值数	每个位置可以声明为异常值的最大时间步数。默认值对应于输入时空立方体的时间步数的 5%（向下舍入）（将始终使用至少为 1 的值）。该值不能超过时间步数的 20％。	Long
分析变量	数据集中将被预测到未来时间步长的数值变量。	String
模型参数（可选）	第三方模型在执行预测时将使用的附加参数。受支持的模型参数包含 `sequence_length` 和 `batch_size`。该参数仅适用于使用第三方模型的预测。当使用第三方时间序列模型时，模型参数将根据 `.dlpk` 文件中指定的参数进行更新。要了解有关定义模型参数的详细信息，请参阅在 ArcGIS 中使用第三方时间序列模型中的 getParameterInfo 部分。值表列： Name—The name of the function argument. Value—The value of the function argument.	Value Table

arcpy.geoai.ForecastUsingTimeSeriesModel(in_cube, in_model_definition, out_features, number_of_timesteps_to_forecast, {match_explanatory_variables}, {out_cube}, {outlier_option}, {level_of_confidence}, maximum_number_of_outliers, analysis_variable, {arguments})

名称	说明	数据类型
in_cube	包含将用于预测未来时间步长的变量的 netCDF 立方体。该文件必须具有 `.nc` 文件扩展名，并且必须是使用通过聚合点创建时空立方体、通过已定义位置创建时空立方体或通过多维栅格图层创建时空立方体工具创建的。	File
in_model_definition	将用于进行预测的经过训练的深度学习模型文件（`.dlpk` 或 `.emd`）。该模型可以使用训练时序预测模型工具进行训练。该 `.dlpk` 文件也可以是第三方时间序列模型。注意：第三方时间序列模型 `.dlpk` 文件可能包含有害代码。仅当您信任模型的源时才能使用这些模型。	File
out_features	时空立方体中所有位置的包含了预测值的输出要素类将存储为字段。图层显示了最后时间步长的预测结果，并包含了为每个位置显示时间序列和预测的弹出图表。注: 当使用第三方时间序列模型时，模型参数将根据 `.dlpk` 文件中指定的参数进行更新。要了解有关定义模型参数的详细信息，请参阅在 ArcGIS 中使用第三方时间序列模型中的 getParameterInfo 部分。	Feature Class
number_of_timesteps_to_forecast	一个正整数，指定将用于预测分析变量的时间步长数。默认值为 2。对于单步预测，该值不能超过输入时空立方体中总时间步数的 50％；对于多步预测，该值不能超过训练时序预测模型工具中 `sequence_length` 参数值的 50％。	Long
match_explanatory_variables [match_explanatory_variables,...] （可选）	字段名称从预测集到训练集的映射。如果训练集和预测集的字段名称不同，请使用此参数。值为预测数据集中与输入时间序列数据中的字段名称相匹配的字段名称。值表列： `Prediction`—The field names in the prediction dataset. `Training`—The field names in the input time series data.	Value Table
out_cube （可选）	输出时空立方体（`.nc` 文件），其中包含输入时空立方体的值，并追加了预测时间步长。使用可视化 3D 时空立方体工具同时查看所有观察值和预测值。	File
outlier_option （可选）	指定是否将识别具有统计意义的时间序列异常值。 `NONE`—不会识别异常值。这是默认设置。 `IDENTIFY`—将使用广义 ESD 测试来识别异常值。	String
level_of_confidence （可选）	指定将用于时间序列异常值测试的置信度。 `90%`—测试置信度将为 90％。这是默认设置。 `95%`—测试置信度将为 95％。 `99%`—测试置信度将为 99％。	String
maximum_number_of_outliers	每个位置可以声明为异常值的最大时间步数。默认值对应于输入时空立方体的时间步数的 5%（向下舍入）（将始终使用至少为 1 的值）。该值不能超过时间步数的 20％。	Long
analysis_variable	数据集中将被预测到未来时间步长的数值变量。	String
arguments [arguments,...] （可选）	第三方模型在执行预测时将使用的附加参数。受支持的模型参数包含 `sequence_length` 和 `batch_size`。该参数仅适用于使用第三方模型的预测。当使用第三方时间序列模型时，模型参数将根据 `.dlpk` 文件中指定的参数进行更新。要了解有关定义模型参数的详细信息，请参阅在 ArcGIS 中使用第三方时间序列模型中的 getParameterInfo 部分。值表列： `Name`—The name of the function argument. `Value`—The value of the function argument.	Value Table

代码示例

ForecastUsingTimeSeriesModel 示例（独立脚本）

此示例展示了如何使用 ForecastUsingTimeSeriesModel 函数。

# Description: Forecast a time series model on space-time cube data with the trained model
#              obtained by the TrainTimeSeriesForecastingModel function.

# Import system modules
import arcpy
import os

# Set local variables
datapath  = "path_to_data_for_forecasting"
out_path = "path_to_gdb_for_forecasting"

model_path = os.path.join(out_path, "model.dlpk")
in_cube = os.path.join(datapath, "test_data")
output_features = os.path.join(out_path, "forecasted_feature.gdb", "forecasted")

# Run Forecast Using Time Series Model
r = arcpy.geoai.ForecastUsingTimeSeriesModel(
    in_cube,
    model_path,
    output_features,
    number_of_timesteps_to_forecast=2,
    match_explanatory_variables=None
)

环境

输出坐标系, 地理变换, 处理器类型, GPU ID

许可信息

基本: 否
标准: 否
高级: 是

使用时序模型进行预测 (GeoAI 工具)

汇总

用法

参数

注意：

注:

环境

许可信息

相关主题