====== Формат данных топосъемки ======

В простейшем случае файл с данными выглядит так:
  survey Dyrka 
    centerline
      data normal from to lenght compass clino left right up down
        ...
        # тут вместо точек сами данные
    endcenterline
  endsurvey 
Пара команд survey/endsurvey является оболочкой для части топосъемки. 
Внутри может быть много разных вещей, в том числе другие части (survey). 
У каждой части должно быть своё имя, чтобы различать пикеты с одинаковыми 
номерами и связывать части между собой. Наиболее важный элемент это centerline/endcenterline. 
Внутри centerline находится:   
  * описание данных, где описываются единицы измерения, отклонения, погрешности, порядок данных в топосъемке и т.п. 
  * собственно данные из пикетажки.

В данном примере всего одна строка описания данных, где указано
только что это обычная (normal) топосъемка и порядок значений в строчке с данными.
Кроме обычной топосъемки (с компасом, рулеткой и угломером) бывает 
топосъемка для подводников (diving), с использованием Топофила (topofil) и 
другие варианты. По умолчанию длины указываются в метрах, а углы в градусах.

Все данные должны идти в том же порядке, как они перечислены 
в строке data. 
В данном примере используется стандартный набор:
from (первый пикет), to (второй пикет), lenght (длина между первым и вторым) 
compass (азимут с первого на второй), clino (угол наклона с первого на второй),
left, right (расстояние до левой и правой стен от второго пикета), 
up down (расстояние до верха и низа от второго пикета). 
Если у вас уже готовы данные в 
другом порядке, например, длина (length) у вас идет после азимута (compass) 
- не редактируйте свои данные, просто переставьте слова в описании. 
Если вы не записали данные LRUD (влево, вправо, вверх и вниз) - просто 
уберите эти слова из описания. 

Практически на все случаи жизни есть ключевые слова, 
например, если при топосъемке вы брали обратный азимут (или угол)
то вместо вычисления прямых величин достаточно написать “backcompass” и “backclino”, и т.д.
Для дайверов есть параметр “depth” (глубина). 
Полный список ключевых слов можно найти в thbook.pdf

====== Подробнее о данных LRUD ======
При создании подложки для карты считается, что ход линейно сужается 
(или расширяется) от первого пикета ко второму (получится трапеция). 

//Это важно помнить топосъемщику. Например, если вправо до стены два метра, 
но в полуметре от пикета навалены камни (или в стене дыра и ход на тридцать метров), 
то в пикетажке на пункте "влево" могут написать 0.5 метра, или "завал" (или 30 метров, или "ход"). 
А должна быть написана длина до предполагаемой стены (два метра, а никак не тридцать метров, и не полметра). 
То есть, при топосъемке надо мысленно закопать боковые ходы и расчистить ход от лишних 
валунов, и в пикетажку записать расстояние до места, где __должна__ быть стена текущего участка хода. 
//

По умолчанию все боковые измерения относятся ко **второму** пикету, 
и дальше везде, где ещё встречается пикет с таким номером, 
используются эти же измерения. 
Чтобы указать измерения и для первого пикета тоже, нужно 
написать в одной строке данных параметры и для первого, и для второго пикетов, 
взяв эти величины в квадратные скобки. Например:
  data normal from to length compass clino left right up down
     s0    s1       4.50     29       0     1.5   0    2  0
     s1    s2       3.00     33      -3     2     0.8  2  0
     s1    g23      7.50    129      18  [0.3 0] [0 0.4] [0.5 0.5]  [0 0]  
Здесь из широкого хода (s0-s2) в точке s1 отходит узкий низкий боковой лаз (s1-g23). 
Поэтому в третьей строке указаны новые измерения на пикете s1. В частности, влево 
до стены не полтора метра (как было померяно с пикета s0), а всего 0.3, и 
высота на пикете s1 не 2 метра, а всего 0.5 метра. Вторые числа в скобках 
относятся к пикету g23.

====== Ввод данных в редакторе xTherion ======
Если вы набираете данные прямо в редакторе xTherion, то надо сразу после 
строки с форматом данных (data normal ...) нажать на кнопку "обновить формат данных" 
на панели справа, тогда под кнопкой появятся нужные поля ввода. 
В первые два будут подставляться подряд идущие номера пикетов, а после ввода 
данных и нажатия enter в последней строке 
все числа будут перенесены на место курсора. 

Если в поле ввода указать не одно, а несколько значений, то система выведет их в 
квадратных скобках (это нужно, например, когда указывается ширина или высота 
хода и на первом, и на втором пикетах).

===== Замечание 1 =====
В каждой строке с данными величин должно быть ровно столько, 
сколько перечислено в описании данных, иначе будет ошибка компиляции.
Все пробелы и табуляции сделаны только для красоты, и на результат никак не повлияют. 
То есть, если при топосъемке не замеряли длину от пикета влево 
(под тем предлогом что там ход, или ниша, или валун), то здесь 
придется проявить фантазию и 
все-таки написать какое-то число. И лучше это будет не ноль, а что-то более 
правильное. 

===== Замечание 2 =====

Если у вас уже набрана нитка хода для survex, то её можно вставить не редактируя, 
а данные измерений LRUD (влево вправо вверх вниз) записать отдельно, например так:
  data dimensions station left right up down