原点夹角距离定义线 (数据管理)

摘要

创建要素类，该新要素类包含基于表的 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
距离单位 (可选)	指定距离字段参数将使用的单位。 米—单位将为米。 千米—单位将为公里。 英里—单位将为英里。 海里—单位将为海里。 英尺—单位将为英尺。 美国测量英尺—单位将为美国测量英尺。	String
方位角字段	输入表中包含输出线旋转的方位角值的数值字段。 以北为基准方向按顺时针进行测量的角度。	Field
方位角单位 (可选)	指定方位角字段参数值的单位。 十进制度— 单位将为十进制度。这是默认设置。 密耳—单位将为密耳。 弧度—单位将为弧度。 百分度—单位将为百分度。	String
线类型 (可选)	指定要构造的线类型。 测地线—测地线类型，可以最准确地表示将构造的地球表面任意两点之间的最短距离。 这是默认设置。 大圆—测地线类型，可以表示将构造的地球表面与通过地心的平面的相交线上任意两点之间的路径。 如果空间参考参数值是基于椭球体的坐标系，则线将为大椭圆。 如果空间参考参数值是基于球体的坐标系，该线表示唯一的大圆（球面上最大半径的圆）。 恒向线—测地线类型，又称为等角航线 (loxodrome line)，可以表示将构造的通过以极点为起点的等方位角所定义的椭球体表面上的任意两点之间的路径。 等角航线在墨卡托投影中显示为直线。 法向截面—测地线类型，可以表示将构造的由椭球体表面与通过椭球体表面上两点并垂直于两点起点处椭球面的平面相交而定义的椭球面上任意两点之间的路径。 从 A 点到 B 点与从 B 点到 A 点的法向截面线不同。 平面线—将使用投影平面中的直线。 平面线通常不像测地线那样准确地表示地球表面的最短距离。 此选项不适用于地理坐标系。	String
ID (可选)	输入表中的字段。此字段和值均包含在输出中，可用于连接输出要素和输入表中的记录。	Field
空间参考 (可选)	输出要素类的空间参考。默认值为 GCS_WGS_1984 或输入坐标系（如果非“Unknown”）。	Spatial Reference
保留属性 (可选)	指定是否将其余输入字段添加到输出要素类。 未选中 - 不会将其余输入字段添加到输出要素类。 这是默认设置。 选中 - 将其余输入字段添加到输出要素类。 还将向输出要素类添加新字段 ORIG_FID 以存储输入要素 ID 值。	Boolean

Python

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	输入表中的数值字段，其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 x 坐标（或经度）。	Field
y_field	输入表中的数值字段，其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 y 坐标（或纬度）。	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— 单位将为十进制度。这是默认设置。 MILS—单位将为密耳。 RADS—单位将为弧度。 GRADS—单位将为百分度。	String
line_type (可选)	指定要构造的线类型。 GEODESIC—测地线类型，可以最准确地表示将构造的地球表面任意两点之间的最短距离。 这是默认设置。 GREAT_CIRCLE—测地线类型，可以表示将构造的地球表面与通过地心的平面的相交线上任意两点之间的路径。 如果空间参考参数值是基于椭球体的坐标系，则线将为大椭圆。 如果空间参考参数值是基于球体的坐标系，该线表示唯一的大圆（球面上最大半径的圆）。 RHUMB_LINE—测地线类型，又称为等角航线 (loxodrome line)，可以表示将构造的通过以极点为起点的等方位角所定义的椭球体表面上的任意两点之间的路径。 等角航线在墨卡托投影中显示为直线。 NORMAL_SECTION—测地线类型，可以表示将构造的由椭球体表面与通过椭球体表面上两点并垂直于两点起点处椭球面的平面相交而定义的椭球面上任意两点之间的路径。 从 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')

环境

当前工作空间, 临时工作空间