Files
radar_system/docs/workflow.md
T
2026-10-16 18:35:02 +03:00

112 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Типовые сценарии
## Подготовка к измерениям
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. Закройте окно: запись на диск дописывается, процессы конвейера останавливаются.