Инструкция по эксплуатации программного обеспечения «DroneFlight Viewer»

Версия: 1.0.0

Термины и определения

ПК - персональный компьютер;

ОС - операционная система;

ПО - программное обеспечение;

БпЛА - беспилотный летательный аппарат;

GNSS (ГНСС) - глобальная навигационная спутниковая система.

1. Общие сведения

Программное обеспечение «DroneFlight Viewer» предназначено для просмотра данных, полученных при проведении поисково-спасательных операций людей в природной среде с применением аэрофотосъёмки.

2. Функциональные характеристики

ПО «DroneFlight Viewer» обладает следующим функционалом:

• на данный момент приложение разработано и адаптировано для операционных систем: Linux, Windows и Android;

• открытие (анализ) результатов ПО «DroneFlight» и ПО «DroneFlight Detector», содержащих параметры полёта, набор снимков и GNSS-координаты найденных объектов поиска;

• просмотр двух типов изображений: «Объекты поиска» (найденные объекты поиска, упорядоченные по убыванию уверенности) и «Все снимки» (исходные снимки, упорядоченные по дате съёмки);

• копирование в буфер обмена GNSS-координат объектов поиска в списке «Объекты поиска»;

• копирование в буфер обмена GNSS-координат оригинальных снимков в списке «Все снимки» (GNSS-координат БпЛА в момент фотографирования);

• копирование в буфер обмена пути на файловой системе к изображениям объектов поиска в списке «Объекты поиска»;

• копирование в буфер обмена пути на файловой системе к оригинальным снимкам в списке «Все снимки»;

• поддержка четырёх типов карт: Google - Гибрид (Hybrid), Google - Спутник (Satellite), Google - Рельеф (Terrain) и OpenStreetMap (OSM);

• управление картой (перемещение, изменение масштаба);

• отображение/скрытие на карте трека полёта;

• отображение/скрытие на карте маркеров (точек фотографирования);

• просмотр оригинального снимка с ограничивающими рамками объектов поиска (при их наличии);

• управление просмотром оригинального снимка (перемещение, изменение масштаба);

• переход в режим просмотра оригинальных снимков либо из списка «Объекты поиска», либо из списка «Все снимки», либо по нажатию на маркерах на карте;

• отображение/скрытие всех ограничивающих рамок объектов поиска;

• динамическое скрытие ограничивающих рамок объектов поиска в зависимости от уровня уверенности;

• просмотр метаданных оригинальных снимков;

• отображение на оригинальных снимках магнитного азимута.

3. Требования к программно-аппаратному обеспечению

3.1. Требования к программному обеспечению «DroneFlight Viewer»

ПО «DroneFlight Viewer» является кроссплатформенным приложением и на данный момент ПО «DroneFlight Viewer» реализовано и тестировалось на трёх операционных системах:

• Linux (Ubuntu 22);

• Windows (11);

• Android (4.1 [API level 16] - 16 [API level 36]).

ПО «DroneFlight Viewer» для ОС Android на данный момент адаптировано под экраны планшетов. Адаптация приложения под смартфоны запланирована.

3.2. Требования к аппаратному обеспечению «DroneFlight Viewer»

Требуемое оборудование:

• ПК / ноутбук (на ОС Linux или Windows) или планшет (на ОС Android).

Программное обеспечение «DroneFlight Viewer» имеет минимальные требования к аппаратным возможностям оборудования. При этом требования по минимальным размерам дисков (USB/SSD/HDD) зависят от величины полученного в результате полёта набора данных (в первую очередь количества и размера снимков).

4. Установка ПО «DroneFlight Viewer»

ПО «DroneFlight Viewer» разрабатывалось и тестировалось на данный момент для операционных систем Linux (Ubuntu 22), Windows (11) и Android (планшеты).

4.1. Установка «DroneFlight Viewer» для ОС Linux

Для установки ПО «DroneFlight Viewer» для ОС Linux достаточно распаковать архив droneflightviewer_linux_1.0.0.7z (с указанием пароля) в директорию на файловой системе.

Пароль к архиву droneflightviewer_linux_1.0.0.7z доступен в файле CREDENTIALS.txt.

Установка пакета p7zip-full для работы с 7z -архивами:

Распаковка архива в текущую выбранную директорию на файловой системе:

, где droneflightviewer - исполняемый файл.

Установка ПО «DroneFlight Viewer» для ОС Linux завершена.

4.2. Установка «DroneFlight Viewer» для ОС Windows

Для установки ПО «DroneFlight Viewer» для ОС Windows достаточно распаковать архив droneflightviewer_windows_1.0.0.7z (с указанием пароля) в директорию на файловой системе.

Пароль к архиву droneflightviewer_windows_1.0.0.7z доступен в файле CREDENTIALS.txt.

Для работы с 7z-архивами требуется установить приложение 7-Zip.

Правой кнопкой мыши на файле droneflightviewer_windows_1.0.0.7z в контекстном меню требуется выбрать Показать дополнительные параметры:

В появившемся контекстном меню выбрать раздел: 7-Zip / Распаковать здесь:

Далее требуется ввести пароль и нажать кнопку OK:

Структура файлов приложения в папке droneflightviewer_windows_1.0.0:

, где droneflightviewer.exe - исполняемый файл.

Установка ПО «DroneFlight Viewer» для ОС Windows завершена.

4.3. Установка «DroneFlight Viewer» для ОС Android

Для установки ПО «DroneFlight Viewer» для ОС Android из apk-файла предварительно потребуется извлечь содержимое архива droneflightviewer_android_1.0.0.7z (с указанием пароля) в директорию на файловой системе ОС Linux или Windows.

Пароль к архиву droneflightviewer_android_1.0.0.7z доступен в файле CREDENTIALS.txt.

Структура файлов:

Дальнейшая установка ПО «DroneFlight Viewer» будет выполняться из файла app-release.apk на устройстве Android:

При запуске файла app-release.apk в появившемся диалоговом окне требуется нажать кнопку Установить:

В появившемся диалоговом окне необходимо выполнить проверку приложения, нажав на кнопку Проверить:

В результате проверки убедиться, что приложение является безопасным, и нажать на кнопку Установить:

После успешной установки приложения требуется нажать на кнопку Готово:

Установленное приложение «DroneFlight Viewer» станет доступно в списке приложений:

Установка ПО «DroneFlight Viewer» для ОС Android завершена.

5. Эксплуатация ПО «DroneFlight Viewer»

Поведение ПО «DroneFlight Viewer» для разных платформ практически идентичное. Платформенные различия в инструкции будут отражены.

5.1. Запуск ПО «DroneFlight Viewer»

Для запуска ПО «DroneFlight Viewer» требуется предварительная установка.

5.1.1. Запуск ПО «DroneFlight Viewer» для ОС Linux

Для запуска ПО «DroneFlight Viewer» требуется перейти в ранее распакованную директорию droneflightviewer_linux_1.0.0 и запустить исполняемый файл droneflightviewer либо из графического интерфейса операционной системы:

, либо из консоли:

В результате будет запущено приложение:

5.1.2. Запуск ПО «DroneFlight Viewer» для ОС Windows

Для запуска ПО «DroneFlight Viewer» требуется перейти в ранее распакованную директорию droneflightviewer_windows_1.0.0 и запустить исполняемый файл droneflightviewer.exe либо из графического интерфейса операционной системы:

, либо из консоли:

В результате будет запущено приложение:

5.1.3. Запуск ПО «DroneFlight Viewer» для ОС Android

Для запуска ПО «DroneFlight Viewer» требуется перейти в список приложений и запустить «DroneFlight Viewer»:

В результате будет запущено приложение:

5.2. Открытие набора данных

Результатом работы ПО «DroneFlight» или ПО «DroneFlight Detector» является zip-архив (без пароля). Перед началом использования ПО «DroneFlight Viewer» zip-архив с данными должен быть предварительно распакован.

Для работы ПО «DroneFlight Viewer» используются следующие обязательные данные:

, где

• detections - набор изображений распознанных объектов;

• photos - набор оригинальных снимков;

• previews - набор превью оригинальных снимков;

• results.fb - файл с метаданными в формате FlatBuffers.

Бинарный файл results.fb содержит всю необходимую информацию о треке полёта, обо всех изображениях и ограничивающих рамках с уровнями уверенности.

5.2.1. Открытие набора данных для ОС Linux

В левой части приложения нажмите на кнопку Открыть. В открывшемся диалоговом окне выберите директорию с результатами поиска, например, droneflight_ilxlr1_1761940093193 на USB-носителе:

После загрузки данных отобразятся список со снимками и трек полёта с маркерами. Карта позиционируется относительно точки старта.

Текущая директория с данными отображается в левой части экрана, например, /media/user/D42A-C723/droneflight_ilxlr1_1761940093193.

5.2.2. Открытие набора данных для ОС Windows

В левой части приложения нажмите на кнопку Открыть. В открывшемся диалоговом окне выберите директорию с результатами поиска, например, droneflight_ilxlr1_1761940093193 на USB-носителе:

После загрузки данных отобразятся список со снимками и трек полёта с маркерами. Карта позиционируется относительно точки старта.

Текущая директория с данными отображается в левой части экрана, например, E:\droneflight_ilxlr1_1761940093193.

5.2.3. Открытие набора данных для ОС Android

В ОС Android существует ряд ограничений на чтение данных. Требуется предварительно распаковать данные ПО «DroneFlight» или ПО «DroneFlight Detector» в директорию Download на ОС Android.

В левой части приложения нажмите на кнопку Открыть. В открывшемся диалоговом окне выберите директорию с результатами поиска, например, droneflight_ilxlr1_1761940093193 в директории Download:

и нажмите на кнопку ИСПОЛЬЗОВАТЬ ЭТУ ПАПКУ.

В появившемся диалоговом окне разрешите доступ к указанной директории, нажав на кнопку РАЗРЕШИТЬ:

В появившемся окне в поле Предоставление разрешения требуется выдать разрешение:

и нажать стрелку Назад.

После загрузки данных отобразятся список со снимками и трек полёта с маркерами. Карта позиционируется относительно точки старта.

Текущая директория с данными отображается в левой части экрана, например, /storage/emulated/0/Download/droneflight_ilxlr1_1761940093193.

5.3. Списки изображений

5.3.1. Типы списков изображений

В приложении доступны 2 типа списков изображений:

• «Объекты поиска» - найденные объекты поиска, упорядоченные по убыванию уверенности;

• «Все снимки» - исходные снимки, упорядоченные по дате съёмки.

При выборе «Все снимки» отобразится список с исходными снимками:

5.3.2. Копирование координат

Под каждым изображением отображаются координаты. В случае со списком «Объекты поиска» отображаются координаты объекта, в случае со списком «Все снимки» - координаты БпЛА в момент фотографирования.

У каждого изображения из списка в правой верхней части расположена кнопка, нажимая на которую выпадает меню со следующим набором действий:

Копирование координат в буфер обмена выполняется нажатием на элемент меню Скопировать координаты.

В нижней части приложения отобразится сообщение об успешном копировании координат в буфер обмена:

5.3.4. Копирование пути к изображению

Копирование пути к файлу изображения выполняется аналогично копированию координат. Для списка «Объекты поиска» копируется путь к файлу изображения с найденным объектом, а в случае со списком «Все снимки» - путь к снимку.

Аналогично в нижней части приложения отобразится сообщение об успешном копировании пути к файлу изображения в буфер обмена:

5.4. Карта

5.4.1. Типы карт

Для переключения между типами карт используется кнопка Тип карты в правом верхнем углу приложения:

В настоящий момент поддерживаются 4 типа карт.

Google - Гибрид (Hybrid)

Google - Спутник (Satellite)

Google - Рельеф (Terrain)

OpenStreetMap (OSM)

5.4.2. Управление картой

Для ОС Linux и Windows карту можно перемещать мышью, уменьшать/увеличивать колесом мыши, увеличивать двойным кликом мыши на требуемом участке карты. Уменьшается/увеличивается часть карты под курсором мыши.

Для ОС Android управление картой выполняется touch-действиями на экране.

5.4.3. Управление треком полёта

Отображение трека полёта управляется нажатием на кнопку Маршруты в правом верхнем углу приложения:

В момент нажатия на кнопку Маршруты трек полёта скрывается:

5.4.4. Управление маркерами

Отображение маркеров управляется нажатием на кнопку Маркеры в правом верхнем углу приложения:

В момент нажатия на кнопку маркеры скрываются:

5.5. Просмотр оригинальных снимков

Просмотр снимков с объектами поиска инициируется нажатием на изображения в списке в левой части приложения, либо на маркеры с иконкой фотокамеры на карте.

Для ОС Linux и Windows снимок можно перемещать мышью, уменьшать/увеличивать колесом мыши для требуемой части снимка, уменьшать/увеличивать двойным кликом мыши на требуемой части снимка. Уменьшается/увеличивается часть снимка под курсором мыши.

Для ОС Android манипуляции с изображением выполняются touch-действиями на экране.

5.5.1. Управление рамками

Вокруг объектов поиска отображаются рамки. При минимальном масштабе рядом с каждой рамкой отображается только уверенность. При увеличении снимка рядом с рамкой отображаются в т.ч. координаты объекта поиска:

Управление рамками выполняется нажатием на кнопку Рамки в правой верхней части приложения:

При нажатии на кнопку рамки вокруг объектов скрываются:

Управление динамическим отображением рамок с разными уровнями уверенности выполняется слайдером в правой верхней части приложения:

При перемещении слайдера рамки с меньшей уверенностью динамически скрываются:

5.5.2. Метаданные снимка

Для просмотра метаданных снимка требуется нажать на кнопку Метаданные снимка:

В результате откроется диалоговое окно со списком метаданных снимка:

Нажатие на отдельной строке копирует в буфер обмена выбранное значение метаданных. Нажатие на кнопке Скопировать и закрыть копирует в буфер обмена весь набор метаданных.

5.5.3. Магнитный азимут

В верхней части карты отображается магнитный азимут снимка камеры с борта БпЛА. Значение азимута от 0 до 360 градусов.

5.5.4. Закрытие просмотра оригинальных снимков

Закрытие режима просмотра оригинальных снимков выполняется либо нажатием клавиши Esc, либо нажатием на кнопку Закрыть в правой верхней части приложения:

6. О программе

Для получения информации о программе в верхнем правом углу требуется нажать кнопку О программе:

В результате откроется диалоговое окно с информацией о программе:

Представлена следующая информация:

• краткое описание о программе;

• версия ПО;

• информация о текущем используемом устройстве;

• ссылка на документацию о программе;

• информация об авторе.

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