Skip to content

guide.md

Latest commit

 

History

History
644 lines (422 loc) · 31.9 KB

guide.md

File metadata and controls

644 lines (422 loc) · 31.9 KB
Raw

Руководство пользователя AzimuthWebSuite

Версия: 1.3.3

Содержание

  1. Введение
  2. Установка и запуск
  3. Интерфейс
  4. Подключение оборудования
  5. Топопривязка
  6. Работа с маяками
  7. Треки
  8. Калибровка
  9. Точки интереса (POI)
  10. Запись и воспроизведение логов
  11. Анализ логов
  12. Экспорт данных
  13. Отчёт DRMS
  14. Линейка
  15. Темы оформления
  16. Настройки
  17. Горячие клавиши и жесты
  18. Форматы файлов
  19. Устранение неполадок

Введение

AzimuthWebSuite — браузерное приложение для работы с гидроакустической системой позиционирования Zima2 USBL.

Основные сценарии использования

  • Поиск и отслеживание подводных объектов — маяков-ответчиков, установленных на ТНПА, водолазов, стационарные объекты
  • Навигация ТНПА — отображение положения относительно судна в реальном времени
  • Калибровка антенны — компенсация инструментальных ошибок USBL-антенны
  • Анализ точности — расчёт DRMS по трекам маяков
  • Документирование работ — запись логов, экспорт треков, отметка находок (POI)

Системные требования

  • Браузер на базе Chromium (Chrome 89+, Edge 89+, Opera 75+)
  • Web Serial API (включён по умолчанию)
  • Разрешение экрана от 480×800 (адаптивный дизайн)

Установка и запуск

Онлайн-версия

Откройте в браузере: https://docs.unavlab.com/AzimuthWebSuite/

Локальный запуск

  1. Скачайте все файлы из репозитория
  2. Поместите в одну папку
  3. Откройте index.html в браузере

Сервер не требуется. Приложение работает полностью на клиенте.

Android

Используйте UCNL Launcher — обёртку WebView с поддержкой Web Serial API.

Интерфейс

Мастер начальной настройки

При первом запуске приложения автоматически открывается мастер настройки. Он помогает быстро сконфигурировать режим работы антенны без изучения всех настроек.

Мастер состоит из двух или трёх шагов в зависимости от выбранного режима.

Шаг 1: Режим антенны

img
Мастер настройки — выбор подвижности антенны
  • Неподвижна — антенна зафиксирована (пирс, стоящее судно). Можно работать в метрических координатах X, Y, Z без топопривязки.
  • Движется — антенна на подвижном судне. Требуется внешний GNSS-компас.

Шаг 2а: Координаты (для неподвижной антенны)

Если антенна неподвижна, мастер предлагает выбор:

  • Нет, работать в метрах X, Y, Z — включается декартов режим. Антенна считается в точке (0, 0, 0), координаты маяков отображаются в метрах: X → вправо, Y → вперёд, Z → глубина. Топопривязка не требуется.
  • Да, сейчас введу — включается географический режим и сразу открывается панель ручной топопривязки для ввода координат и курса.

Шаг 2б: GNSS-компас (для подвижной антенны)

Если антенна подвижна, мастер предлагает подключить внешний GNSS-компас:

  • Выберите скорость порта (4800–115200 бод, по умолчанию 38400)
  • Нажмите 📡 Подключить и проверить
  • Статус покажет результат подключения: «✓ Подключен» или «✗ Не подключен»
  • Нажмите Готово для завершения настройки

Завершение

На последнем шаге доступна опция «Больше не показывать» — мастер не будет открываться при следующих запусках.

Вызвать мастер повторно можно через 🔧 Инструменты → ⚙ Мастер настройки.

Режимы работы

Режим Антенна Координаты маяков Топопривязка
Декартов Неподвижна (0,0,0) X, Y, Z в метрах Не требуется
Географический По GNSS или вручную Широта, долгота Обязательна

Верхняя панель

img
Верхняя панель приложения
Элемент Описание
Индикатор Зелёный — подключено, жёлтый (мигает) — опрос активен, красный — не подключено
Название устройства Zima2 USBL (после опроса — модель и серийный номер). При подключении маяка-ответчика дополнительно отображается кнопка '⚙' настроек маяка
Строка статуса Текущее состояние / последнее действие

Кнопки управления

Кнопка Назначение
🎨 Циклическое переключение тем
🔌/⏏ AZM Подключение/отключение Zima2
📡/⏏ GNSS Подключение/отключение внешнего GNSS-компаса
▶/⏸ Опрос Запуск/остановка опроса маяков
⚙ Настройки Открыть окно настроек
🔧 Инструменты Выпадающее меню: топопривязка, POI, калибровки, DRMS, конвертер координат
📤 Экспорт Выпадающее меню: CSV, GGA, PSIMSSB, KML
📋 Лог Выпадающее меню: сохранить, открыть, анализ, воспроизвести

Карта

img
Панель карты
  • Центр — антенна USBL (ромб)
  • Направление — красная линия от антенны (курс)
  • Маяки — цветные круги с номерами
  • Сетка — ячеки постоянного размера в пикселях, оси — через центр антенны
  • Масштабная линейка — в правом нижнем углу

Кнопки управления

Кнопка Назначение
Треки Переключение отображения треков
Очистить Удаление накопленных треков
Линейка Включение/Выключение инструмента для измерения расстояний на панели карты
Прогресс воспроизведения лога Только при воспроизведении лога (файла журнала)
- Только при воспроизведении лога (файла журнала). Уменьшить скорость воспроизведения
1x/2x/4x/8x Только при воспроизведении лога (файла журнала). Текущая скорость воспроизведения
+ Только при воспроизведении лога (файла журнала). Увеличить скорость воспроизведения

Панель маяков

img
Панель маяков

В нижней части экрана — карточки всех активных маяков:

  • Номер, дистанция, азимут, глубина
  • Уровень сигнала (dB)
  • Напряжение батареи маяка (V) и температура воды (°C)
  • Координаты (если есть топопривязка)
  • Возраст данных (с) — зелёный/жёлтый/красный
  • Кнопка 📌 — отметить текущее положение маяка как POI

Клик по карточке маяка - поместить и удерживать в центре панели карты указанный маяк.

Информация об антенне

img
Карточка антенны

В левом верхнем углу карты:

  • Широта, долгота
  • Азимут (Heading)
  • Скорость и курс движения (SOG/COG)
  • Глубина, температура воды
  • Углы крена и дифферента (Pitch/Roll)

Клик по карточке антенны - поместить и удерживать в центре панели карты антенну.

Подключение оборудования

Zima2 USBL

  1. Подключите Zima2 к USB-порту (или через преобразователь RS-232/RS-422)
  2. Нажмите 🔌 AZM
  3. Выберите порт в диалоге браузера
  4. Скорость: 9600 бод (по умолчанию)
  5. После подключения автоматически запросится информация об устройстве
  6. После получения информации автоматически запустится опрос маяков

Важно: Не отключайте питание Zima2 во время опроса. Если опрос активен, индикатор мигает жёлтым.

Внешний GNSS-компас

  1. Подключите GNSS-приёмник ко второму порту
  2. Нажмите 📡 GNSS
  3. Выберите порт
  4. Скорость по умолчанию: 38400 бод (настраивается в ⚙ Настройки)

Поддерживаемые сообщения NMEA 0183:

  • $xxRMC — координаты, скорость, курс
  • $xxHDT — истинный курс (предпочтительный)
  • $xxHDM — магнитный курс

Топопривязка

Для отображения маяков в географических координатах необходима топопривязка — координаты и курс антенны.

Автоматическая топопривязка

При подключении внешнего GNSS-компаса позиция и курс обновляются автоматически.

Ручная топопривязка

  1. Откройте 🔧 Инструменты → 🌐 Ручная топопривязка
  2. Введите:
    • Широту (градусы, -90…+90)
    • Долготу (градусы, -180…+180)
    • Курс (градусы, 0…360)
  3. Нажмите ✓ Применить

GPS телефона

Кнопка 📱 GPS — запрашивает геолокацию устройства (если есть встроенный GPS).

Сброс топопривязки

Кнопка 🗑 Сброс — очищает координаты и курс.

Работа с маяками

Маска адресов

В настройках можно выбрать, какие маяки опрашивать (адреса 1–16). Маска задаётся числом (сумма битов) или чекбоксами.

Отображение

  • Цветной круг — маяк в зоне видимости
  • Серый крестик — точка отвергнута фильтром
  • Значок ✕ — таймаут (нет ответа > 20 с)
  • Значок ! — устаревшие данные (> 8 с)

Фильтр маяка (DH)

Настраивается в ⚙ Настройки:

  • Максимальная скорость маяка — точки с большей скоростью перемещения отбрасываются (0.5–5 м/с)
  • Фильтр адаптируется под дальность: на больших дистанциях порог выше

Сглаживание координат

  • На дистанциях до 1000 м — медианный фильтр (окно 5 точек)
  • На дистанциях более 1000 м — без сглаживания

Треки

Трек станции (антенны)

Строится автоматически при наличии GNSS-данных. Отображается голубой линией.

Треки маяков

Каждый маяк имеет свой трек (цветной линией). Точки добавляются после прохождения DH-фильтра.

Управление треками

Кнопка Действие
📐 Треки Показать/скрыть все треки
🗑 Очистить Удалить все треки (с подтверждением)

Настройки треков (⚙ Настройки)

  • Макс. точек на трек — ограничение длины (50–10000)
  • Мин. дистанция — минимальное расстояние между точками (0.1–50 м)

Калибровка

Калибровка φ (угловое смещение антенны)

Назначение: компенсация угла между нулём антенны и диаметральной плоскостью судна.

Порядок выполнения:

  1. Откройте 🔧 Инструменты → Калибровки → 🔧 Калибровка φ
  2. Задайте параметры:
    • От/До угла — диапазон поиска (обычно 0°–360°)
    • Шаг — точность подбора (обычно 1°)
    • Точек — максимальное количество измерений (обычно 100)
  3. Нажмите ▶ Старт
  4. Выполните манёвр судна (циркуляция вокруг маяка или движение по прямой)
  5. Накопление точек остановится автоматически при достижении лимита или нажмите ⏹ Стоп
  6. Подтвердите применение значения φ

Принцип работы: перебирает значения φ с заданным шагом, для каждого считает DRMS облака точек маяка, выбирает φ с минимальным DRMS.

Важно: Калибровку φ можно выполнять по двум схемам: в первой схеме маяк неподвижен, а судно маневрируе так, чтобы маяк был виден под разными углами. Во второй схеме антенна должна быть неподвижна, а маяк должен перемещаеться так, чтобы покрыть максимально возможный диапазон углов.

Калибровка антенны (таблица поправок)

Назначение: построение таблицы поправок антенны в зависимости от угла энкодера (0°–360°).

Порядок выполнения:

  1. Откройте 🔧 Инструменты → Калибровки → ⚠📡 Калибровка антенны
  2. Задайте шаг угла (обычно 1°–5°)
  3. Нажмите ▶ Старт
  4. Выполните манёвр — судно должно обойти маяк по кругу (или вращайте антенну на месте)
  5. Следите за счётчиком точек и центроидой
  6. После накопления достаточного количества точек нажмите 🔨 Построить
  7. Если покрытие достаточное — нажмите ✓ Применить
  8. Или сохраните таблицу в CSV: 💾 Скачать

Принцип работы:

  • Накапливает точки (heading, измеренный азимут, координаты)
  • Вычисляет центроиду — среднее арифметическое координат маяка
  • Для каждой точки вычисляет истинный пеленг на центроиду
  • Группирует ошибки по секторам энкодера
  • Усредняет ошибки в каждом секторе
  • Применяет таблицу через AntennaCorrector

Требования: Топопривязка (координаты и курс), неподвижный маяк, манёвр с охватом разных углов.

Загрузка калибровочной таблицы

В ⚙ Настройки → Смещения антенны → Калибровка:

  • 📂 Загрузить — загрузить CSV-файл с таблицей
  • 🗑 Сброс — очистить таблицу

Точки интереса (POI)

Назначение: сохранение точек на карте для навигации и документирования.

Типы POI

  • 📍 Загруженные — из CSV-файла (целевые точки для ТНПА)
  • ⭐ Отмеченные — сохранённые оператором в процессе работы

Загрузка POI из CSV

  1. 🔧 Инструменты → POI → 📂 Загрузить из CSV
  2. Выберите файл формата: Название,Широта,Долгота,Глубина
  3. POI отображаются на карте в виде пинов (📍)

Отметка текущего положения маяка

В карточке маяка нажмите 📌. Создаётся POI с координатами маяка и временем отметки.

Экспорт POI

  • 💾 Сохранить в CSV — полный список POI
  • 🗺 KML — POI попадают в KML вместе с треками (загруженные — жёлтый пин, отмеченные — звезда)

Очистка

  • 🗑 Очистить все — удаляет все POI (с подтверждением)
  • POI сохраняются между сессиями в localStorage

Запись и воспроизведение логов

Запись лога

Начинается автоматически при подключении к Zima2. Пишутся все входящие и исходящие сообщения.

Сохранение лога

  • 📋 Лог → 💾 Сохранить — скачать файл лога
  • При отключении от Zima2 предлагается сохранить лог (если более 10 записей)

Загрузка и воспроизведение

  1. 📋 Лог → 📂 Открыть — загрузить файл лога (.log/.txt)
  2. 📋 Лог → ▶ Воспроизвести — запустить воспроизведение
  3. Во время воспроизведения:
    • Работают все функции (треки, маяки, калибровка)
    • Доступно ускорение: − / 1x / + (1x, 2x, 4x, 8x)
    • Прогресс-бар показывает текущее положение
  4. ⏹ Остановить — завершить воспроизведение

Формат логов совместим с AzimuthSuite (C#).

Анализ логов

📋 Лог → 🔍 Анализ

Показывает статистику по загруженному логу:

  • Количество записей
  • Статистика маяков (успешные ответы, таймауты)
  • Данные компаса (минимальный/максимальный heading, обнаружение аномалий)

Кнопка 📋 Копировать — копирует отчёт в буфер обмена.

Экспорт данных

Все форматы доступны через меню 📤 Экспорт.

CSV

Треки маяков и станции в табличном виде (время, координаты, глубина, дистанция, азимут).

NMEA GGA (Маяк)

Эмуляция GPS-приёмника для каждого маяка. Идентификатор маяка — B01…B10 (hex).

NMEA GGA (Антенна)

Трек антенны в формате GGA. Фильтрация дубликатов (< 10 см).

NMEA PSIMSSB (Head-Up)

Относительные координаты маяков (X, Y, Z в метрах) от антенны. Формат, совместимый с HiPAP.

NMEA PSIMSSB UTM

Абсолютные координаты маяков в проекции UTM (Easting, Northing).

KML

Треки маяков и станции для Google Earth/QGIS. Включает POI (если есть).

Отчёт DRMS

Назначение: оценка точности позиционирования маяков.

🔧 Инструменты → 📊 Отчёт DRMS

Рассчитывает для каждого маяка:

  • DRMS (Distance Root Mean Square) — среднеквадратическое отклонение
  • 2DRMS — удвоенное DRMS (≈ 95% доверительный интервал)
  • 3DRMS — утроенное DRMS (≈ 99% доверительный интервал)
  • σX, σY — стандартные отклонения по осям
  • Центроид — среднее арифметическое координат

Формат отчёта:

Маяк #1: DRMS=1.23м, 2DRMS=2.46м, 3DRMS=3.69м, σX=0.87м, σY=0.87м, точек=342

Кнопка 💾 Скачать CSV — сохраняет полную таблицу с координатами центроидов.

Линейка

Инструмент для измерения расстояний на карте.

  1. Нажмите 📏 Линейка
  2. Кликните первую точку на карте
  3. Переместите мышь — отображается резиновая линия с расстоянием
  4. Кликните вторую точку
  5. Для нового измерения кликните снова

При перемещении/зуме карты во время измерения линейка пересчитывается.

Темы оформления

Переключение: кнопка 🎨 или циклически по кругу.

Тема Описание
Indoor Тёмно-синяя, для помещения (по умолчанию)
Light Светлая, для яркого солнца
Dark Contrast Чёрный фон, яркие акценты
Jack Black Чёрный фон, белый текст, серые акценты
Jack White Белый фон, чёрный текст, серые акценты
VAX Зелёный текст на чёрном (стиль терминалов VAX/VT)

Настройки

⚙ Настройки — модальное окно с секциями:

Параметры опроса

  • Маска адресов — какие маяки опрашивать (1–65535)
  • Макс. дальность — ограничение дистанции опроса (100–5000 м)
  • Солёность — для расчёта скорости звука (0–40 PSU)
  • Скорость звука — ручной ввод или авто (по температуре и солёности)

GNSS-компас

  • Режим компаса — авто (HDT предпочтительный), только HDT, только магнитный
  • Скорость порта — 4800–115200 бод

Смещения антенны

  • X, Y — линейное смещение антенны от точки вращения судна (метры)
  • φ антенны — угловое смещение (градусы)
  • Калибровка — загрузка/сброс калибровочной таблицы

Режим антенны

  • Географический — стандартный режим с топопривязкой (координаты и курс антенны)
  • Декартов (неподвижная) — антенна считается в точке (0, 0, 0), координаты маяков в метрах (X → право, Y → вперёд, Z → глубина)

Фильтр маяка (DH)

  • Макс. скорость — порог фильтра (0.5–5 м/с)

Треки маяков

  • Макс. точек — ограничение длины трека (50–10000)
  • Мин. дистанция — прореживание трека (0.1–50 м)

Горячие клавиши и жесты

Мышь

Действие Результат
Колёсико Зум карты
Перетаскивание Панорамирование
Двойной клик по карте Сброс вида на антенну (масштаб 100)
Клик по маяку Слежение за маяком
Клик по карте Отключение слежения

Тач

Действие Результат
Один палец Панорамирование
Два пальца Зум (pinch)
Двойной тап Сброс вида на антенну
Тап по маяку Слежение за маяком

Форматы файлов

Лог обмена (.log)

16:05:59.141: INFO: COM17 (GNSS) >> $GPGGA,050558.85,4637.143860,N,14242.139534,E,0,28,1.2,00021.270,M,00000.000,M,2.0,*78
16:05:59.225: INFO: COM17 (GNSS) >> $GPRMC,050558.85,A,4637.143860,N,14242.139534,E,2.2,65.8,280426,,,D*6C
16:05:59.225: INFO: COM17 (GNSS) >> $GPHDT,66.8,T*0D
16:05:59.435: INFO: COM44 (AZM) >> $PAZM3,1,0,0,38,23.8,0.080975,115.3,113.0,22.8,325.8,11.4,1147.22,4.5,,2.6,-2.9*0E
...

POI (.csv)

Название,Широта,Долгота,Глубина
Точка подхода,55.123456,37.654321,15.5
Объект А,55.345678,37.876543,

Калибровочная таблица (.csv)

# Angle_deg;Error_deg
5.000;1.234567
15.000;2.345678

DRMS отчёт (.csv)

Beacon,Points,DRMS_m,2DRMS_m,3DRMS_m,SigmaX_m,SigmaY_m,CentroidLat,CentroidLon
1,342,1.234,2.468,3.702,0.872,0.873,55.12345678,37.65432190

Устранение неполадок

Не удаётся подключиться к Zima2

  • Убедитесь, что порт не занят другим приложением
  • Проверьте скорость (должна быть 9600 бод)
  • Попробуйте переподключить USB-кабель
  • Обновите страницу

Маяки не отображаются

  • Проверьте маску адресов в настройках
  • Убедитесь, что маяк в зоне видимости (дистанция < макс. дальности)
  • Проверьте, что опрос активен (индикатор мигает)

Нет координат у маяков

  • Выполните топопривязку (вручную или подключите GNSS)
  • Координаты появляются только после успешного прохождения DH-фильтра

Приложение тормозит при воспроизведении лога

  • Уменьшите скорость воспроизведения до 1x
  • Отключите отображение треков (📐 Треки)
  • Закройте неиспользуемые панели

Калибровка не даёт результата

  • Убедитесь, что маяк неподвижен
  • Накопите больше точек с разных курсов
  • Проверьте топопривязку
  • Увеличьте шаг угла при построении таблицы

© 2026 UC&NL