XY 转线 (数据管理)

摘要

创建要素类,其中包含基于表的起点 x 坐标字段、起点 y 坐标字段、终点 x 坐标字段和终点 y 坐标字段中的值的大地测量和平面线要素。

使用情况

  • 输出线基于字段值构建。 字段值包括以下内容:

    • 起点的 x 和 y 坐标
    • 终点的 x 和 y 坐标
    这些字段及其值将包含在输出中。

  • 对于大地测量线,x 和 y 坐标是地球表面上的位置。 对于平面线,坐标是投影平面上的位置。

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

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

参数

标注说明数据类型
输入表

输入表。可以是文本文件、CSV 文件、Excel 文件、dBASE 表或地理数据库表。

Table View
输出要素类

输出要素类,其中包含大地测量和平面线。

Feature Class
起点 X 字段

输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 x 坐标(或经度)。

Field
起点 Y 字段

输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的起点 y 坐标(或纬度)。

Field
终点 X 字段

输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的终点 x 坐标(或经度)。

Field
终点 Y 字段

输入表中的数值字段,其中包含在空间参考参数所指定的输出坐标系中进行定位的线的终点 y 坐标(或纬度)。

Field
线类型
(可选)

指定要构造的线类型。

  • 测地线测地线类型,可以最准确地表示将构造的地球表面任意两点之间的最短距离。 这是默认设置。
  • 大圆测地线类型,可以表示将构造的地球表面与通过地心的平面的相交线上任意两点之间的路径。 如果空间参考参数值是基于椭球体的坐标系,则线将为大椭圆。 如果空间参考参数值是基于球体的坐标系,该线表示唯一的大圆(球面上最大半径的圆)。
  • 恒向线测地线类型,又称为等角航线 (loxodrome line),可以表示将构造的通过以极点为起点的等方位角所定义的椭球体表面上的任意两点之间的路径。 等角航线在墨卡托投影中显示为直线。
  • 法向截面测地线类型,可以表示将构造的由椭球体表面与通过椭球体表面上两点并垂直于两点起点处椭球面的平面相交而定义的椭球面上任意两点之间的路径。 从 A 点到 B 点与从 B 点到 A 点的法向截面线不同。
  • 平面线将使用投影平面中的直线。 平面线通常不像测地线那样准确地表示地球表面的最短距离。 此选项不适用于地理坐标系。
String
ID
(可选)

输入表中的字段。此字段和值均包含在输出中,可用于连接输出要素和输入表中的记录。

Field
空间参考
(可选)

输出要素类的空间参考。默认值为 GCS_WGS_1984 或输入坐标系(如果非“Unknown”)。

Spatial Reference
保留属性
(可选)

指定是否将其余输入字段添加到输出要素类。

  • 未选中 - 不会将其余输入字段添加到输出要素类。 这是默认设置。
  • 选中 - 将其余输入字段添加到输出要素类。 还将向输出要素类添加新字段 ORIG_FID 以存储输入要素 ID 值。

Boolean

arcpy.management.XYToLine(in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference}, {attributes})
名称说明数据类型
in_table

输入表。可以是文本文件、CSV 文件、Excel 文件、dBASE 表或地理数据库表。

Table View
out_featureclass

输出要素类,其中包含大地测量和平面线。

Feature Class
startx_field

输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 x 坐标(或经度)。

Field
starty_field

输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的起点 y 坐标(或纬度)。

Field
endx_field

输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的终点 x 坐标(或经度)。

Field
endy_field

输入表中的数值字段,其中包含在 spatial_reference 参数所指定的输出坐标系中进行定位的线的终点 y 坐标(或纬度)。

Field
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

代码示例

XYToLine 示例(独立脚本)

下面的示例用于将 DBF 表转换为两点大地测量线。

# Import system modules
import arcpy

# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"

# XY To Line
arcpy.XYToLine_management(input_table, out_lines, "LOND1", "LATD1", "LOND2",
                          "LATD2", "GEODESIC", "idnum")

许可信息

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

相关主题