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

摘要

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

插图

Bearing and distance construction parameters

用法

• 如果输入的是文本文件和 .csv（逗号分隔值）文件，请确保其符合 About_tabular_data_sources 中指定的文件结构。

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

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

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

语法

BearingDistanceToLine_management (in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference})

参数	说明	数据类型
in_table	输入表，可以是文本文件、CSV 文件、Excel 文件、dBASE 表或地理数据库表。	Table View
out_featureclass	包含增密测地线的输出要素类。	Feature Class
x_field	输入表中的数值字段，其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 x 坐标（或经度）。	Field
y_field	输入表中的数值字段，其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 y 坐标（或纬度）。	Field
distance_field	输入表中包含从起点出发用于创建输出线的距离的数值字段。	Field
distance_units (可选)	“距离”字段中的值的单位。 METERS —值以米为单位；这是默认单位。 KILOMETERS —值以千米为单位。 MILES —值以英里为单位。 NAUTICAL_MILES —值以海里为单位。 FEET —值以国际英尺为单位。 US_SURVEY_FEET —值以美国测量英尺为单位。	String
bearing_field	输入表中包含输出线旋转的方位角值的数值字段。方位角以北为基准方向按顺时针进行测量。	Field
bearing_units (可选)	“方位角”字段中的值的单位。 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。 在使用此工具之前定义空间参考对象，例如之后要用作空间参考参数的 sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj")。	Spatial Reference

代码实例

BearingDistanceToLine 示例（独立脚本）

将方位角和距离转换为线。

# Import system modules
import arcpy
from arcpy import env

# 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")

环境

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

许可信息

ArcGIS for Desktop Basic:是

ArcGIS for Desktop Standard:是

ArcGIS for Desktop Advanced:是