radar_system/docs/workflow.md

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

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

1. Подключите приборы, ВЧ-ключи и антенны (глава Оборудование).
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.

Подробно — в главе Калибровка и предобработка.

Референс

Референс — пустая сцена: то, что должно остаться фоном.

1. Уберите из сцены цели, оставив всё постоянное на своих местах.
2. В окне Preprocessing Setup задайте новое Set name и нажмите Start S21 Reference, затем снимите пары и сохраните набор.

На месте работы, когда сцена изменилась (новое место, переставили радар), снимите временный референс: кнопка Capture Temporary Reference, та же кнопка в веб-интерфейсе или GPIO-кнопка. Сбор приостанавливается на время съёма и продолжается уже с новым референсом.

Наблюдение

1. Выберите режим обработки в Mode: B-scan — дальность во времени для одной пары, GPR — карта земли с объектами, 3D SAR — объём над землёй.
2. Нажмите Start.
3. Настраивайте режим на ходу: изменения применяются сразу и пересчитывают последний результат (глава Режимы обработки). Для 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; формат — в главе Данные на диске.

Если последняя коллекция испорчена (например, в кадр попал человек), нажмите 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): поправка применяется со следующего запуска.

Подробно — в главе Калибровка и предобработка.

Работа без оператора

1. Настройте всё на самой машине с экраном: профиль, наборы, режим, и нажмите Save Config….
2. Установите службу: sudo bash deploy/install-daemon.sh, затем sudo systemctl start radar.service.
3. Управляйте через браузер (http://<машина>:8080/), GPIO-кнопку и локатор.

Глава Веб-интерфейс, кнопка и локатор, раздел «Работа без экрана».

Обновление программы

1. На рабочей станции закоммитьте изменения и выполните deploy/pack-usb.sh (путь к флешке можно не указывать, если подключена одна).
2. На машине закройте окно программы и из корня флешки выполните bash radar_update/update.sh.
3. Проверьте cat ~/Documents/radar_system/RELEASE.

Глава Установка и запуск, раздел «Обновление с флешки».

Окончание работы

1. Нажмите Stop.
2. Нажмите Save Config…, если меняли настройки или наборы.
3. Закройте окно: запись на диск дописывается, процессы конвейера останавливаются.