# Типовые сценарии

## Подготовка к измерениям

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. Закройте окно: запись на диск дописывается, процессы конвейера останавливаются.