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

Сводка

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

Иллюстрация

Показаны параметры построения направления и расстояния.

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

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

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

• Если выходные данные представляют собой класс пространственных объектов файловой базы геоданных, значения в поле Shape_Length всегда указываются в единицах выходной системы координат, задаваемой параметром Пространственная привязка. Они представляют собой плоскостные длины полилиний. Для измерения геодезической длины или расстояния используйте инструмент ArcGIS Pro Измерить; перед измерением выберите соответствующий параметр Геодезия, Локсодромия или Ортодромия.

Синтаксис

arcpy.management.BearingDistanceToLine(in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference}, {attributes})

Parameter	Объяснение	Тип данных
in_table	Входная таблица. Она может быть представлена текстовым файлом, файлом CSV, файлом Excel, таблицей dBase или таблицей базы геоданных.	Table View
out_featureclass	Выходной класс пространственных объектов, содержащий уплотненные геодезические линии.	Feature Class
x_field	Числовое поле во входной таблице, содержащее координаты X (или значения долготы) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
y_field	Числовое поле во входной таблице, содержащее координаты y (или значения широты) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром spatial_reference.	Field
distance_field	Числовое поле во входной таблице, содержащее расстояния от начальных точек для создания выходных линейных объектов.	Field
distance_units (Дополнительный)	Задает единицы для параметра distance_field. METERS —Единицы измерения расстояний - метры. KILOMETERS —Единицами измерения расстояния будут километры. MILES —Единицами измерения расстояния будут мили. NAUTICAL_MILES —Единицами измерения расстояния будут морские мили. FEET —Единицами измерения расстояния будут футы. US_SURVEY_FEET —Единицами измерения расстояния будут U.S. Геодезические футы	String
bearing_field	Числовое поле во входной таблице, содержащее значения угла направления для поворота выходного линейного объекта. Углы изменяются в направлении по часовой стрелке от направления на север.	Field
bearing_units (Дополнительный)	Задает единицы для значений параметра bearing_field. DEGREES — Единицами измерения будут десятичные градусы. Это значение по умолчанию. MILS —Единицами измерения будут мили. RADS —Единицами измерения будут радианы. GRADS —Единицами измерения будут грады.	String
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

Пример кода

BearingDistanceToLine, пример (автономный скрипт)

Конвертирует информацию о направлении и расстоянии в линию.

# Import system modules
import arcpy
# Local variables
input_table = r'c:\workspace\LOBtraffic.dbf'
output_fc = r'c:\workspace\SOPA.gdb\lob_traf001'
# BearingDistanceToLine
arcpy.BearingDistanceToLine_management(input_table, output_fc, 'X', 'Y', 
                                       'NAUTICAL_MILES', 'azim', 'DEGREES', 
                                       'GEODESIC', 'recnum')

Environments

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

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

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