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

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

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

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

Выходные линии строятся на основе значения полей. Поля значений включают следующие элементы:
- X- и y-коррдинаты начальной точки
- Координаты X и Y конечной точки
Эти поля и значения будут включены в выходной объект.
Для геодезической линии координаты X и Y - это местоположения на поверхности земли. Для планарных линий координаты - это местоположения на проецированной плоскости.
Геодезическая линия представляет собой кривую на поверхности земли. Однако, геодезический линейный объект не сохраняется в выходных данных в виде параметрической (истинной) кривой; скорее, он сохраняется в виде уплотненной полилинии, представляющей собой траекторию геодезической линии. Если длина геодезической линии относительно короткая, в выходных данных она может быть представлена в виде прямой линии. По мере увеличения длины этой линии для отображения траектории используется все больше вершин.
Если выходные данные представляют собой класс пространственных объектов в базе геоданных, то значения в поле Shape_Length всегда указываются в единицах выходной системы координат, заданной параметром Пространственная привязка. Они представляют собой плоскостные длины полилиний. Для измерения геодезической длины или расстояния используйте инструмент Измерить ArcGIS Pro, а перед измерением выберите соответствующий параметр Геодезический, Локсодромия или Ортодромия или большой эллиптический.

Подпись	Объяснение	Тип данных
Входная таблица	Входная таблица. Она может быть представлена текстовым файлом, файлом CSV, файлом Excel, таблицей dBase или таблицей базы геоданных.	Table View
Выходной класс пространственных объектов	Выходной класс пространственных объектов, содержащий геодезические или планарные линии.	Feature Class
Поле X начала	Числовое поле во входной таблице, содержащее координаты X (или значения долготы) начальных точек линий, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.	Field
Поле Y начала	Числовое поле во входной таблице, содержащее координаты Y (или значения широты) начальных точек линий, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.	Field
Поле X окончания	Числовое поле во входной таблице, содержащее координаты X (или значения долготы) конечных точек линий, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.	Field
Поле Y окончания	Числовое поле во входной таблице, содержащее координаты Y (или значения широты) конечных точек линий, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.	Field
Тип линии (Дополнительный)	Задает тип линии, которая будет построена. Геодезический–Создается тип геодезической линии, которая наиболее точно представляет самое короткое расстояние между любыми двумя точками поверхности земли. Используется по умолчанию. Большая окружность–Тип создаваемой геодезической линии, представляющей путь между двумя точками вдоль пересечения поверхности земли с плоскостью, проходящей через центр земли. Если значением параметра Пространственная привязка является система координат на основе сфероида, то линия представляет собой большой эллипс. Если значением параметра Пространственная привязка является система координат на основе сферы, то линия однозначно называется большим кругом - окружностью с самым большим радиусом на сферической поверхности. Линия румба–Тип создаваемой геодезической линии, также называемой линией локсодромии, представляющей путь между двумя точками по поверхности сфероида, определяемой постоянным азимутом от полюса. Линия румба показана как прямая линия в проекции Меркатора. Нормальная секция–Тип создаваемой геодезической линии, представляющей путь между любыми двумя точками на поверхности сфероида, определяемый пересечением поверхности сфероида с плоскостью, проходящей через две точки, который является нормальным (перпендикулярным) по отношению к поверхности сфероида в той из двух точек, которая является начальной. Нормальная линия сечения из точки А в точку B отличается от линии из точки B в точку А. Планарная линия–Будет использоваться прямая линия в проецируемой плоскости. Планарная линия, как правило, не отображает так точно самое короткое расстояние на земной поверхности, как геодезическая линия. Эта опция не доступна для географических систем координат.	String
ID (Дополнительный)	Поле во входной таблице. Это поле и его значения включаются в выходные данные и могут использоваться для соединения выходных объектов с записями во входной таблице.	Field
Пространственная привязка (Дополнительный)	Пространственная привязка выходного набора классов объектов. По умолчанию используется значение GCS_WGS_1984 или входная система координат, если она не имеет значение Неизвестно.	Spatial Reference
Сохранить атрибуты (Дополнительный)	Указывает, будут ли остальные входные поля добавлены в выходной класс пространственных объектов. Отмечено–Остальные входные поля будут добавлены в выходной класс пространственных объектов. Новое поле `ORIG_FID` будет также добавлено к выходному классу объектов, оно будет содержать ID входных объектов. Не отмечено–Остальные входные поля не будут добавлены в выходной класс пространственных объектов. Используется по умолчанию.	Boolean

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

Имя	Объяснение	Тип данных
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 в точку А. `PLANAR`–Будет использоваться прямая линия в проецируемой плоскости. Планарная линия, как правило, не отображает так точно самое короткое расстояние на земной поверхности, как геодезическая линия. Эта опция не доступна для географических систем координат.	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 (Дополнительный)	Указывает, будут ли остальные входные поля добавлены в выходной класс пространственных объектов. `ATTRIBUTES`–Остальные входные поля будут добавлены в выходной класс пространственных объектов. Новое поле `ORIG_FID` будет также добавлено к выходному классу объектов, оно будет содержать ID входных объектов. `NO_ATTRIBUTES`–Остальные входные поля не будут добавлены в выходной класс пространственных объектов. Используется по умолчанию.	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.management.XYToLine(input_table, out_lines, "LOND1", "LATD1", "LOND2",
                          "LATD2", "GEODESIC", "idnum")

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

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

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