NetCDF ポイント → フィーチャクラス (不連続なサンプリングジオメトリ) (NetCDF Points To Feature Class (Discrete Sampling Geometry)) (マルチディメンション)—ArcGIS AllSource

サマリー

netCDF ファイル内のポイントからフィーチャクラスを作成します。 Climate and Forecast (CF) メタデータ規約では、ポイントは不連続なサンプリングジオメトリ (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 メタデータ] ファイルを使用して指定することもできます。
複数のインスタンス変数を、[インスタンス変数] (Python では instance_variables) パラメーターに対して選択できます。
グループに整理された変数が入力 netCDF ファイルに含まれている場合、[インスタンス変数] パラメーターに、その変数が絶対パスとともに表示され、ルートグループを基準にした位置を示すスラッシュ ("/") が先頭に付けられます。たとえば、グループ /g1 に配置された変数 precip は /g1/precip として表示されます。
個別のファイルまたはフォルダーとして指定された複数の netCDF DSG ポイントファイルを、一意の instanceID フィールドがある 1 つのフィーチャクラスに変換できます。インスタンス変数では、変数名ごとに照合が行われます。つまり、異なる netCDF ファイルの 2 つの変数で名前が同じ場合は、同じものを表すものとして解釈されます。変数がグループ内に存在する場合、照合中に変数名がその絶対パスとともに考慮されます。ルートグループを基準にした異なる位置に、同じ名前を持つ複数の変数が存在する場合 (/g1/precip と /g2/precip など)、異なるものを表すものとして解釈されます。
[分析範囲] (Python では analysis_extent) パラメーターを使用して、スタンドアロンツール操作の出力分析エリアを明示的に指定したり、ワークフローの一環として環境設定をオーバーライドしたりできます。値の入力、表示範囲の選択、レイヤーの選択、または入力データセットの参照によって範囲を指定できます。
[分析範囲] のデフォルト値は入力 netCDF ファイルのすべての範囲から計算されます。
範囲をパラメーター値として明示的に指定しない場合、分析環境設定から取得されます。
選択された [インスタンス変数] パラメーター値のデータ値とともに、すべての位置情報を含む 2D または 3D ポイントフィーチャクラスが作成されます。
netCDF ファイルのデータ変数では、grid_mapping 変数を使用して、空間座標値で使用する座標参照系 (CRS) を明示的に定義できます。グリッドマッピング epsg_code 属性を使用して GCS か PCS を選択できます。また、グリッドマッピング esri_pe_string、crs_wkt、spatial_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
サブディレクトリを含める (オプション)	入力フォルダーのサブディレクトリに存在しているファイルを使用するかどうかを指定します。オン - すべてのサブディレクトリのすべての netCDF ファイルが使用されます。オフ - 入力フォルダーのファイルのみが使用されます。これがデフォルトです。	Boolean
入力 Climate and Forecast メタデータ (オプション)	.ncml 拡張子を持つ XML 形式のファイルで、入力 netCDF ファイルに存在しない、または変更された CF 情報を供給します。	File
分析範囲 (オプション)	出力フィーチャクラスのエリアを定義する範囲。	Extent

派生した出力

ラベル	説明	データタイプ
出力ポイント	出力ポイントフィーチャクラス。	Feature Class

arcpy.management.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent})

名前	説明	データタイプ
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
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_point	出力ポイントフィーチャクラス。	Feature Class

コードのサンプル

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

この例では、変数がグループ内に配置されている SWOT データセットの netCDF DSG ポイントファイルを含むフォルダーからポイントフィーチャクラスを作成します。

import arcpy
arcpy.md.NetCDFPointsToFeatureClass(r"C:\SWOT", r"C:\ArcGIS\Projects\output.gdb",
                                    "swot_water_frac", "water_frac", 
				    "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")

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

この例では、.ncml ファイルを使用し、MADIS の一連の netCDF DSG ポイントファイルからフィーチャクラスを作成します。

# Name: NetCDFPointsToFeatureClass_Ex_02.py
# Description: Creates a feature class from a netCDF DSG points file from MADIS with a .ncml file.

# Import system modules
import arcpy

# Set the local variables
in_files_or_folders = r"C:\MADIS"
target_workspace = r"C:\outputs\madis.gdb"
out_point_name = "madis_point"
instance_variables = "temperature;pressure"
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES"
in_cf_metadata = r"C:\MADIS\swot_cf.ncml"
analysis_extent = ""

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

環境

出力座標系, 範囲

このトピックへのフィードバック

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

このトピックの内容