方位距離 → ライン (Bearing Distance To Line) (データ管理)

サマリー

テーブルの X 座標フィールド、Y 座標フィールド、方位角フィールド、距離フィールドの値から測地線フィーチャまたは平面ライン フィーチャを含むフィーチャクラスを作成します。

方位距離 → ライン ツールの図
方位と距離の構成パラメーターが表示されます。

使用法

  • 出力ラインは、フィールド値から構築されます。 以下のフィールド値があります。

    • 始点の X 座標と Y 座標
    • 始点からの距離
    • 方位角度
    フィールドとその値は、出力に含められます。

  • 出力ラインが測地線の場合、X 座標と Y 座標、距離は地表面で計測され、方位角度は北から計測されます。 出力ラインが平面ラインの場合、X 座標と Y 座標、距離は投影面で計測され、方位角度は方眼北 (マップ上の垂直の上) から時計回りに計測されます。

  • 測地線は、地表上の曲線です。ただし、測地線フィーチャは、パラメトリック カーブ (トゥルー カーブ) ではなく、測地線のパスを表す密集化したポリラインとして出力に保存されます。測地線の長さが比較的短い場合、出力では直線として表される場合があります。測地線が長くなるほど、パスを表すのに多くの頂点を使用するようになります。

  • 出力がジオデータベース内のフィーチャクラスである場合、Shape_Length フィールドの値は、必ず [空間参照] パラメーターで指定された出力座標系の単位で、ポリラインの平面長となります。測地線の長さまたは距離を計測するには、ArcGIS AllSource[計測] ツールを使用し、計測する前に、[測地線][航程線]、または [大楕円線] オプションを適切に選択します。

パラメーター

ラベル説明データ タイプ
入力テーブル

入力テーブル。テキスト ファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベース テーブルが使用できます。

Table View
出力フィーチャクラス

測地線または平面ラインを含む出力フィーチャクラス。

Feature Class
X フィールド

ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。

Field
Y フィールド

ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。[空間参照] パラメーターで指定される出力座標系に配置されます。

Field
距離フィールド

出力ラインを作成するための、始点からの距離を持つ入力テーブル内の数値フィールド。

Field
距離単位
(オプション)

[距離フィールド] パラメーターに使用される単位を指定します。

  • メートル単位はメートルです。
  • キロメートル単位はキロメートルです。
  • マイル単位はマイルです。
  • 海里単位は海里です。
  • フィート単位はフィートです。
  • U.S. survey フィート単位は米国測量フィートです。
String
方位角フィールド

出力ラインの回転のための、方位角の値を持つ入力テーブル内の数値フィールド。 角度は北から時計方向に計測されます。

Field
方位単位
(オプション)

[方位角フィールド] パラメーター値の単位を指定します。

  • 度 (10 進) 単位は度 (10 進) です。これがデフォルトです。
  • ミル単位はマイルです。
  • ラジアン単位はラジアンです。
  • グラジアン単位はグラジアンです。
String
ライン タイプ
(オプション)

構築するラインのタイプを指定します。

  • 測地線地表の 2 点間の最短距離を最も正確に表現する測地線のタイプが構築されます。 これがデフォルトです。
  • 大円2 点間のパスを、地表と地球の中心を通過する平面の交線に沿って表現する測地線のタイプが構築されます。 [空間参照] パラメーター値が回転楕円体ベースの座標系の場合、ラインは大楕円線となります。 [空間参照] パラメーター値が球体ベースの座標系の場合、ラインは球面上の最大半径の円である大円となります。
  • 等角航路極点から一定の方位角で定義される球体の表面上で 2 点間のパスを表現する、航程線とも呼ばれる測地線のタイプが構築されます。 等角航路は、メルカトル図法では直線として示されます。
  • 標準セクション任意の 2 点間を結ぶパスを表現する測地線のタイプが構築されます。この測地線は、ある 2 点を通り、かつその始点で回転楕円体に対して垂直になる (直交している) 平面と、回転楕円体表面が交差する部分と定義されます。 ポイント A からポイント B の垂直断面ラインは、ポイント B からポイント A の垂直断面ラインとは異なります。
  • 平面ライン投影面の直線が使用されます。 平面ラインは通常、測地線ラインのようには地表上の最短距離を正確に表しません。 このオプションは、地理座標系には使用できません。
String
ID
(オプション)

入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。

Field
空間参照
(オプション)

出力フィーチャクラスの空間参照。デフォルトは GCS_WGS_1984 で、不明でない場合は入力座標系となります。

Spatial Reference
属性の保存
(オプション)

残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。

  • オフ - 残りの入力フィールドが出力フィーチャクラスに追加されません。 これがデフォルトです。
  • オン - 残りの入力フィールドが出力フィーチャクラスに追加されます。 新しいフィールド ORIG_FID も出力フィーチャクラスに追加され、入力フィーチャ ID の値を格納します。

Boolean

arcpy.management.BearingDistanceToLine(in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference}, {attributes})
名前説明データ タイプ
in_table

入力テーブル。テキスト ファイル、CSV ファイル、Excel ファイル、dBASE テーブル、またはジオデータベース テーブルが使用できます。

Table View
out_featureclass

測地線または平面ラインを含む出力フィーチャクラス。

Feature Class
x_field

ラインの始点の X 座標 (経度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。

Field
y_field

ラインの始点の Y 座標 (緯度) を持つ入力テーブルの数値フィールド。spatial_reference パラメーターで指定される出力座標系に配置されます。

Field
distance_field

出力ラインを作成するための、始点からの距離を持つ入力テーブル内の数値フィールド。

Field
distance_units
(オプション)

distance_field パラメーターに使用される単位を指定します。

  • METERS単位はメートルです。
  • KILOMETERS単位はキロメートルです。
  • MILES単位はマイルです。
  • NAUTICAL_MILES単位は海里です。
  • FEET単位はフィートです。
  • US_SURVEY_FEET単位は米国測量フィートです。
String
bearing_field

出力ラインの回転のための、方位角の値を持つ入力テーブル内の数値フィールド。 角度は北から時計方向に計測されます。

Field
bearing_units
(オプション)

bearing_field パラメーター値の単位を指定します。

  • DEGREES 単位は度 (10 進) です。これがデフォルトです。
  • MILS単位はマイルです。
  • RADS単位はラジアンです。
  • GRADS単位はグラジアンです。
String
line_type
(オプション)

構築するラインのタイプを指定します。

  • GEODESIC地表の 2 点間の最短距離を最も正確に表現する測地線のタイプが構築されます。 これがデフォルトです。
  • GREAT_CIRCLE2 点間のパスを、地表と地球の中心を通過する平面の交線に沿って表現する測地線のタイプが構築されます。 [空間参照] パラメーター値が回転楕円体ベースの座標系の場合、ラインは大楕円線となります。 [空間参照] パラメーター値が球体ベースの座標系の場合、ラインは球面上の最大半径の円である大円となります。
  • RHUMB_LINE極点から一定の方位角で定義される球体の表面上で 2 点間のパスを表現する、航程線とも呼ばれる測地線のタイプが構築されます。 等角航路は、メルカトル図法では直線として示されます。
  • NORMAL_SECTION任意の 2 点間を結ぶパスを表現する測地線のタイプが構築されます。この測地線は、ある 2 点を通り、かつその始点で回転楕円体に対して垂直になる (直交している) 平面と、回転楕円体表面が交差する部分と定義されます。 ポイント A からポイント B の垂直断面ラインは、ポイント B からポイント A の垂直断面ラインとは異なります。
  • PLANAR投影面の直線が使用されます。 平面ラインは通常、測地線ラインのようには地表上の最短距離を正確に表しません。 このオプションは、地理座標系には使用できません。
String
id_field
(オプション)

入力テーブル内のフィールド。このフィールドと値は、出力に加えられ、出力フィーチャを入力テーブル内のレコードと結合するために使用できます。

Field
spatial_reference
(オプション)

出力フィーチャクラスの空間参照。空間参照は、次のいずれかとして指定できます。

  • *.prj ファイルへのパス (例: C:/workspace/watershed.prj)。
  • 適用する空間参照のフィーチャクラスまたはフィーチャ データセットへのパス (例: C:/workspace/myproject.gdb/landuse/grassland)。
  • SpatialReference オブジェクト (*arcpy.SpatialReference("C:/data/Africa/Carthage.prj") など)。

Spatial Reference
attributes
(オプション)

残りの入力フィールドが出力フィーチャクラスに追加されるかどうかを指定します。

  • NO_ATTRIBUTES残りの入力フィールドが出力フィーチャクラスに追加されません。 これがデフォルトです。
  • ATTRIBUTES残りの入力フィールドが出力フィーチャクラスに追加されます。 新しいフィールド ORIG_FID も出力フィーチャクラスに追加され、入力フィーチャ ID の値を格納します。
Boolean

コードのサンプル

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

方位角と距離の情報をラインに変換します。

# Import system modules
import arcpy

# Local variables
input_table = r'c:\workspace\LOBtraffic.dbf'
output_fc = r'c:\workspace\SOPA.gdb\lob_traf001'

# BearingDistanceToLine
arcpy.BearingDistanceToLine_management(input_table, output_fc, 'X', 'Y', 
                                       'NAUTICAL_MILES', 'azim', 'DEGREES', 
                                       'GEODESIC', 'recnum')

関連トピック