カスタム地理座標系変換の作成 (Create Custom Geographic Transformation) (データ管理)

概要

2 つの地理座標系または測地基準系間でデータを変換するための変換方式を作成します。このツールの出力は、地理座標系変換が必要なパラメーターを備えるツールの変換方式として使用できます。

使用法

  • すべてのカスタム地理変換では、保存時に「*.gtf」拡張子が付けられ、ユーザーの Application Data フォルダー以下の ESRI\<ArcGIS product>\ArcToolbox\CustomTransformations フォルダーに格納されます。CustomTransformations フォルダーが存在しない場合は、ツールにより作成されます。Application Data フォルダーが読み取り専用フォルダーまたは隠しフォルダーである場合は、ユーザーの temp フォルダーの ArcToolbox\CustomTransformations に出力が作成されます。Application Data および temp フォルダーの位置と名前は、オペレーティング システムによって異なります。

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

  • 地理座標系変換を使用するすべてのジオプロセシング ツールでは、デフォルトの格納場所にあるすべてのカスタム変換が参照され、それらの変換が有効な変換オプションとして、ダイアログ ボックスの [地理座標系変換] パラメーターのドロップダウン リストに表示されます。

  • カスタム変換ファイルは編集できません。これらは、バージョンと文字列長情報が格納されるバイナリ ファイルであり、ジオプロセシング フレームワークの外部で編集した場合、破損する可能性があります。カスタム変換ファイルを更新するには、新規にカスタム地理座標系変換を作成して、既存のファイルを上書きする必要があります。

構文

arcpy.management.CreateCustomGeoTransformation(geot_name, in_coor_system, out_coor_system, custom_geot)
パラメーター説明データ タイプ
geot_name

カスタム変換方式の名前。

すべてのカスタム地理変換では、保存時に「*.gtf」拡張子が付けられ、ユーザーの Application Data フォルダー以下の ESRI\<ArcGIS product>\ArcToolbox\CustomTransformations フォルダーに格納されます。CustomTransformations フォルダーが存在しない場合は、ツールにより作成されます。Application Data フォルダーが読み取り専用フォルダーまたは隠しフォルダーである場合は、ユーザーの temp フォルダーの ArcToolbox\CustomTransformations に出力が作成されます。Application Data および temp フォルダーの位置と名前は、オペレーティング システムによって異なります。

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

String
in_coor_system

変換元の地理座標系。

Coordinate System
out_coor_system

変換先の地理座標系。

Coordinate System
custom_geot

カスタム変換を表す文字列 GEOGTRAN 内に、METHOD および PARAMETER の値を設定します。メソッドの名前を、利用可能なメソッド (地心変換、モロデンスキー、モロデンスキー (略式)、位置ベクター、座標フレーム、モロデンスキー バデカス、NADCON、HARN、NTV2、軽度の回転、単位変換、ジオグラフィック 2D オフセット) から設定します。各メソッドには独自のパラメーター セットがあります。パラメーターの値は、カスタム地理座標系変換の文字列表現内で、パラメーター名に続けてテキストを入力することで編集できます。次の Python のサンプルに例を示します。

String

コードのサンプル

CreateCustomGeoTransformation (カスタム地理座標系変換の作成) の例 (Python スタンドアロン スクリプト)

次のスタンドアロン スクリプトでは、CreateCustomGeoTransformation (カスタム地理座標系変換の作成) 関数を使用して、特定のユース ケース用のカスタム変換を作成します。出力は、デフォルト ディレクトリに作成される *.gtf ファイルになります。

# Name: CreateCustomGeographicTransformation.py
# Description: Creates a custom geographic transformation in the default directory.
# import system modules
import arcpy
# set the variables
geoTransfmName = "cgt_geocentric2"
# create a spatial reference object for GCS_Tokyo
inGCS = arcpy.SpatialReference("Tokyo")
# create a spatial reference object for GCS_WGS_1984
outGCS = arcpy.SpatialReference("WGS 1984")
customGeoTransfm = "GEOGTRAN[METHOD['Geocentric_Translation'],PARAMETER['X_Axis_Translation',''],PARAMETER['Y_Axis_Translation',''],PARAMETER['Z_Axis_Translation','']]"
arcpy.CreateCustomGeoTransformation_management(geoTransfmName, inGCS, outGCS, customGeoTransfm)

環境

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

ライセンス情報

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

関連トピック