XY в линию (Управление данными)

Сводка

Создает новый класс пространственных объектов, содержащий геодезические линейные объекты, построенные на основе значений поля начальной координаты X, поля начальной координаты Y, поля конечной координаты X и поля конечной координаты Y.

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

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

• Геодезическая линия представляет собой кривую на поверхности Земли. Тем не менее, геодезический линейный объект не хранится как параметрическая (истинная) кривая в выходных данных, вместо этого она сохраняется как уплотненная полилиния, представляющая путь геодезической линии. Длина геодезической линии относительно невелика и может быть представлена в выходных данных прямой линией. По мере увеличения длины линии для представления пути используется большее число вершин.

• Если выходные данные представляют собой класс пространственных объектов файловой базы геоданных, значения в поле Shape_Length всегда указываются в единицах выходной системы координат, задаваемой параметром Пространственная привязка. Они представляют собой плоскостные длины полилиний. Для измерения геодезической длины или расстояния используйте инструмент ArcGIS Pro Измерить; перед измерением выберите соответствующий параметр Геодезия, Локсодромия или Ортодромия.

Синтаксис

arcpy.management.XYToLine(in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference}, {attributes})

Parameter	Объяснение	Тип данных
in_table	Входная таблица. Она может быть представлена текстовым файлом, файлом CSV, файлом Excel, таблицей dBase или таблицей базы геоданных.	Table View
out_featureclass	Выходной класс пространственных объектов, содержащий уплотненные геодезические линии.	Feature Class
startx_field	Числовое поле во входной таблице, содержащее координаты X (или значения долготы) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
starty_field	Числовое поле во входной таблице, содержащее координаты y (или значения широты) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
endx_field	Числовое поле во входной таблице, содержащее координаты X (или значения долготы) конечных точек линий, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
endy_field	Числовое поле во входной таблице, содержащее координаты y (или значения широты) конечных точек линии, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
line_type (Дополнительный)	Задает тип создаваемой геодезической линии. GEODESIC — Создается тип геодезической линии, которая наиболее точно представляет самое короткое расстояние между любыми двумя точками поверхности земли. Математическое определение геодезической линии довольно длинное и сложное и, следовательно, здесь не приводится. Это значение по умолчанию. GREAT_CIRCLE —Тип создаваемой геодезической линии, представляющей путь между двумя точками вдоль пересечения поверхности земли с плоскостью, проходящей через центр земли. В зависимости от выходной системы координат, заданной параметром Пространственная привязка в системе координат на основе сфероида, линия представляет собой большой эллипс. В системе координат на основе сферы линии присваивается уникальное наименование большой окружности (окружности с самым большим радиусом на сферической поверхности). RHUMB_LINE —Тип создаваемой геодезической линии, также называемой линией локсодромии, представляющей путь между двумя точками по поверхности сфероида, определяемой постоянным азимутом от полюса. Линия румба показана как прямая линия в проекции Меркатора. NORMAL_SECTION —Тип создаваемой геодезической линии, представляющей путь между любыми двумя точками на поверхности сфероида, определяемый пересечением поверхности сфероида с плоскостью, проходящей через две точки, который является нормальным (перпендикулярным) по отношению к поверхности сфероида в той из двух точек, которая является начальной. Таким образом, нормальная секущая из точки А в точку B отличается от секущей из точки B в точку А.	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")

Environments

Текущая рабочая область, Временная рабочая область

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

• Basic: Да
• Standard: Да
• Advanced: Да