XY Таблица в точки (Управление данными)

Сводка

Создает новый класс точечных объектов на основе координат x,y и z, заданных в таблице.

Использование

  • Стандартным разделителем для табличных текстовых файлов с расширениями .csv или .txt является запятая, а для файлов с расширением .tab — табуляция. Чтобы использовать входную таблицу с нестандартным разделителем, необходимо сначала указать необходимый разделитель для таблицы в файле schema.ini.

  • К выходным данным будет применена система координат, заданная в параметре Система координат. Системой координат определяется, как будут интерпретироваться x-, y- и z-координаты входной таблицы. Поскольку этот инструмент обычно используется для таблиц, содержащих значения широты и долготы, системой координат по умолчанию будет географическая система координат WGS 1984. Если поля с координатами x и y исходной таблицы содержат координаты проекции, укажите соответствующую систему координат проекции.

    Если была задана настройка среды Выходная система координат, выходной класс пространственных объектов будет перепроецирован в эту систему из заданной в параметре Система координат.

  • Если задано Поле Z, система координат по умолчанию также включает вертикальную систему координат WGS 1984. Если значения z записаны не в метрах, измените систему координат, чтобы она использовала корректные единицы измерения высоты.

  • Если любые из входных координат x- или y- (или z-, при их наличии) объекта некорректны (null или нечисловые значения), этот объект получит нулевую геометрию. Можно использовать инструмент Проверить геометрию, чтобы проверить наличие нулевой геометрии в выходных данных.

  • Этот инструмент создаст точечные объектов для всех корректных записей в выходной таблице, даже если таблица содержит выборку. Если необходимо использовать только поднабор записей, применяйте инструмент Копировать строки для копирования выбранных строк в новую таблицу, и укажите эту таблицу как входную.

Синтаксис

arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})
ParameterОбъяснениеТип данных
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: Да

Связанные разделы