| ラベル | 説明 | データ タイプ |
入力時空間キューブ | 記述対象の時空間キューブ。 時空間キューブのファイル拡張子は「*.nc」です。時空間キューブは、時空間パターン マイニング ツールボックスのさまざまなツールを使用して作成されます。 | File |
出力特性テーブル (オプション) | 入力時空間キューブに関するサマリー情報を含むテーブル。 | Table |
出力空間範囲フィーチャ (オプション) | 入力時空間キューブの空間範囲を表す単一の四角形を含むフィーチャクラス。 | Feature Class |
サマリー
時空間キューブのコンテンツと特性を集約します。 このツールは、時空間キューブの時間範囲と空間範囲、時空間キューブの変数、変数ごとに実行される分析、各変数に使用可能な 2D および 3D の表示テーマについて説明します。
図
使用法
このツールでは、時空間パターン マイニング ツールボックスのさまざまなツールで作成された netCDF ファイルを使用できます。
このツールは、次のような場合に適用できます。
- 時空間キューブの時間とジオメトリを決定します。 これは、時空間パターン分析ツールセットと時系列予測ツールセットのツールに敵したパラメーターを選択するのに役立ちます。
- 時空間キューブで実行された分析の履歴を表示します。 これにより、[時空間キューブを 2D で視覚化 (Visualize Space Time Cube in 2D)] ツールと [時空間キューブを 3D で視覚化 (Visualize Space Time Cube in 3D)] ツールで使用可能な [表示テーマ] パラメーター オプションがわかります。
ジオプロセシング メッセージに入力時空間キューブの特性とコンテンツが記述されます。 このメッセージにアクセスするには、[ジオプロセシング] ウィンドウで、進行状況バーにポインターを合わせるか、ポップアップ ボタンをクリックするか、メッセージ セクションを展開します。 このメッセージには次の情報が含まれています。
- 時空間キューブが作成された日時。
- 時空間キューブの作成に使用された AllSource のバージョン。
- 時空間キューブのタイプ。 可能なタイプには、定義済み位置のキューブ、グリッド キューブ、定義済み位置のキューブ (多次元ラスターから)、予測キューブ、サブセット キューブが含まれます。 さまざまなタイプの時空間キューブの詳細については、「時空間キューブの作成の詳細」をご参照ください。
注意:
ArcGIS Pro 2.8 以前の [多次元ラスター レイヤーから時空間キューブを作成 (Create Space Time Cube From Multidimensional Raster Layer)] ツールを使用して時空間キューブを作成した場合、表示されるタイプは、定義済み位置のキューブ (多次元ラスターから) ではなく定義済み位置のキューブになります。
- 時空間キューブの時空間プロパティを説明する [時空間キューブの特性] セクション。 これらの特性の詳細については、「時空間キューブの作成の詳細」をご参照ください。
- 各行が入力時空間キューブの変数に対応する [時空間キューブのコンテンツ] セクション。 各行には、変数の要約統計、(集約と塗りつぶしタイプとともに) 変数を作成したツール、[時空間キューブを 2D で視覚化 (Visualize Space Time Cube in 2D)] ツールと [時空間キューブを 3D で視覚化 (Visualize Space Time Cube in 3D)] ツールで使用可能な表示テーマ オプションが含まれます。
- [ポイントの集約による時空間キューブの作成 (Create Space Time Cube By Aggregating Points)] ツールを使用して時空間キューブを作成した場合、メッセージの [時空間キューブ ロケーションとビン] セクションの下に 1 つ以上のサブセクションが含まれます。 [カウント] サブセクションとオプションの各 [サマリー フィールド] サブセクションには、少なくとも 1 つのポイントで含んだビンとロケーションの数が含まれます。 散在性 (ゼロ カウントを含むビンのパーセンテージ) も [カウント] サブセクションの表に示されます。
- 時系列予測ツールセットを使用して時空間キューブを作成した場合、メッセージには、適用された予測方法を要約する [予測の詳細] セクションが含まれます。
- メッセージの [時空間キューブの傾向] の下には 1 つ以上のセクションが含まれます。 これらのセクションには、時空間キューブの各変数の全体的な Mann-Kendall トレンド統計が含まれます。
[出力特性テーブル] パラメーターに値を指定すると、このツールは、入力時空間キューブの時空間特性を含むテーブルを作成します。 特性テーブル内の値は、ジオプロセシング メッセージにも表示されます。 これらの値は、時空間分析ワークフローを作成するために、ModelBuilder で使用されます。
[出力空間範囲フィーチャ] パラメーターに値を指定すると、このツールは、入力時空間キューブの範囲を表す単一の四角形を含むポリゴン フィーチャクラスを出力します。 [定義済みの位置による時空間キューブの作成 (Create Space Time Cube By Defined Locations)] ツールを使用し、単一のポイントを使用して入力時空間キューブを作成した場合、ポリゴン フィーチャクラスの代わりにポイント フィーチャクラスが作成されます。 テンプレート キューブから時空間キューブを作成した場合、その範囲にテンプレート キューブの範囲が反映されます。
時空間キューブの作成時にテンプレート キューブまたは Extent 環境を使用した場合、[出力空間範囲フィーチャ] パラメーターの値は時空間キューブ ロケーションの範囲を反映しません。
パラメーター
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")環境
このツールは、ジオプロセシング環境を使用しません。