| ラベル | 説明 | データ タイプ |
入力予測時空間キューブ
| 比較対象の予測を含む入力時空間キューブ。比較する際は、すべての予測キューブを元の同じ時系列データから作成する必要があります。 | File |
出力フィーチャ
| 時空間キューブの位置と、各位置で選択した方法の予測値を含むフィールドを表す、新しい出力フィーチャクラス。フィーチャのポップアップには、元の時系列データのチャートとすべての方法の予測が表示されます。 | Feature Class |
出力時空間キューブ
(オプション) | 元の時系列データと各位置で選択された方法の予測を含む出力時空間キューブ (*.nc ファイル)。[時空間キューブを 3D で視覚化 (Visualize Space Time Cube in 3D)] ツールを使用すると、元の値と予測値を同時に表示できます。 | File |
検証結果を使用して評価
(オプション) | 位置に対する予測方法を、最小の検証 RMSE を使用して決定するか、最小の予測 RMSE を使用して決定するかを指定します。
| Boolean |
サマリー
時空間キューブの各位置に対して、複数の予測結果から最も正確な予測を選択します。このツールを使用すると、時系列予測ツールセット内の複数のツールを同じ時系列データで使用し、各位置に対して最適な予測を選択できます。
図
![[位置による予測評価 (Evaluate Forecasts By Location)] ツールの図](GUID-4F9EA010-E3FB-4670-BADD-14980ACC1B25-web.png "[位置による予測評価 (Evaluate Forecasts By Location)] ツールの図")
使用法
[入力予測時空間キューブ] パラメーターで指定するすべての時空間キューブは、時系列予測ツールセット内のツールで同じ入力時空間キューブを使用して作成する必要があります。
このツールは、各位置で検証または予測の最小二乗平均平方根誤差 (RMSE) を提供する予測方法を特定します。このため、互いに近い位置に対して異なる方法が特定される可能性があります。たとえば、データが郡の年間人口を表す場合に、1 つの郡ではフォレストベース方法が使用され、2 つの隣接する郡ではゴンペルツ曲線と季節指数平滑法が使用される場合があります。各位置に対して異なる形状によるさまざまな予測方法を使用することが理にかなっているかどうかを検討し、各位置に対してその予測方法を選択したことで、その位置の予測 RMSE が大幅に減少したか、検証 RMSE が大幅に減少したかを判断します。各位置に対して単一の方法を使用することが、異なる方法を使用するのとほぼ同等に正確である場合は、最節約原理により、すべての位置に対して単一の予測方法を使用することをお勧めします。
[出力フィーチャ] は、各位置で選択された方法の最後に予測された時間ステップに基づくレンダリングで [コンテンツ] ウィンドウに追加されます。
-
このツールでは、結果の把握と視覚化に役立つジオプロセシング メッセージと対話式のポップアップ チャートが作成されます。メッセージには、時空間キューブの構造、RMSE 値の要約統計量、および各予測方法で表される位置数のサマリーに関する情報が含まれています。[マップ操作] ツールを使用してフィーチャをクリックすると、[ポップアップ] ウィンドウにライン チャートが表示され、時空間キューブの値と各予測方法の予測値が表示されます。その位置で選択された予測方法が、チャートでハイライト表示されます。
[フォレストベース予測 (Forest-based Forecast)] ツールを使用して作成した予測方法は通常、位置の時系列に最もフィットしますが、値の予測が他の方法に比べて正確でないことがよくあります。入力予測時空間キューブのいずれかがフォレストベース方法を表している場合、[検証結果を使用して評価] パラメーターをオンにしておくことをお勧めします。
入力予測時空間キューブのいずれかが他のキューブとは異なる将来の時間ステップ数を予測した場合、出力には最小の時間ステップ数に対する予測が含まれます。たとえば、2 つの時空間キューブが指定され、最初のキューブが 3 つの時間ステップ、2 つ目のキューブが 5 つの時間ステップを予測している場合、[出力フィーチャ] および [出力時空間キューブ] が予測する将来の時間ステップ数は 3 になります。
[検証結果を使用して評価] パラメーターがオフの場合、Diebold-Mariano (DM) または Harvey, Leybourne, and Newbold (HLN) 検定が、選択された方法と各位置での他のすべての方法との比較に使用されます。これらの検定では、時系列に対して、選択された方法が選択されなかった方法よりも大幅にフィットするかどうかが判断されます。
[入力予測時空間キューブ] パラメーターで指定した時空間キューブで外れ値を検出することを以前に選択した場合、この情報は出力フィーチャにも出力時空間キューブにも含まれません。
[入力予測時空間キューブ] パラメーターで指定される時空間キューブは、キューブが netCDF ファイルとしてすでに保存されていれば ModelBuilder の中間データ変数として使用できません。いずれかの時空間キューブがモデルに作成されており、ファイルとしてまだ存在しない場合は、モデル全体を実行する前に ModelBuilder の各ツールを実行する必要があります。
パラメーター
arcpy.stpm.EvaluateForecastsByLocation(in_cubes, output_features, {output_cube}, {evaluate_using_validation_results})| 名前 | 説明 | データ タイプ |
in_cubes [in_cubes,...] | 比較対象の予測を含む入力時空間キューブ。比較する際は、すべての予測キューブを元の同じ時系列データから作成する必要があります。 | File |
output_features | 時空間キューブの位置と、各位置で選択した方法の予測値を含むフィールドを表す、新しい出力フィーチャクラス。フィーチャのポップアップには、元の時系列データのチャートとすべての方法の予測が表示されます。 | Feature Class |
output_cube (オプション) | 元の時系列データと各位置で選択された方法の予測を含む出力時空間キューブ (*.nc ファイル)。[時空間キューブを 3D で視覚化 (Visualize Space Time Cube in 3D)] ツールを使用すると、元の値と予測値を同時に表示できます。 | File |
evaluate_using_validation_results (オプション) | 位置に対する予測方法を、最小の検証 RMSE を使用して決定するか、最小の予測 RMSE を使用して決定するかを指定します。
| Boolean |
コードのサンプル
次の Python スクリプトは、EvaluateForecastsByLocation 関数の使用方法を示しています。
import arcpy
arcpy.env.workspace = "C:/Analysis"
# Compare and merge three forecasts from three forecasts.
arcpy.stpm.EvaluateForecastsByLocation("CurveFit.nc;ExpSmooth.nc;ForestBased.nc",
"Analysis.gdb/Forecasts",
"outEvaluate.nc","USE_VALIDATION")次の Python スクリプトは、EvaluateForecastsByLocation 関数を使用して人口を予測する方法を示しています。
# Compare and merge three forecasts
# Import system modules
import arcpy
# Set property to overwrite existing output.
arcpy.env.overwriteOutput = True
# Set workspace
workspace = r"C:\Analysis"
arcpy.env.workspace = workspace
# Run tool
arcpy.stpm.EvaluateForecastsByLocation(["CurveFit.nc", "ExpSmooth.nc", "ForestBased.nc"],
"Analysis.gdb/Forecasts", "outEvaluate.nc",
"USE_VALIDATION")環境
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes