added docs

docs/glossary.md

@@ -0,0 +1,64 @@
+# Словарь
+
+Русские термины — по алфавиту, за ними термины, которые пишутся латиницей.
+
+| Термин | Значение |
+| --- | --- |
+| А-скан | профиль дальности одной пары: амплитуда отражения в зависимости от расстояния; получается обратным преобразованием Фурье развёртки S21 |
+| апертура | набор точек, из которых снята сцена. В 3D SAR — текущая коллекция и до `SAR_FRAME_RADIUS` предыдущих |
+| боковой лепесток | ложный слабый пик рядом с настоящим на А-скане или изображении; появляется из-за того, что полоса частот ограничена |
+| ВАЦ (векторный анализатор цепей, VNA) | прибор, который выдаёт синусоиду заданной частоты и измеряет амплитуду и фазу прошедшего сигнала; в системе — LibreVNA |
+| ведомый прибор (slave) | LibreVNA многоприборной схемы, который только принимает |
+| воксель | ячейка трёхмерной сетки 3D SAR |
+| временный референс | референс, снятый одной кнопкой во время работы; хранится как набор `tmp_reference` |
+| вход (input) | приёмная сторона пары: номер приёмной антенны |
+| ВЧ-ключ | коммутатор H7992: подключает порт прибора к одной из антенн (их до четырёх) по двум логическим линиям |
+| выход (output) | передающая сторона пары: номер передающей антенны; у LibreVNA совпадает с номером стадии прибора |
+| геометрия антенн | координаты передающих и приёмных антенн в осях радара, таблицы **Tx geometry** и **Rx geometry** |
+| дальность | половина пути волны от передающей антенны через отражатель к приёмной; в GPR и 3D SAR — расстояние вдоль оси обзора радара |
+| дБ | логарифмическая мера отношения: для амплитуд 20·lg, для мощностей 10·lg |
+| дБм | мощность в децибелах относительно 1 мВт |
+| калибровка (through) | эталонное измерение тракта; каждая развёртка делится на него |
+| калибровка по объекту | поправка пар по известному отражателю, выравнивающая их по фазе |
+| ключ радара (`radar_key`) | строка из настроек железа; по ней находятся наборы, снятые при тех же настройках |
+| когерентное суммирование | сложение комплексных значений с учётом фазы: вклады настоящего отражателя складываются, остальные гасятся |
+| коллекция (collection) | все пары, снятые за один обход; единица данных в программе |
+| кольцо (ring) | кольцевой буфер в разделяемой памяти, через который процессы передают кадры |
+| копия кольца (tap) | кольца `raw_tap` и `preprocessed_tap`: копии для окна программы |
+| локатор | TCP-сервер процессора: отдаёт объекты GPR и принимает скорость |
+| мастер (master) | LibreVNA многоприборной схемы, который излучает и задаёт запуск |
+| набор (предобработки) | сохранённое измерение для предобработки: калибровка, референс или калибровка по объекту |
+| набор данных | каталог с сохранёнными коллекциями и результатами |
+| нейтральные наборы | калибровка, равная 1, и референс, равный 0: данные проходят предобработку без изменений |
+| обратная проекция | построение изображения: для каждой точки сумма значений А-сканов всех пар на задержке до этой точки |
+| обратное преобразование Фурье | пересчёт значений по частотам в значения по времени (задержке); переводит развёртку S21 в А-скан |
+| окно Ханна | плавное взвешивание частот перед преобразованием Фурье, снижающее боковые лепестки |
+| окно съёма | время начала и конца измерения по монотонным часам компьютера; есть у коллекции и у каждой трассы |
+| пара (combo) | сочетание передающей и приёмной антенны, записывается `вход:выход` |
+| переключение стимула внутри частотной точки | режим многоприборной схемы, в котором каждый порт мастера на каждой частоте излучает через оба положения ключа; даёт матрицу 4 × 4 |
+| полоса ПЧ (IF bandwidth) | полоса фильтра приёмника ВАЦ; чем уже, тем меньше шум и медленнее развёртка |
+| предельная дальность | дальность, после которой А-скан повторяется: c / (2Δf) |
+| препроцессор | процесс `data_preprocessor`: калибровка, вычитание референса, режекторный фильтр, калибровка по объекту |
+| проекция максимума | плоская картинка объёма: в каждой её точке — наибольшее значение вдоль направления взгляда |
+| профиль | файл JSON со всеми настройками программы |
+| процесс сбора | процесс, который управляет железом и публикует коллекции |
+| процессор | процесс `data_processor`: режимы обработки и локатор |
+| развёртка (sweep) | один проход прибора по списку частот |
+| разрешение по дальности | наименьшее расстояние между двумя отражателями, при котором они видны раздельно: c / (2B) |
+| ревизия настроек | номер набора настроек обработки; процессор возвращает его в каждом результате |
+| режекторный фильтр (notch) | обнуление заданных полос частот |
+| режим обработки | что процессор делает с данными: pass-through, B-scan, GPR, 3D SAR |
+| референс | измерение пустой сцены; вычитается как фон |
+| симулятор | работа без железа (`driver_mode: "mock"`): программа моделирует один движущийся отражатель |
+| стадия прибора | одно излучение на частоте: на каждой частоте прибор проходит все стадии по очереди |
+| угол обзора | наклон радара вниз от горизонтали |
+| фон кадра | медиана рабочей части объёма 3D SAR (ненулевые воксели опорных плоскостей); без объектов CLEAN кадр показывается, когда его максимум превышает фон в 6 раз |
+| частотная точка | одна частота развёртки |
+| ширина на половине максимума | ширина отклика на уровне половины его пика; её размер имеет квадрат, которым 3D SAR отмечает максимум |
+| B-scan | изображение «номер развёртки — дальность» для одной пары |
+| CLEAN | алгоритм, который по шагам вычитает самый сильный отклик, чтобы разделить объекты |
+| GPR | режим обработки: изображение плоскости земли перед радаром и поиск объектов на нём |
+| live-файл | `python_app/runtime/processing_live.json`: настройки обработки, которые программа передаёт процессору на ходу |
+| RPH (радиофотонный радар) | радар, в котором СВЧ-сигнал формируется лазерами; данные оцифровывает АЦП E-502 или плата RFG |
+| S21 | комплексный коэффициент передачи из порта 1 в порт 2: отношение принятой волны к поданной, то есть ослабление и сдвиг фазы |
+| SAR (3D SAR) | радар с синтезированной апертурой; режим, строящий трёхмерное изображение сцены |