Подпись | Описание | Тип данных |
Входная таблица | Таблица с координатами x и y, определяющими положения точечных объектов, которые будут созданы. | Table View |
Выходной класс пространственных объектов | Класс пространственных объектов, содержащий выходные точечные объекты. | Feature Class |
Поле X | Поле входной таблицы, которое содержит координаты x (долготу). | Field |
Поле Y | Поле входной таблицы, которое содержит координаты y (широту). | Field |
Поле Z (Дополнительный) | Поле входной таблицы, которое содержит координаты z. | Field |
Система координат (Дополнительный) | Система координат для x и y. Она также будет системой координат выходного класса объектов. | Spatial Reference |
Краткая информация
Создает класс точечных объектов на основе координат x,y и z, заданных в таблице.
Использование
Стандартным разделителем для табличных текстовых файлов с расширениями .csv или .txt является запятая, а для файлов с расширением .tab — табуляция. Чтобы использовать входную таблицу с нестандартным разделителем, необходимо сначала указать необходимый разделитель для таблицы в файле schema.ini.
Поля атрибутов значения параметра Входная таблица будут перенесены в значение параметра Выходной класс объектов.
К выходным данным будет применена система координат, заданная в параметре Система координат. Системой координат определяется, как будут интерпретироваться x-, y- и z-координаты входной таблицы. Поскольку этот инструмент обычно используется для таблиц, содержащих значения широты и долготы, системой координат по умолчанию будет географическая система координат WGS 1984. Если поля с координатами x и y исходной таблицы содержат координаты проекции, укажите соответствующую систему координат проекции.
Если была задана настройка среды Выходная система координат, выходной класс пространственных объектов будет перепроецирован в эту систему из заданной в параметре Система координат.
Если задано Поле Z, система координат по умолчанию также включает вертикальную систему координат WGS 1984. Если значения z записаны не в метрах, измените систему координат, чтобы она использовала корректные единицы измерения высоты.
Значения полей параметров Поле X и Поле Y , равные 0 или Null, считаются допустимыми и будут включены в выходные данные. Координаты со значением 0 будут иметь выходные точечные объекты, размещенные в этом местоположении, в то время как координаты со значением null будут иметь пустую геометрию.
Значения полей параметров Поле X и Поле Y в системе географических координат считаются недопустимыми, если они меньше -400 и больше 400. Выходная запись не будет создана, и в сообщения инструмента будет добавлено предупреждающее сообщение, указывающее на недопустимый ID записи.
Параметры
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 |
Пример кода
Пример скрипта в окне 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))
Следующий автономный 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))
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да