NetCDF 時系列 → フィーチャクラス (不連続なサンプリング ジオメトリ) (NetCDF Time Series To Feature Class (Discrete Sampling Geometry)) (マルチディメンション)

サマリー

netCDF ファイルの時系列からフィーチャクラスを作成します。 Climate and Forecast (CF) メタデータ規則では、時系列は不連続なサンプリング ジオメトリ (DSG) のタイプのことを指します。

不連続なサンプリング ジオメトリ (DSG) ツールの仕組みの詳細

使用法

  • Climate and Forecast (CF) メタデータ規則では、時系列は同じ空間位置における一連のデータ ポイントで、単調に回数が増加します。

  • 不連続なサンプリング ジオメトリ (DSG) データセットには、データがサンプリングされる時空間リージョンよりもディメンション性が低いという特徴があります。

  • 入力 netCDF ファイルは Climate and Forecast (CF) に準拠している必要があります (CF 1.6 以降)。 CF 規約は、各変数、およびデータの空間プロパティと時間プロパティで表されるデータを説明するメタデータを定義します。

  • 入力 netCDF ファイルが CF に準拠していない場合、追加の属性または変更された属性を含む [入力 Climate and Forecast メタデータ] (Python では in_cf_metadata) ファイルを指定できます。 [入力 Climate and Forecast メタデータ] ファイルは、.ncml 拡張子を持つ XML 形式のファイルです。 このメタデータ ファイルの属性によって、netCDF ファイルのメタデータが拡張またはオーバーライドされます。 入力 netCDF ファイルにグリッド マッピング変数がない場合は、[入力 Climate and Forecast メタデータ] ファイルを使用して指定することもできます。

  • DSG フィーチャ タイプは、cf_role 属性でマークされたインスタンス ID で区別されます。 同じスキーマを持つ複数の netCDF ファイルは、一意の InstanceID フィールドを持つ単一のフィーチャクラスに変換できます。 各 netCDF ファイルには同じ cf_role 属性でマークされた変数が必要です。これらは複数のファイルでフィールドを区別するために使用されます。 この変数のインスタンス ディメンションに沿って集約が厳密に実行されます。

  • 複数のインスタンス変数と観測変数 (ステーション番号、温度、塩分濃度など) は [インスタンス変数] (Python では instance_variables) パラメーターと [観測変数] (Python では observation_variables) でそれぞれ選択できます。

  • グループに整理された変数が入力 netCDF ファイルに含まれている場合、[インスタンス変数] パラメーターと [観測変数] パラメーターに、その変数が絶対パスとともに表示され、ルート グループを基準にした位置を示すスラッシュ ("/") が先頭に付けられます。 たとえば、グループ /g1 に配置された変数 precip/g1/precip として表示されます。

  • インスタンス変数と観測変数の両方で、変数名ごとに照合が行われます。 つまり、異なる netCDF ファイルの 2 つの変数で名前が同じ場合は、同じものを表すものとして解釈されます。 変数がグループ内に存在する場合、照合中に変数名がその絶対パスとともに考慮されます。 ルート グループを基準にした異なる位置に、同じ名前を持つ複数の変数が存在する場合 (/g1/precip/g2/precip など)、異なるものを表すものとして解釈されます。

  • [分析範囲] (Python では analysis_extent) パラメーターを使用して、スタンドアロン ツール操作の出力分析エリアを明示的に指定したり、ワークフローの一環として環境設定をオーバーライドしたりできます。 値の入力、表示範囲の選択、レイヤーの選択、または入力データセットの参照によって範囲を指定できます。

  • [分析範囲] のデフォルト値は入力 netCDF ファイルのすべての範囲から計算されます。

  • 範囲をパラメーター値として明示的に指定しない場合、分析環境設定から取得されます。

  • 選択されたインスタンス フィールドに沿ったすべての位置情報を含む 2D または 3D のポイント フィーチャクラスのほか、選択された観測変数を含む関連テーブルが作成されます。 InstanceID フィールドに基づいてテーブルをフィーチャクラスに結合するオプションのレイヤーも作成できます。

  • netCDF ファイルのデータ変数では、grid_mapping 変数を使用して、空間座標値で使用する座標参照系 (CRS) を明示的に定義できます。 グリッド マッピング epsg_code 属性を使用して GCS か PCS を選択できます。 また、グリッド マッピング esri_pe_stringcrs_wktspatial_ref の各属性のいずれかを使用して、WKT 1 か WKT 2 のどちらの文字列かを定義できます。 これらの属性のいずれかがある場合、水平座標系の他のどの属性も使用されません。 座標参照系およびサポート対象の WKID の詳細については、「座標系、投影法、および座標変換」のトピックをご参照ください。

  • 空間座標値が 3D の場合は、grid_mapping 変数でも鉛直座標系 (VCS) を指定する必要があります。 VCS は、鉛直測地基準系、メジャーの距離単位、鉛直座標が増加する方向 (上または下) を組み合わせたものです。 測地基準系は通常、グリッド マッピング変数の属性から取得され、他のプロパティは鉛直座標変数から取得されます。 任意の鉛直測地基準系は、複合 WKT 文字列を上記に記載されているいずれかの WKT 属性の値として使用することで指定できます。 重力ベースの測地基準系は geoid_name 属性か geopotential_datum_name 属性を使用して指定できます。 さらに、潮位基準面は、鉛直座標変数のいずれかの潮位標準名を使用して暗黙的に指定できます。 VCS が指定されておらず、鉛直座標変数がある場合は、WGS 1984 Ellipsoid Height (wkid115700) がデフォルトとして選択されます。

パラメーター

ラベル説明データ タイプ
入力 NetCDF ファイルまたはフォルダー

フィーチャクラスを作成するために使用する入力 netCDF ファイル。 netCDF ファイル単体、および複数の netCDF ファイルを含むフォルダーを使用できます。

入力 netCDF ファイル間で DSG フィーチャ タイプとスキーマを揃える必要があります。

Folder; File
ターゲット ワークスペース

出力フィーチャクラスとテーブルが作成されるジオデータベース (エンタープライズまたはファイル) またはフォルダー。 これは既存のワークスペースである必要があります。

Workspace
出力ポイント名

netCDF 変数のロケーションを含むフィーチャクラスの名前。 これらの変数は [インスタンス変数] パラメーターのフィールドとして追加されます。

String
観測変数
(オプション)

各ロケーションと各垂直レベルにおけるすべての観測値を含む netCDF 変数。 これらはフィールドとして出力テーブルに追加されます。

String
出力結合テーブル名
(オプション)

[観測変数] パラメーターのすべてのレコードを格納する出力テーブルの名前。

String
インスタンス変数
(オプション)

各フィーチャを区別し、観測が行われるロケーションを表す netCDF 変数。 これらの変数はフィールドとして出力フィーチャクラスに追加されます。

String
サブディレクトリを含める
(オプション)

入力フォルダーのサブディレクトリに存在しているファイルを使用するかどうかを指定します。

  • オン - すべてのサブディレクトリのすべての netCDF ファイルが使用されます。
  • オフ - 入力フォルダーのファイルのみが使用されます。 これがデフォルトです。
Boolean
入力 Climate and Forecast メタデータ
(オプション)

.ncml 拡張子を持つ XML 形式のファイルで、入力 netCDF ファイルに存在しない、または変更された CF 情報を供給します。

File
分析範囲
(オプション)

出力フィーチャクラスのエリアを定義する範囲。

Extent
出力結合レイヤー
(オプション)

出力テーブルを出力フィーチャクラスに結合することで作成される出力レイヤー。 これは、任意の出力です。

Feature Layer

派生した出力

ラベル説明データ タイプ
出力ポイント

出力ポイント フィーチャクラス。

Feature Class
出力結合テーブル

出力テーブル。

Table

arcpy.management.NetCDFTimeSeriesToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {observation_variables}, {out_table_name}, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent}, {out_join_layer})
名前説明データ タイプ
in_files_or_folders
[in_files_or_folders,...]

フィーチャクラスを作成するために使用する入力 netCDF ファイル。 netCDF ファイル単体、および複数の netCDF ファイルを含むフォルダーを使用できます。

入力 netCDF ファイル間で DSG フィーチャ タイプとスキーマを揃える必要があります。

Folder; File
target_workspace

出力フィーチャクラスとテーブルが作成されるジオデータベース (エンタープライズまたはファイル) またはフォルダー。 これは既存のワークスペースである必要があります。

Workspace
out_point_name

netCDF 変数のロケーションを含むフィーチャクラスの名前。 これらの変数は instance_variables パラメーターのフィールドとして追加されます。

String
observation_variables
[observation_variables,...]
(オプション)

各ロケーションと各垂直レベルにおけるすべての観測値を含む netCDF 変数。 これらはフィールドとして出力テーブルに追加されます。

String
out_table_name
(オプション)

observation_variables パラメーターのすべてのレコードを格納する出力テーブルの名前。

String
instance_variables
[instance_variables,...]
(オプション)

各フィーチャを区別し、観測が行われるロケーションを表す netCDF 変数。 これらの変数はフィールドとして出力フィーチャクラスに追加されます。

String
include_subdirectories
(オプション)

入力フォルダーのサブディレクトリに存在しているファイルを使用するかどうかを指定します。

  • INCLUDE_SUBDIRECTORIESすべてのサブディレクトリのすべての netCDF ファイルが使用されます。
  • DO_NOT_INCLUDE_SUBDIRECTORIES入力フォルダーのファイルのみが使用されます。 これがデフォルトです。
Boolean
in_cf_metadata
(オプション)

.ncml 拡張子を持つ XML 形式のファイルで、入力 netCDF ファイルに存在しない、または変更された CF 情報を供給します。

File
analysis_extent
(オプション)

Extent クラスは、出力ラスター データセットの範囲を決定します。

Extent クラスの形式は次のとおりです。

  • Extent (XMin, YMin, XMax, YMax)

    ここで、

    • XMin - 範囲最小 X 値
    • YMin - 範囲最小 Y 値
    • XMax - 範囲最大 X 値
    • YMax - 範囲最大 Y 値

Extent
out_join_layer
(オプション)

出力テーブルを出力フィーチャクラスに結合することで作成される出力レイヤー。 これは、任意の出力です。

Feature Layer

派生した出力

名前説明データ タイプ
out_point

出力ポイント フィーチャクラス。

Feature Class
out_table

出力テーブル。

Table

コードのサンプル

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

この例は、変数がグループ内に配置されている測候所データセットの netCDF DSG 時系列ファイルからフィーチャクラスとテーブルを作成します。

import arcpy
arcpy.md.NetCDFTimeseriesToFeatureClass(r"C:\WOD\station_Tmax.nc", r"C:\ArcGIS\Projects\output.gdb",
                                        "Tmax_1990_2020", "Tmax", None, "Tmax_1990_2020_table",
					"INCLUDE_SUBDIRECTORIES", None, "DEFAULT")
NetCDFTimeSeriesToFeatureClass の例 2 (スタンドアロン スクリプト)

この例は、.ncml ファイルを使用して、気候再解析データの netCDF DSG 時系列からフィーチャクラスを作成します。

# Name: NetCDFTimeSeriesToFeatureClass_Ex_02.py
# Description: Creates a feature class from a netCDF DSG timeseries file from ARGO with a .ncml file.

# Import system modules
import arcpy

# Set the local variables
in_files_or_folders = r"C:\ARGO"
target_workspace = r"C:\outputs\argo.gdb"
out_point_name = "argo_point"
observation_variables = "temperature;pressure"
out_table_name = ""
instance_variables = ""
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES"
in_cf_metadata = "ARGO_cf.ncml"
analysis_extent = ""
out_join_layer = ""

# Execute NetCDFTimeSeriesToFeatureClass
arcpy.md.NetCDFTimeSeriesToFeatureClass(in_files_or_folders, target_workspace,
                                      out_point_name, observation_variables,
                                      out_table_name, instance_variables,
                                      include_subdirectories, in_cf_metadata,
                                      analysis_extent, out_join_layer)