Справка

XY в линию

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

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

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

  • При использовании текстовых файлов и файлов .csv (значения с разделением запятыми) как входных данных убедитесь в том, что они соответствуют требованиям к структуре файлов, указанным в разделе Об источниках данных таблиц.

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

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

  • Если выходные данные представляют собой класс пространственных объектов в файловой базе геоданных или персональной базе геоданных, значения в поле Shape_Length всегда указываются в единицах выходной системы координат, выраженных параметром Пространственная привязка (Spatial Reference). Они представляют собой плоскостные длины полилиний. Для измерения геодезической длины или расстояния используйте инструмент измерения ArcMap; перед измерением обязательно выберите соответствующий параметр "Геодезия" (Geodesic), "Локсодромия" (Loxodrome) или "Ортодромия" (Great Elliptic).

Синтаксис

XYToLine_management (in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference})
ПараметрОбъяснениеТип данных
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 —Тип геодезической линии, представляющей путь между двумя точками вдоль пересечения поверхности земли с плоскостью, проходящей через центр земли. В зависимости от выходной системы координат, заданной параметром "Пространственная привязка" (Spatial Reference) в системе координат на основе сфероида, линия представляет собой большой эллипс. В системе координат на основе сферы линии присваивается уникальное наименование большой окружности (окружности с самым большим радиусом на сферической поверхности).
  • RHUMB_LINE —Тип геодезической линии, также называемой локсодромической линией, представляющей путь между двумя точками на поверхности сфероида, определяемой постоянным азимутом от полюса. Линия румба показана как прямая линия в проекции Меркатора.
  • NORMAL_SECTION —Тип геодезической линии, представляющей путь между любыми двумя точками на поверхности сфероида, определяемый пересечением поверхности сфероида с плоскостью, проходящей через две точки, который является нормальным (перпендикулярным) по отношению к поверхности сфероида в той из двух точек, которая является начальной. Таким образом, нормальная секущая из точки А в точку B отличается от секущей из точки B в точку А.
String
id_field
(дополнительно)

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

Field
spatial_reference
(дополнительно)

Пространственная привязка выходного набора классов объектов. Вы можете задать пространственную привязку разными путями:

  • Указав путь к файлу .prj, например, C:/workspace/watershed.prj.
  • Путем ссылки на класс пространственных объектов или набор классов объектов, пространственную привязку которых следует применить, например, C:/workspace/myproject.gdb/landuse/grassland.
  • Путем определения объекта пространственной привязки перед использованием инструмента, например, sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj"), который затем используется как параметр пространственной привязки.

Spatial Reference

Пример кода

XY в линию. Пример (автономный скрипт)

Это пример конвертации таблицы DBF в геодезические линии из двух точек.

# Import system modules
import arcpy
from arcpy import env

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

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

Связанные темы

Отзыв по этому разделу?