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

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

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

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

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 в точку А.
  • PLANARБудет использоваться прямая линия в проецируемой плоскости. Планарная линия, как правило, не отображает так точно самое короткое расстояние на земной поверхности, как геодезическая линия. Эта опция не доступна для географических систем координат.
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: Да

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