added docs

docs/workflow.md

@@ -0,0 +1,111 @@
+# Типовые сценарии
+
+## Подготовка к измерениям
+
+1. Подключите приборы, ВЧ-ключи и антенны (глава [Оборудование](hardware.md)).
+2. Запустите программу с профилем установки:
+   `./start.sh --profile <профиль>`. Проверьте в секции **Radar** развёртку, а под
+   полями — пределы прибора: если они прочитаны, прибор на связи.
+3. Нажмите **Apply Radar**.
+4. Убедитесь, что в **Selected Preprocess Sets** выбраны наборы, снятые при этой
+   развёртке. Если списки пусты — снимите калибровку и референс (ниже).
+5. Выберите режим pass-through (**Mode**), нажмите **Single Capture** и посмотрите
+   S21 каждой пары: у всех пар должен быть сигнал, без пар на уровне шума.
+   **Single Capture**, как и **Start**, требует выбранных наборов; при первой настройке
+   сигнал каждой пары виден на графиках окна предобработки во время съёма калибровки.
+
+## Калибровка
+
+Калибровку (through) снимают при первой настройке установки, после замены кабелей,
+ключей или антенн и после смены развёртки: другая развёртка — другой ключ радара, и
+старые наборы для неё не видны.
+
+1. Нажмите **Preprocessing…**, задайте **Set name** и
+   **Sweeps per combo (median)**.
+2. Подготовьте эталонный тракт для калибровки и нажмите **Start S21 Calibration**.
+3. Снимайте пары (**Capture Current Combo** или **Capture All Remaining**), проверяя
+   каждую развёртку на графике; неудачную переснимите через **Undo Last Capture**.
+4. Нажмите **Save Captured Set**.
+
+Подробно — в главе [Калибровка и предобработка](preprocessing.md).
+
+## Референс
+
+Референс — пустая сцена: то, что должно остаться фоном.
+
+1. Уберите из сцены цели, оставив всё постоянное на своих местах.
+2. В окне **Preprocessing Setup** задайте новое **Set name** и нажмите
+   **Start S21 Reference**, затем снимите пары и сохраните набор.
+
+На месте работы, когда сцена изменилась (новое место, переставили радар), снимите
+временный референс: кнопка **Capture Temporary Reference**, та же кнопка в
+веб-интерфейсе или GPIO-кнопка. Сбор приостанавливается на время съёма и
+продолжается уже с новым референсом.
+
+## Наблюдение
+
+1. Выберите режим обработки в **Mode**: B-scan — дальность во времени для одной
+   пары, GPR — карта земли с объектами, 3D SAR — объём над землёй.
+2. Нажмите **Start**.
+3. Настраивайте режим на ходу: изменения применяются сразу и пересчитывают последний
+   результат (глава [Режимы обработки](processing.md)). Для GPR и 3D SAR задайте
+   высоту радара и угол обзора, как на установке.
+4. Если радар движется, скорость передаёт клиент локатора; без него включите
+   **Ignore socket speed** и задайте скорость вручную.
+5. Нажмите **Save Config…**, когда настройки подобраны.
+
+## Сохранение данных
+
+- Сохранить то, что уже есть в памяти (до 1000 коллекций каждой стадии): задайте
+  **Path** и **Name**, нажмите **Save Last 1000**.
+- Записать следующие N коллекций: задайте **Sweeps to record**, **Path** и **Name**,
+  нажмите **Start + Record to Disk**. Ход записи виден в журнале и в веб-интерфейсе.
+- Нужны развёртки S21 в JSON для других программ — **Save S21 JSON**.
+
+Набор данных — новый каталог в **Path**; формат — в главе
+[Данные на диске](data.md).
+
+Если последняя коллекция испорчена (например, в кадр попал человек), нажмите
+**Remove Last Measurement**: она удалится из истории в памяти. Уже записанные на диск
+файлы останутся, а идущая запись на диск при этом завершится.
+
+## Калибровка по объекту
+
+Нужна, когда изображение GPR или 3D SAR размыто из-за того, что пары не совпадают по
+фазе.
+
+1. Поставьте металлический шар в сцену и измерьте положение его центра.
+2. Нажмите **Preprocessing…**, затем **Create…** рядом с **Object calibration**.
+3. Нажмите **Capture Data** и впишите X, Y, Z центра шара. Повторите для других
+   положений, если нужно.
+4. Нажмите **Calculate and Save** и проверьте карты фаз **Before** и **After**.
+5. Перезапустите сбор (**Stop**, затем **Start**): поправка применяется со следующего
+   запуска.
+
+Подробно — в главе [Калибровка и предобработка](preprocessing.md).
+
+## Работа без оператора
+
+1. Настройте всё на самой машине с экраном: профиль, наборы, режим, и нажмите
+   **Save Config…**.
+2. Установите службу: `sudo bash deploy/install-daemon.sh`, затем
+   `sudo systemctl start radar.service`.
+3. Управляйте через браузер (`http://<машина>:8080/`), GPIO-кнопку и локатор.
+
+Глава [Веб-интерфейс, кнопка и локатор](web.md), раздел «Работа без экрана».
+
+## Обновление программы
+
+1. На рабочей станции закоммитьте изменения и выполните `deploy/pack-usb.sh` (путь к
+   флешке можно не указывать, если подключена одна).
+2. На машине закройте окно программы и из корня флешки выполните
+   `bash radar_update/update.sh`.
+3. Проверьте `cat ~/Documents/radar_system/RELEASE`.
+
+Глава [Установка и запуск](installation.md), раздел «Обновление с флешки».
+
+## Окончание работы
+
+1. Нажмите **Stop**.
+2. Нажмите **Save Config…**, если меняли настройки или наборы.
+3. Закройте окно: запись на диск дописывается, процессы конвейера останавливаются.