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

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

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

Иллюстрация

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

Входная таблица. Она может быть представлена текстовым файлом, файлом CSV, файлом Excel, таблицей dBase или таблицей базы геоданных.

Table View
Выходной класс объектов

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

Feature Class
Поле X

Числовое поле во входной таблице, содержащее координаты X (или значения долготы) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.

Field
Поле Y

Числовое поле во входной таблице, содержащее координаты Y (или значения широты) начальных точек линии, которые будут помещены в выходную систему координат, заданную параметром Пространственная привязка.

Field
Поле расстояния

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

Field
Единицы расстояния
(Дополнительный)

Определяет единицы измерения, которые будут использоваться для параметра Поле расстояния.

  • МетрыЕдиницами измерения будут метры.
  • КилометрыЕдиницами измерения будут километры.
  • МилиЕдиницами измерения будут мили.
  • Морские милиЕдиницами измерения будут морские мили.
  • ФутыЕдиницами измерения будут футы.
  • Геодезические футы СШАЕдиницами измерения будут геодезические футы США.
String
Поле азимута

Числовое поле во входной таблице, содержащее значения угла направления для поворота выходного линейного объекта. Углы изменяются в направлении по часовой стрелке от направления на север.

Field
Единицы направления
(Дополнительный)

задает единицы измерения для значений параметра Поле направления.

  • Десятичные градусы Единицами измерения будут десятичные градусы. Это значение по умолчанию.
  • МилиЕдиницами измерения будут мили.
  • РадианыЕдиницами измерения будут радианы.
  • ГрадыЕдиницами измерения будут грады.
String
Тип линии
(Дополнительный)

Задает тип создаваемой геодезической линии.

  • Геодезический Создается тип геодезической линии, которая наиболее точно представляет самое короткое расстояние между любыми двумя точками поверхности земли. Математическое определение геодезической линии довольно длинное и сложное и, следовательно, здесь не приводится. Это значение по умолчанию.
  • Большая окружностьТип создаваемой геодезической линии, представляющей путь между двумя точками вдоль пересечения поверхности земли с плоскостью, проходящей через центр земли. В зависимости от выходной системы координат, заданной параметром Пространственная привязка в системе координат на основе сфероида, линия представляет собой большой эллипс. В системе координат на основе сферы линии присваивается уникальное наименование большой окружности (окружности с самым большим радиусом на сферической поверхности).
  • Линия румбаТип создаваемой геодезической линии, также называемой линией локсодромии, представляющей путь между двумя точками по поверхности сфероида, определяемой постоянным азимутом от полюса. Линия румба показана как прямая линия в проекции Меркатора.
  • Нормальная секцияТип создаваемой геодезической линии, представляющей путь между любыми двумя точками на поверхности сфероида, определяемый пересечением поверхности сфероида с плоскостью, проходящей через две точки, который является нормальным (перпендикулярным) по отношению к поверхности сфероида в той из двух точек, которая является начальной. Таким образом, нормальная секущая из точки А в точку B отличается от секущей из точки B в точку А.
String
ID
(Дополнительный)

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

Field
Пространственная привязка
(Дополнительный)

Пространственная привязка выходного набора классов объектов. По умолчанию используется значение GCS_WGS_1984 или входная система координат, если она не имеет значение "Неизвестно" (Unknown).

Spatial Reference
Сохранить атрибуты
(Дополнительный)

Указывает, будут ли остальные входные поля записаны в выходной класс пространственных объектов.

  • Не отмечено – остальные входные поля не будут записаны в выходной класс пространственных объектов. Это значение по умолчанию.
  • Отмечено – остальные входные поля будут записаны в выходной класс пространственных объектов. Новое поле ORIG_FID будет также добавлено к выходному классу объектов, оно будет содержать ID входных объектов.

Boolean

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})
ИмяОписаниеТип данных
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Единицами измерения будут геодезические футы США.
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: Да

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