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

Сводка

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

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

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

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