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 (или значения долготы) конечных точек линий, которые будут помещены в выходную систему координат, заданную параметром Spatial Reference (Пространственная привязка).

Field
Поле Y окончания

Числовое поле во входной таблице, содержащее координаты Y (или значения широты) конечных точек линий, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.

Field
Тип линии
(Дополнительный)

Задает тип линии, которая будет построена.

  • ГеодезическийСоздается тип геодезической линии, которая наиболее точно представляет самое короткое расстояние между любыми двумя точками поверхности земли. Это значение по умолчанию
  • Большая окружностьТип создаваемой геодезической линии, представляющей путь между двумя точками вдоль пересечения поверхности земли с плоскостью, проходящей через центр земли. Если значением параметра Пространственная привязка является система координат на основе сфероида, то линия представляет собой большой эллипс. Если значением параметра Пространственная привязка является система координат на основе сферы, то линии присваивается уникальное наименование большой окружности - окружности с самым большим радиусом на сферической поверхности.
  • Линия румбаТип создаваемой геодезической линии, также называемой линией локсодромии, представляющей путь между двумя точками по поверхности сфероида, определяемой постоянным азимутом от полюса. Линия румба показана как прямая линия в проекции Меркатора.
  • Нормальная секцияТип создаваемой геодезической линии, представляющей путь между любыми двумя точками на поверхности сфероида, определяемый пересечением поверхности сфероида с плоскостью, проходящей через две точки, который является нормальным (перпендикулярным) по отношению к поверхности сфероида в той из двух точек, которая является начальной. Нормальная линия сечения из точки А в точку B отличается от линии из точки B в точку А.
  • Планарная линияБудет использоваться прямая линия в проецируемой плоскости. Планарная линия, как правило, не отображает так точно самое короткое расстояние на земной поверхности, как геодезическая линия. Эта опция не доступна для географических систем координат.
String
ID
(Дополнительный)

Поле во входной таблице. Это поле и его значения включаются в выходные данные и могут использоваться для соединения выходных объектов с записями во входной таблице.

Field
Пространственная привязка
(Дополнительный)

Пространственная привязка выходного набора классов объектов. По умолчанию используется значение GCS_WGS_1984 или входная система координат, если она не имеет значение "Неизвестно" (Unknown).

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
(Дополнительный)

Указывает, будут ли остальные входные поля добавлены в выходной класс пространственных объектов.

  • 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")

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

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

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