フィーチャクラスの各フィーチャの中心点を基準に、真北の回転角を計算します。この値を所定のフィールドに自動入力します。このフィールドを空間マップ シリーズと併用することによって、各マップを真北まで回転できます。
測地線の角度を計算するには、有効な投影座標系を指定する必要があります。
| ラベル | 説明 | データ タイプ |
入力フィーチャ | 入力フィーチャクラス (ポイント、マルチポイント、ライン、およびポリゴン) | Feature Layer |
角度フィールド | 真北の計算値 (10 進度数) を入力する既存のフィールド。 | Field |
回転メソッド (オプション) | 回転値の計算に使用する方法を指定します。
| String |
座標系フィールド (オプション) | 角度計算に使用する投影座標系の投影エンジン文字列を含むフィールド。特定のフィーチャの投影座標系の投影エンジン文字列に基づいて、各フィーチャに対する角度が計算されます。無効な値が存在している場合、カートグラフィ環境設定で指定されているカートグラフィの座標系がツールに使用されます。デフォルトはありません。つまり、フィールドはデフォルトでは一切指定されません。フィールドが何も指定されていない場合、計算に使用される投影座標系は、カートグラフィ環境設定から取得されます。 | Field |
| ラベル | 説明 | データ タイプ |
| 出力フィーチャ | 計算された回転値を含む、更新されたフィーチャクラス。 | フィーチャ レイヤー |
arcpy.cartography.CalculateGridConvergenceAngle(in_features, angle_field, {rotation_method}, {coordinate_sys_field})| 名前 | 説明 | データ タイプ |
in_features | 入力フィーチャクラス (ポイント、マルチポイント、ライン、およびポリゴン) | Feature Layer |
angle_field | 真北の計算値 (10 進度数) を入力する既存のフィールド。 | Field |
rotation_method (オプション) | 回転値の計算に使用する方法を指定します。
| String |
coordinate_sys_field (オプション) | 角度計算に使用する投影座標系の投影エンジン文字列を含むフィールド。特定のフィーチャの投影座標系の投影エンジン文字列に基づいて、各フィーチャに対する角度が計算されます。無効な値が存在している場合、カートグラフィ環境設定で指定されているカートグラフィの座標系がツールに使用されます。デフォルトはありません。つまり、フィールドはデフォルトでは一切指定されません。フィールドが何も指定されていない場合、計算に使用される投影座標系は、カートグラフィ環境設定から取得されます。 | Field |
| 名前 | 説明 | データ タイプ |
| out_features | 計算された回転値を含む、更新されたフィーチャクラス。 | フィーチャ レイヤー |
次の例では、フィーチャに対して真北の回転角を計算します。
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.CalculateGridConvergenceAngle_cartography("US_states", "angle",
"GEOGRAPHIC", "UTM")次の例では、ポイント フィーチャに対して真北の回転角を計算します。
# Name: calculategridconvergenceangle_example.py
# Description: Calculates the true north rotation angle for features
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:\Data\ProjectData.gdb"
# Set local variables
inFeatures = "US_states"
angleField = "angle"
rotationMethod = "GEOGRAPHIC"
coordSystemField = "UTM"
# Execute CalculateGridConvergenceAngle
arcpy.CalculateGridConvergenceAngle_cartography(inFeatures, angleField,
rotationMethod,
coordSystemField)座標系フィールドを選択しないと、この設定が使用されます。あるいは、座標系フィールドを選択しても座標系文字列の値が無効な場合は、ここで指定されている座標系が角度計算に使用されます。