時空間キューブの記述 (時空間パターンマイニングツール)

サマリー

時空間キューブのコンテンツと特性を集約します。このツールは、時空間キューブの時間範囲および空間範囲、時空間キューブ内の変数、各変数で実行された解析、各変数で使用できる 2D および 3D 表示テーマについて説明します。

図

時空間キューブの記述ツールの図

使用法

このツールは、時空間パターンマイニングツールボックスの各種ツールで作成された netCDF ファイルを受け付けます。

時空間キューブの作成の詳細
このツールは、次のような場合に適用できます。
- 時空間キューブの時間とジオメトリーを決定します。これは、時空間パターン分析ツールセットと時系列予測ツールセットのツールに適したパラメーターを選択するために役立ちます。
- 時空間キューブで実行された分析の履歴を表示します。これにより、時空間キューブを 2D で視覚化 ツールと 時空間キューブを 3D で視覚化 ツールで使用可能な表示テーマオプションがわかります。時空間キューブレイヤーの表示テーマオプションはリストされません。
  
  時空間キューブレイヤーの表示テーマの詳細
ジオプロセシングメッセージに入力時空間キューブの特性とコンテンツが記述されます。このメッセージにアクセスするには、ジオプロセシング ウィンドウで、進行状況バーにポインターを合わせるか、ポップアップボタンをクリックするか、メッセージセクションを展開します。このメッセージには次の情報が含まれています。
- 時空間キューブが作成された日時。
- 時空間キューブの作成に使用された ArcGIS Pro のバージョン。
- 時空間キューブのタイプ。可能なタイプには、定義済み位置のキューブ、グリッドキューブ、定義済み位置のキューブ (多次元ラスターから)、予測キューブ、サブセットキューブが含まれます。さまざまなタイプの時空間キューブの詳細については、時空間キューブの作成の仕組みをご参照ください。
  
  注意:
  
  ArcGIS Pro 2.8 またはそれ以前の 多次元ラスターレイヤーから時空間キューブを作成 ツールを使用して時空間キューブを作成した場合、表示されるタイプは、定義済み位置のキューブ (多次元ラスターから) ではなく定義済み位置のキューブになります。
- 時空間キューブの空間と時間プロパティを記述する 時空間キューブの特性 セクション。これらの特性の詳細については、時空間キューブの作成の仕組みをご参照ください。
- 各行が入力時空間キューブの変数に対応する、時空間キューブのコンテンツ セクション。各行には、変数の統計サマリー、(集約と補完タイプとともに) 変数を作成したツール、および時空間キューブレイヤーと時空間キューブの視覚化ツールセットのツールでの視覚化に利用可能な表示テーマオプションが含まれます。
- ポイントの集約による時空間キューブの作成 ツールを使用して時空間キューブを作成した場合、メッセージの 時空間キューブロケーションとビン セクションの下に 1 つ以上のサブセクションが含まれます。 カウント サブセクションと、オプションの各 サマリーフィールド サブセクションには、少なくとも 1 つのポイントを含むビンとロケーションの数が含まれます。散在性 (ゼロカウントを含むビンのパーセンテージ) も、カウント サブセクションの表に一覧表示されます。
- 時系列予測ツールセットのツールを使用して時空間キューブを作成した場合、メッセージには、適用された予測方法を要約する 予測の詳細 セクションが含まれます。
- メッセージの 時空間キューブの傾向 の下には、1 つ以上のセクションが含まれます。これらのセクションには、時空間キューブの各変数の全体的な Mann-Kendall トレンド統計が含まれます。
出力特性テーブル パラメーターに値を指定すると、このツールは、入力時空間キューブの空間および時間特性を含むテーブルを作成します。特性テーブル内の値は、ジオプロセシングメッセージにも表示されます。これらの値は、時空間分析ワークフローを作成するため、ModelBuilder で使用できます。
出力空間範囲フィーチャ パラメーターに値を指定すると、ツールは、入力時空間キューブの範囲を表す単一の四角形を含むポリゴンフィーチャクラスを出力します。 定義済みの位置による時空間キューブの作成 ツールを使用し、単一のポイントを使用して入力時空間キューブを作成した場合、ポリゴンフィーチャクラスの代わりにポイントフィーチャクラスが作成されます。テンプレートキューブから時空間キューブを作成した場合、その範囲にテンプレートキューブの範囲が反映されます。
時空間キューブの作成時にテンプレートキューブまたは Extent 環境を使用した場合、出力空間範囲フィーチャ パラメーターの値は時空間キューブロケーションの範囲を反映しません。

ラベル	説明	データタイプ
入力時空間キューブ	記述対象の時空間キューブ。時空間キューブは `.nc` ファイル拡張子を持ち、時空間パターンマイニングツールボックスのさまざまなツールを使用して作成されます。	File
出力特性テーブル (オプション)	入力時空間キューブに関するサマリー情報を含むテーブル。	Table
出力空間範囲フィーチャ (オプション)	入力時空間キューブの空間範囲を表す単一の四角形を含むフィーチャクラス。	Feature Class

arcpy.stpm.DescribeSpaceTimeCube(in_cube, {out_characteristics_table}, {out_spatial_extent})

名前	説明	データタイプ
in_cube	記述対象の時空間キューブ。時空間キューブは `.nc` ファイル拡張子を持ち、時空間パターンマイニングツールボックスのさまざまなツールを使用して作成されます。	File
out_characteristics_table (オプション)	入力時空間キューブに関するサマリー情報を含むテーブル。	Table
out_spatial_extent (オプション)	入力時空間キューブの空間範囲を表す単一の四角形を含むフィーチャクラス。	Feature Class

コードのサンプル

DescribeSpaceTimeCube の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、DescribeSpaceTimeCube 関数の使用方法を示しています。

import arcpy
arcpy.stpm.DescribeSpaceTimeCube("input_cube.nc")

DescribeSpaceTimeCube` の例 2 (スタンドアロンスクリプト)

次のスタンドアロン 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 Forecasts 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 Forecasts By Location tool
                        evaluate_cubes += cube + ';'

# Run the Evaluate Forecasts By Location tool
evaluate_output = os.path.join(out_gdb, "Evaluate_Covid19_Forecasts")

arcpy.stpm.EvaluateForecastsByLocation(evaluate_cubes.replace('\\', '/'), evaluate_output, None, "USE_VALIDATION")

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

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

時空間キューブの記述 (時空間パターン マイニング ツール)

サマリー

図

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック

時空間キューブの記述 (時空間パターンマイニングツール)