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

Краткая информация

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

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

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

Если были заданы параметры среды Выходная система координат, то выходной класс пространственных объектов будет перепроецирован в эту систему координат из системы координат, заданной в параметре Система координат.
Если задано значение параметра Поле Z, то в систему координат по умолчанию будет также включена вертикальная система координат WGS84. Если значения z записаны не в метрах, измените систему координат, чтобы она использовала корректные единицы измерения высоты.
Значения координат X и Y, равные 0 или Null, считаются допустимыми и будут включены в выходные данные. Координаты со значением 0 будут иметь выходные точечные объекты, размещенные в этом местоположении, а координаты со значением null будут соответствовать пустой геометрии.
Значения координат X и Y в системе географических координат считаются недопустимыми, если они меньше -400 или больше 400. Выходная запись не будет создана, и в сообщения инструмента будет добавлено предупреждающее сообщение, указывающее на входной ID.
Поля входных координат x, y и z должны быть числовыми. В качестве входных для этого инструмента могут использоваться только значения координат в следующих форматах:
- Десятичные градусы в географической системе координат
- Линейные измерения в системе координат проекции, использующие числа для обозначения положения со смещением по осям x и y от исходного местоположения.
Другие [форматы и обозначения координат] (supported-notation-formats.md) можно использовать в качестве входных для инструмента [Конвертировать обозначения координат(convert-coordinate-notation.yml)].

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

Подпись	Объяснение	Тип данных
Входная таблица	Таблица с координатами X и Y, определяющими положения точечных объектов, которые будут созданы.	Table View
Выходной класс пространственных объектов	Класс пространственных объектов, содержащий выходные точечные объекты.	Feature Class
Поле X	Поле входной таблицы, которое содержит координаты x (долготу).	Field
Поле Y	Поле входной таблицы, которое содержит координаты y (широту).	Field
Поле Z (Дополнительный)	Поле входной таблицы, которое содержит координаты z.	Field
Система координат (Дополнительный)	Система координат для x и y. Она также будет системой координат выходного класса объектов.	Spatial Reference

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.management.GetCount(out_feature_class))

Параметры среды

Текущая рабочая область, Выходная система координат, Экстент

Информация о лицензировании