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

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

Создает новый класс пространственных объектов, содержащий геодезические линейные объекты, построенные на основе значений поля начальной координаты 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 в точку А.
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: Да

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