XY 表转点 (数据管理)

描述

根据表中的 x、y 和 z 坐标创建新的点要素类。

使用方法

• 扩展名为 .csv 或 .txt 的表格文本文件的标准分隔符是逗号，扩展名为 .tab 的表格文本文件的标准分隔符是制表符。要使用具有非标准分隔符的输入表格，您必须首先使用 schema.ini 文件来指定用于表格的正确分隔符。

• 在坐标系参数中指定的坐标系将应用于输出。该坐标系确定如何解释输入表中的 x、y 和 z 坐标。由于此工具通常用于包含经度值和纬度值的表，因此默认坐标系是地理坐标系 WGS 1984。如果输入表中的字段包含 x 和 y 坐标，则指定相应的投影坐标系。

  如果已设置输出坐标系环境，则输出要素类将从在坐标系参数中指定的坐标系重新投影到该坐标系。

• 在指定 Z 字段参数时，默认坐标系还包括垂直坐标系 WGS 1984。如果 z 值未以米为单位，请修改坐标系以使用正确的高程单位。

• 如果要素的任一输入 x 或 y（或 z，如果指定）坐标为空值或非数字值，则相应要素将为空几何。检查几何工具可用于检查输出中的空几何。

• 该工具将为输入表中的所有有效记录创建点要素，甚至在表具有一个选择时也是如此。如果仅应使用一个记录子集，请使用复制行工具将所选记录复制到新表中，并使用新表作为输入。

语法

arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})

参数	说明	数据类型
in_table	定义要创建的点要素位置的表（包含 x 和 y 坐标）。	Table View
out_feature_class	包含输出点要素的要素类。	Feature Class
x_field	输入表中包含 X 坐标（或经度）的字段。	Field
y_field	输入表中包含 Y 坐标（或纬度）的字段。	Field
z_field （可选）	输入表中包含 Z 坐标的字段。	Field
coordinate_system （可选）	x 和 y 坐标的坐标系。这将是输出要素类的坐标系。	Spatial Reference

代码示例

XYTableToPoint 示例（Python 窗口）

以下 Python 窗口脚本演示了如何使用 XYTableToPoint 工具。

import arcpy
arcpy.env.workspace = r"c:\output.gdb"
arcpy.management.XYTableToPoint(r"c:\data\tree.csv", "tree_points",
                                "longitude", "latitude", "elevation",
                                arcpy.SpatialReference(4759, 115700))

XYTableToPoint 示例 2（独立脚本）

以下独立 Python 脚本演示了如何使用 XYTableToPoint 工具。

# XYTableToPoint.py
# Description: Creates a point feature class from input table

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = r"c:\output.gdb"

# Set the local variables
in_table = r"c:\data\tree.csv"
out_feature_class = "tree_points"
x_coords = "longitude"
y_coords = "latitude"
z_coords = "elevation"

# Make the XY event layer...
arcpy.management.XYTableToPoint(in_table, out_feature_class,
                                x_coords, y_coords, z_coords,
                                arcpy.SpatialReference(4759, 115700))

# Print the total rows
print(arcpy.GetCount_management(out_feature_class))

环境

当前工作空间, 输出坐标系, 范围

许可信息

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