Расстояние в линию (Bearing Distance To Line) (Управление данными (Data Management))

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

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

Рисунок

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

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

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

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

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

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

Синтаксис

BearingDistanceToLine_management (in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference})

Параметр	Объяснение	Тип данных
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). METERS —Значения в метрах (по умолчанию). KILOMETERS —Значения в километрах. MILES —Значения в милях. NAUTICAL_MILES —Значения в морских милях. FEET —Значения в международных футах. US_SURVEY_FEET —Значения в геодезических футах США.	String
bearing_field	Числовое поле во входной таблице, содержащее значения угла направления для поворота выходного линейного объекта. Углы изменяются в направлении по часовой стрелке от направления на север.	Field
bearing_units (дополнительно)	Единицы измерения значений в поле "Направление" (Bearing). DEGREES —Значения в десятичных градусах (по умолчанию). MILS —Значения в милях. RADS —Значения в радианах. GRADS —Значения в градах.	String
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

Пример кода

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

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

# Import system modules
import arcpy
from arcpy import env

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

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

Текущая рабочая область (Current Workspace), Временная рабочая область (Scratch Workspace)

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

ArcGIS for Desktop Basic: Да

ArcGIS for Desktop Standard: Да

ArcGIS for Desktop Advanced: Да