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

描述

用于创建要素类，该新要素类包含基于表的 x 坐标字段、y 坐标字段、方位角字段和距离字段中的值构建的大地测量线要素。

插图

将显示方位角和距离构造参数。

使用方法

• 每一条大地测量线均使用一组特定的字段值构建，这些字段值分别表示起点的 x 坐标和 y 坐标、从起点出发的距离以及北偏方位角。这些字段和值将包含在输出中。

• 测地线是地球表面上的曲线。但在输出中，测地线要素不是以参数（真）曲线形式存储的，而是以表示测地线路径的增密折线形式进行存储。如果测地线的长度相对较短，则在输出中可能由直线表示。随着线长度的增加，需要使用更多的折点来表示路径。

• 如果输出的是文件地理数据库中的要素类，则 Shape_Length 字段中的值始终使用由空间参考参数所指定的输出坐标系的单位；并且该值表示折线的平面长度。要测量测地线的长度或距离，请使用 ArcGIS Pro 测量工具并在测量之前相应地选择测地线、等角航线或大椭圆选项。

语法

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 点的法向截面线不同。	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')

环境

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

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是