トップへ戻る

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

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

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

使用法

  • 鉛直座標系変換を使用するすべてのジオプロセシング ツールでは、デフォルトの格納場所にあるすべてのカスタム変換が検査され、座標系変換パラメーターのオプションとして表示されます。 [変換] ダイアログ ボックスには、地理座標系変換と鉛直座標系変換を組み合わせたパスが表示されます (サポートされている場合)。 座標系変換は、地理座標系変換環境でも使用できます。

  • すべてのカスタム鉛直座標系変換ファイルは、保存時に .vtf 拡張子が付けられ、アプリケーション データ フォルダー以下の Esri\ArcGISPro\ArcToolbox\CustomTransformations フォルダーに格納されます。

    • すべての Windows オペレーティング システムで、AppData フォルダーは %appdata% にあり、temp フォルダーは %temp% にあります。 コマンド ウィンドウに「%appdata%」と入力すると、AppData フォルダーの場所が返されます。 「%temp%」と入力すると、temp フォルダーの場所が返されます。
    • UNIX システムの場合、tmp およびアプリケーション データ フォルダーはそれぞれ、ホーム ディレクトリにある $TMP および $HOME の下にあります。 ターミナルで「/tmp」と入力すると、場所が返されます。

  • カスタム座標系変換ファイルは編集できません。 これらは、バージョンと文字列長情報が格納されるバイナリ ファイルであり、変更すると破損する可能性があります。 座標系変換ファイルを更新するには、新規にカスタム鉛直座標系変換を作成して、既存のファイルを上書きします。

  • このツールでは、GEOID、Vertical Offset、Vertical Offset with Grid などの一般的に使用される鉛直座標変換方法が提供されます。 数式ベースの方法もありますが、GEOID や Vertical Offset with Grid など、ほとんどの方法ではデータ ファイルが必要です。 バイナリ形式または ASCII 形式のファイルを使用できます。 パフォーマンス上の理由から、バイナリ形式をお推めします。

    ArcGIS Pro で現在サポートされているファイル形式は次のとおりです。

    • National Geospatial-Intelligence Agency によってリリースされている EGM84 および EGM96
    • NOAA の National Geodetic Survey からリリースされている GEOID、VDATUM、VERTCON、VERTCON3

  • 楕円体の高さを重力関連の高さに変換する GEOID 方式と、2 つの重力関連高度系間で変換する Vertical Offset with Grid 方式は、単純な ASCII ファイル形式をサポートしています。 このファイル形式は NOAA の 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

  • ファイルベースの方法を使用する際には、適切な内挿法を指定する必要があります。 このツールにはいくつかの内挿法が組み込まれています。

  • 鉛直座標変換で 1 つ以上のファイルを必要とする方法が使用される場合、次のいずれかの場所にファイルを配置します。

    • 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 フォルダーにファイルをコピーします。 権限の制限によりこれらの場所が使用できないか表示されない場合は、システム管理者に問い合わせてください。

  • このツールでは、楕円体高さと重力関連高さの間または 2 つの重力関連高さの間で変換する座標変換定義の作成のみを行えます。 ソースとターゲットの鉛直座標系を楕円体高度系に同時に設定することはできません。 楕円体高度系間で変換するには、[カスタム地理座標系変換の作成 (Create Custom Geographic Transformation)] ツールを使用します。

パラメーター

ダイアログPython

ラベル説明データ タイプ
鉛直座標系変換名

カスタム座標系変換定義の名前。

String
ソースの鉛直座標系

変換前の鉛直座標系。

Well Known ID (WKID) を指定するか、[座標系の選択] ボタン 座標系の選択 を使用して座標系を選択します。

String
ターゲットの鉛直座標系

最終的な鉛直座標系。

WKID を指定するか、[座標系の選択] ボタン 座標系の選択 を使用して座標系を選択します。

String
内挿地理座標系
(オプション)

内挿地理座標系。

このパラメーターは、鉛直座標系変換方法で必要な場合のみアクティブになります。

地理座標系は、ファイルからオフセット値を内挿する場合、または方式で緯度座標と経度座標が必要な場合に使用されます。 内挿地理座標系が不要な方法は、なし、単位変更、高さと深さの反転、および鉛直方向のオフセットです。

WKID を指定するか、[座標系の選択] ボタン 座標系の選択 を使用して座標系を選択します。

Coordinate System
鉛直座標系変換方法
(オプション)

使用する鉛直座標変換方法。

ドロップダウン リストから、入力鉛直座標系から出力鉛直座標系へのデータの変換に使用する変換方法を選択します。 選択後、変換方式のパラメーターが編集用のテーブルに表示されます。

方法とパラメーターのリストはGeographic and Vertical Transformations pdf をご参照ください。

ファイルが必要な方式を使用する際のファイルの配置場所については、使用に関する注意をご参照ください。

String
範囲
(オプション)

座標変換が適用されるエリア。

範囲の座標系には、WGS84 (WKID: 4326) または NAD 1983 や GDA2020 などの GNSS ベースの地理座標系を使用します。 投影座標系、または投影座標系を持つレイヤーが指定されている場合、値は緯度と経度に変換されます。

  • [現在の表示範囲] マップ ビュー - 範囲は、アクティブなマップまたはシーンに基づきます。
  • [範囲の描画] 直角化して完了 - 範囲は、マップまたはシーンに描画された四角形に基づきます。
  • [レイヤーの範囲] レイヤー - 範囲は、アクティブなマップ レイヤーに基づきます。 使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用します。 各マップ レイヤーには、次のオプションがあります。

    • [すべてのフィーチャ] すべて選択 - すべてのフィーチャの範囲。
    • [選択フィーチャ] 選択フィーチャからのエリア - 選択したフィーチャの範囲。
    • [表示フィーチャ] Extent Indicator - 表示フィーチャの範囲。

  • [参照] 参照 - 範囲はデータセットに基づきます。
  • [クリップボード] 貼り付け - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。
    • [範囲をコピー] コピー - 範囲と座標系をクリップボードにコピーします。
    • [範囲を貼り付け] 貼り付け - 範囲と座標系をクリップボードから貼り付けます。 クリップボードに座標系が含まれていない場合、マップの座標系が範囲に使用されます。
  • [範囲をリセット] リセット - 範囲はデフォルト値にリセットされます。

座標を手動で入力する場合、アクティブなマップの座標系の座標を数値で指定する必要があります。 マップで、入力した座標と異なる表示単位が使用されることがあります。 南と西の座標にはマイナス値の記号を使用します。

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

関連トピック

  • 投影変換と座標変換ツールセットの概要
  • ジオプロセシング ツールの検索

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

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報