時空間キューブを 2D で視覚化 (Visualize Space Time Cube in 2D) (時空間パターン マイニング)

概要

netCDF キューブに格納されている変数と時空間パターン マイニング ツールで生成された結果を視覚化します。このツールからの出力は、指定した変数とテーマに基づき独自にレンダリングされた 2 次元表現です。

時空間キューブを 2D で視覚化

使用法

  • このツールでは、[ポイントの集約による時空間キューブの作成 (Create Space Time Cube By Aggregating Points)] ツール、[定義済みの位置から時空間キューブを作成 (Create Space Time Cube From Defined Locations)] ツール、および [多次元ラスター レイヤーから時空間キューブを作成 (Create Space Time Cube from Multidimensional Raster Layer)] ツールによって作成された netCDF ファイルのみを使用できます。

  • [表示テーマ] パラメーターの [データを含む場所] オプションを選択すると、選択した変数のデータを含むすべての位置を表示できます。[傾向] オプションを選択すると、時間とともに値が増加または減少している位置 (指定した [キューブの変数] に対して位置ごとに実行された Mann-Kendall 統計の結果) を表示できます。[データを含む場所][傾向] はどちらも、キューブを作成した後で常に使用できます。

  • [ホット/コールド スポットの傾向] は、時間の経過に伴いホット/コールド スポットの Z スコアが増加または減少する場所を表示します (指定した [キューブの変数] の時空間ホット スポット分析の Z スコアに Mann-Kendall 統計を実行した結果)。[時空間ホット スポット分析の結果] は、[時空間ホット スポット分析 (Emerging Hot Spot Analysis)] ツールを実行したときに返される結果を再作成します。[ホット/コールド スポットの傾向][時空間ホット スポット分析の結果] は、指定した [キューブの変数][時空間ホット スポット分析 (Emerging Hot Spot Analysis)] が実行されている場合のみ使用可能です。

  • [時系列クラスタリング] の結果は、[時系列クラスタリング (Time Series Clustering)] ツールを最初に実行した際に返された結果を再作成します。

  • [ローカル外れ値のパーセンテージ][最新期間のローカル外れ値][ローカル外れ値分析の結果][空間近傍のない場所] は、[ローカル外れ値分析 (Local Outlier Analysis)] ツールを実行したときのみ使用可能です。[ローカル外れ値のパーセンテージ] は、各場所での外れ値の総数に占める割合、[最新期間のローカル外れ値] は、時空間キューブの直近の時間ステップで発生したすべての外れ値を表示します。[ローカル外れ値分析の結果] は、[ローカル 外れ値分析 (Local Outlier Analysis)] ツールを最初に実行したときに返された結果を再作成します。[空間近傍のない場所] は、[ローカル 外れ値分析 (Local Outlier Analysis)] を実行したときに指定した [近傍距離] 内で、空間近傍がないすべての場所を表示します。その結果、これらの場所は、解析計算に時間近傍のみを利用します。

  • [推定されるビンの数] は、一意の各位置で推定されるビンの数を示します。これにより、場所の空間パターンで値が欠落していないかどうかを確認することができます。マップの全体のセクションで推定されるビンの数が多い場合、そのエリアは分析から除外されるのが最適です。[分析から除外する場所] は、データはあるが、推定の条件を満たさなかったために埋めることができなかった空のビンがある場所を表示します。[推定されるビンの数][分析から除外する場所] は、[集計フィールド] に対してのみ使用可能です。

  • [表示テーマ] パラメーターの [予測結果] オプションを使用すると、最初に [時系列予測] ツールセットでツールを実行したときの結果を再作成できます。

  • [表示テーマ] パラメーターの [時系列外れ値の結果] オプションには、選択した [キューブの変数] パラメーターと実行された解析で時間範囲外と見なされたビンを含む場所が示されます。

構文

arcpy.stpm.VisualizeSpaceTimeCube2D(in_cube, cube_variable, display_theme, output_features, enable_time_series_popups)
パラメーター説明データ タイプ
in_cube

表示する変数を含んでいる netCDF キューブ。このファイルは、*.nc 拡張子が付加され、[ポイントの集約による時空間キューブの作成 (Create Space Time Cube By Aggregating Points)] ツール、[定義済みの場所から時空間キューブを作成 (Create Space Time Cube From Defined Locations)] ツール、または [多次元ラスター レイヤーから時空間キューブを作成 (Create Space Time Cube from Multidimensional Raster Layer)] ツールで作成されている必要があります。

File
cube_variable

調査する netCDF キューブの数値変数。時空間キューブには常に COUNT 変数が含まれます。[集計フィールド][変数] も、キューブを作成する際に含められていた場合は使用可能です。

String
display_theme

表示する [キューブの変数] の特性を指定します。オプションは、キューブが作成された方法と分析が実行された方法によって異なります。

キューブがポイントの集約によって作成された場合、[データを含むロケーション][傾向] は常に使用できます。[推定されるビンの数][分析から除外される場所] は、キューブの作成プロセスで含められた [集計フィールド] に対してのみ使用可能です。

キューブが定義済みの位置から作成された場合、[傾向] は、キューブの作成プロセスで含められた [集計フィールド] または [変数] に対して使用できます。

[ホット/コールド スポットの傾向][時空間ホット スポット分析の結果] は、選択した [キューブの変数][時空間ホット スポット分析 (Emerging Hot Spot Analysis)] を実行した後にのみ使用可能です。[ローカル外れ値のパーセンテージ][最新期間のローカル外れ値][ローカル外れ値分析の結果][空間近傍のない場所] は、[ローカル外れ値分析 (Local Outlier Analysis)] ツールの実行が完了しているときのみ使用可能です。

[予測結果] は、[時系列予測] ツールセットのツールで作成されたキューブのみで使用できます。[時系列外れ値の結果] オプションを使用できるのは、[時系列予測] ツールで [外れ値オプション] パラメーターが指定されている場合に限ります。

  • LOCATIONS_WITH_DATA[キューブの変数] パラメーターのデータを含むすべての場所を表示します。
  • TRENDSMann-Kendall 統計を使用して求められた各場所の値の傾向を表示します。
  • HOT_AND_COLD_SPOT_TRENDSMann-Kendall 統計を使用して求められた各場所の Z スコアの傾向を表示します。
  • EMERGING_HOT_SPOT_ANALYSIS_RESULTS指定した [キューブの変数] パラメーターに対する [時空間ホット スポット分析 (Emerging Hot Spot Analysis)] の結果を表示します。
  • LOCAL_OUTLIER_ANALYSIS_RESULTS指定した [キューブの変数] パラメーターに対する [ローカル外れ値分析 (Local Outlier Analysis)] の結果を表示します。
  • PERCENTAGE_OF_LOCAL_OUTLIERS各場所の外れ値のパーセンテージ合計を表示します。
  • LOCAL_OUTLIER_IN_MOST_RECENT_TIME_PERIOD最新の期間中に発生した外れ値を表示します。
  • TIME_SERIES_CLUSTERING_RESULTS指定した [キューブの変数] パラメーターに対する [時系列クラスタリング (Time Series Clustering)] の結果を表示します。
  • LOCATIONS_WITHOUT_SPATIAL_NEIGHBORS最後に実行された解析で空間近傍が見つからなかった場所を表示します。これらの場所では、時間近傍だけが解析で使用されます。
  • NUMBER_OF_ESTIMATED_BINS位置ごとに推定されたビンの数を表示します。
  • LOCATIONS_EXCLUDED_FROM_ANALYSIS推定の条件を満たしていない空のビンがあるために、分析から除外された場所を表示します。
  • FORECAST_RESULTS指定した [分析変数] パラメーターに対して使用された [時系列予測] ツールの結果を表示します。
  • TIME_SERIES_OUTLIER_RESULTS[時系列予測] ツールの [外れ値オプション] パラメーターの結果を表示します。
String
output_features

生成される結果出力フィーチャクラス。このフィーチャクラスは、指定した表示変数の 2 次元のマップ表現です。

Feature Class
enable_time_series_popups

各出力フィーチャに時系列ポップアップを生成するかどうかを指定します。ポップアップ チャートは、シェープファイル出力ではサポートされていません。

  • CREATE_POPUPデータセット内の各フィーチャに対して、時系列ポップアップが生成されます。
  • NO_POPUP時系列ポップアップは生成されません。これがデフォルトです。
Boolean

コードのサンプル

VisualizeSpaceTimeCube2D (時空間キューブを 2D で視覚化) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、VisualizeSpaceTimeCube2Dツールの使用方法を示しています。

import arcpy
arcpy.env.workspace = r"C:\STPM"
arcpy.VisualizeSpaceTimeCube2D_stpm("Homicides.nc", "AGE_STD_ZEROS", 
                                    "LOCATIONS_EXCLUDED_FROM_ANALYSIS", 
                                    "Homicides_Age_LocExc.shp")
VisualizeSpaceTimeCube2D (時空間キューブを 2D で視覚化) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン Python スクリプトは、VisualizeSpaceTimeCube2D ツールの使用方法を示しています。

# Display Space Time Cube of homicide incidents in a metropolitan area
# Import system modules
import arcpy
# Set environment property to overwrite existing output, by default
arcpy.env.overwriteOutput = True
# Local variables...
workspace = r"C:\STPM"
# Set the current workspace (to avoid having to specify the full path to the 
# feature classes each time)
arcpy.env.workspace = workspace
# Display Space Time Cube of homicide with the standard deviation of victim's 
# age, fill no-data as 0
# Only display the locations excluded from analysis.
# Process: Visualize Space Time Cube in 2D 
cube = arcpy.VisualizeSpaceTimeCube2D_stpm("Homicides.nc", "AGE_STD_ZEROS", 
                                           "LOCATIONS_EXCLUDED_FROM_ANALYSIS", 
                                           "Homicides_Age_LocExc.shp")

ライセンス情報

  • Basic: はい
  • Standard: はい
  • Advanced: はい

関連トピック