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

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

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

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