カスタム鉛直座標系変換の作成 (Create Custom Vertical Transformation) (データ管理)—ArcGIS Pro

サマリー

2 つの鉛直座標系または測地基準系間でデータを変換するための変換定義を作成します。このツールの出力は、鉛直座標系変換が必要なパラメーターを備えるツールの座標系変換オブジェクトとして使用できます。

使用法

すべてのカスタム鉛直座標系変換ファイルは、保存時に .vtf 拡張子が付けられ、アプリケーションデータフォルダー以下の Esri\ArcGISPro\ArcToolbox\CustomTransformations フォルダーに格納されます。
- すべての Windows オペレーティングシステムで、AppData フォルダーは %appdata% にあり、temp フォルダーは %temp% にあります。コマンドウィンドウに「%appdata%」と入力すると、AppData フォルダーの場所が返されます。「%temp%」と入力すると、temp フォルダーの場所が返されます。
- UNIX システムの場合、tmp およびアプリケーションデータフォルダーはそれぞれ、ホームディレクトリにある $TMP および $HOME の下にあります。ターミナルで「/tmp」と入力すると、場所が返されます。
鉛直座標系変換を使用するすべてのジオプロセシングツールでは、デフォルトの格納場所にあるすべてのカスタム変換が検査され、座標系変換パラメーターのオプションとして表示されます。 [変換] ダイアログボックスには、地理座標系変換と鉛直座標系変換を組み合わせたパスが表示されます (サポートされている場合)。座標系変換は、地理座標系変換環境でも使用できます。
カスタム座標系変換ファイルは編集できません。これらは、バージョンと文字列長情報が格納されるバイナリファイルであり、変更すると破損する可能性があります。座標系変換ファイルを更新するには、新規にカスタム鉛直座標系変換を作成して、既存のファイルを上書きします。
ファイルは、次のいずれかの場所に配置する必要があります。
- ArcGIS Coordinate Systems Data が (各ユーザーの) コンピューター単位でインストールされている場合は、C:\Program Files (x86)\ArcGIS\CoordinateSystemsData\pedata\Vertical フォルダーにファイルをコピーします。
- ArcGIS Coordinate Systems Data がユーザー単位でインストールされている場合は、C:\Users\username\AppData\Local\Programs\ArcGIS\CoordinateSystemsData\pedata\Vertical フォルダーにファイルをコピーします。
- ArcGIS Coordinate Systems Data がインストールされていない場合に、ArcGIS Pro が (各ユーザーの) コンピューター単位でインストールされている際は、C:\Program Files\ArcGIS\Pro\Resources\pedata の ArcGIS Pro pedata フォルダーにファイルをコピーします。
- ArcGIS Pro がユーザー単位でインストールされている場合は、C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata の ArcGIS Pro pedata フォルダーにファイルをコピーします。
ArcGIS Pro または ArcGIS Coordinate Systems Data のデフォルトのインストール場所を使用しなかった場合は、相当する pedata フォルダーにファイルをコピーします。権限の制限によりこれらの場所が使用できないか表示されない場合は、システム管理者に問い合わせてください。
ほとんどのファイルは、パフォーマンス上の理由によりバイナリ形式です。楕円体の高さからジオイド (または他の重力関連) の高さに変換する GEOID 方式は、単純な ASCII ファイル形式をサポートしています。このファイル形式は、United States National Geodetic Survey で使用されています。ヘッダー行の左下隅に最小緯度 (度 (10 進)) が表示され、続いて最小経度 (度 (10 進)) が表示されます。 0 から 360 の経度の範囲を使用する必要はありません (以下を参照)。次に、緯度と経度のポイント間隔が度 (10 進) 単位で表示されます。次の値は、行および列内のポイント数です。最後の値はチェックデジットで、常に 1 です。オフセット (間隔) 値は浮動小数点数で、メートル単位です。最初の行は、最小緯度および最小経度の値から始まります。以下の最初の 3 行は、値の行が単一の行である必要がないことを示しています。
```
    15.000000000000    291.00000000000    0.1666666666667E-01    0.1666666666665E-01    361   301  1
  -29.2936  -29.3314  -29.3710  -29.4121  -29.4540  -29.4965  -29.5382  -29.5807
  -29.6233  -29.6660  -29.7090  -29.7522  -29.7956  -29.8397  -29.8846  -29.9301
```
両方の鉛直座標系を楕円体の高さに設定しないでください。この操作は今後のリリースでブロックされる予定です。代わりに、地理 (測地) 座標系変換の一部として楕円体の高さを変換します。

パラメーター

ラベル	説明	データタイプ
鉛直座標系変換名	カスタム座標系変換定義の名前。	String
ソースの鉛直座標系	変換前の鉛直座標系。 Well Known ID (WKID) を指定するか、[座標系の選択] ボタンを使用して座標系を選択します。	String
ターゲットの鉛直座標系	最終的な鉛直座標系。 Well Known ID (WKID) を指定するか、[座標系の選択] ボタンを使用して座標系を選択します。	String
内挿地理座標系 (オプション)	内挿地理座標系。このパラメーターは、鉛直座標系変換方法で必要な場合のみアクティブになります。地理座標系は、ファイルからオフセット値を内挿する場合、または方式で緯度座標と経度座標が必要な場合に使用されます。内挿地理座標系が不要な方法は、なし、単位変更、高さと深さの反転、および鉛直方向のオフセットです。 Well Known ID (WKID) を指定するか、[座標系の選択] ボタンを使用して座標系を選択します。	Coordinate System
鉛直座標系変換方法 (オプション)	鉛直座標系変換方法。ドロップダウンリストから、入力鉛直座標系から出力鉛直座標系へのデータの変換に使用する変換方法を選択します。選択後、変換方法のパラメーターが編集用のテーブルに表示されます。方法とパラメーターのリストはGeographic and Vertical Transformations pdf をご参照ください。ファイルが必要な方式を使用する際のファイルの配置場所については、使用に関する注意をご参照ください。	String
範囲 (オプション)	座標変換が適用される範囲。範囲の座標系には、WGS84 (WKID: 4326) または NAD 1983 や GDA2020 などの GNSS ベースの地理座標系を使用します。投影座標系、または投影座標系を持つレイヤーが指定されている場合、値は緯度と経度に変換されます。 [現在の表示範囲] - 範囲は、アクティブなマップまたはシーンに基づきます。このオプションは、アクティブなマップが存在する場合にのみ使用できます。 [レイヤーの範囲] - 範囲は、アクティブなマップレイヤーに基づきます。ドロップダウンリストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップレイヤーを組み合わせた範囲を取得します。このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。 [参照] - 範囲は、既存のデータに基づきます。 [範囲をリセット] - 範囲はデフォルト値にリセットされます。手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。マップで異なる表示単位が使用されていることがあります	Extent
精度 (オプション)	メートル単位の精度に関する一般的なコメント。	Double

派生した出力

ラベル	説明	データタイプ
出力座標系変換	出力座標系変換。	Value Table

arcpy.management.CreateCustomVerticalTransformation(vt_name, source_vt_coor_system, target_vt_coor_system, {interpolation_gcs}, {custom_vt}, {extent}, {accuracy})

名前	説明	データタイプ
vt_name	カスタム座標系変換定義の名前。	String
source_vt_coor_system	変換前の鉛直座標系。	String
target_vt_coor_system	最終的な鉛直座標系。	String
interpolation_gcs (オプション)	内挿地理座標系。このパラメーターは、鉛直座標系変換方法で必要な場合のみアクティブになります。地理座標系は、ファイルからオフセット値を内挿する場合、または方式で緯度座標と経度座標が必要な場合に使用されます。内挿地理座標系が不要な方法は、なし、単位変更、高さと深さの反転、および鉛直方向のオフセットです。	Coordinate System
custom_vt (オプション)	鉛直座標系変換方法。ドロップダウンリストから、入力鉛直座標系から出力鉛直座標系へのデータの変換に使用する変換方法を選択します。選択後、変換方法のパラメーターが編集用のテーブルに表示されます。方法とパラメーターのリストはGeographic and Vertical Transformations pdf をご参照ください。ファイルが必要な方式を使用する際のファイルの配置場所については、使用に関する注意をご参照ください。	String
extent (オプション)	座標変換が適用される範囲。範囲の座標系には、WGS84 (WKID: 4326) または NAD 1983 や GDA2020 などの GNSS ベースの地理座標系を使用します。投影座標系、または投影座標系を持つレイヤーが指定されている場合、値は緯度と経度に変換されます。 MAXOF - すべての入力データの最大範囲が使用されます。 MINOF - すべての入力データに共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。レイヤー名 - 指定されたレイヤーの範囲が使用されます。 Extent オブジェクト - 指定されたオブジェクトの範囲が使用されます。スぺース区切りの座標文字列 - 指定された文字列の範囲が使用されます。座標値は、x-min、y-min、x-max、y-max という順序で表記されます。	Extent
accuracy (オプション)	メートル単位の精度に関する一般的なコメント。	Double

派生した出力

名前	説明	データタイプ
out_transformation	出力座標系変換。	Value Table

コードのサンプル

CreateCustomVerticalTransformation の例 (Python ウィンドウ)

次のスタンドアロンスクリプトでは、CreateCustomVerticalTransformation 関数を使用して、カスタム鉛直座標系変換を作成します。

import arcpy
arcpy.management.CreateCustomVerticalTransformation(
    vt_name="NAD_1983_2011_ellipsoid_to_GEOID18b",
    source_vt_coor_system='VERTCS["NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]]',
    target_vt_coor_system='VERTCS["NAVD88_height_(ftIntl)",VDATUM["North_American_Vertical_Datum_1988"],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Foot",0.3048]]',
    interpolation_gcs='GEOGCS["GCS_NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    custom_vt="GEOID|g2018u0.bin|Bilinear",
    extent='-110 30 -80 40 GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    accuracy=0.5
)

環境

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

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容