🦄Пользовательский Интерфейс

Данная инструкция справедлива для версий LacmusApp 1.x.x. На других версиях пользовательский интерфейс может отличаться.

Приложение Lacmus включает в себя следующие окна:

• Главное окно.

• Помощник распознавания.

• Наройки.

• Параметры сохранения.

• Окно просмотра геопозиции.

• Отправка сообщения об ошибке.

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

• Фурнал событий (лог).

Главное окно

Главное окно

Главное окно программы состоит из стедующих элементов:

1. Главное меню программы
2. Панель быстрых команд
3. Элемент просмотра фотографии
4. Список фотографий
5. Строка состояния

Главное меню

Главное меню содержит меречень всех функций программы

Главное меню имеет следующую структуру

• Файл

  • Открыть - открывает диалоговое окно для выбора попки с фотографиями.

  • Импортировать из XML - открывает диалоговое окно для просмотра ранее обработанных в Lacmus фотографий. Как через приложение, так и через FTP интерфейс.

  • Сохранить - сохраняет результаты распознования в выбранную папку.

  • Сохранить как... - открывает окно с выбором параметров сохранения. Например можно сохранить фотографии с нарисованными рамками объектов, отфильтровать фотографии.

  • Помощник - открывает окно помощника по распознованию фото.
  • Настройки - открывает окно настроек.
  • Показать лог - открыть лог программы.
  • Выход - выход из программы.

• Изображение

  • Обработать все - запускает процесс поиска объектов.

  • Увеличеть - увеличивает изображение в просмотерщике изображений.

  • Уменьшить - уменьшает изображение в просмотерщике изображений.

  • Сбросить - сбрасывает масштаб изображения и распологает его по центру в просмотерщике изображений.

  • Следующее - открывает следующее изображение в просмотерщике.

  • Предыдущее - открывает предыдущее изображение в просмотерщике.

  • Показать\Скрыть рамку - показывает или скрывает рамку с объектом на озображении.

  • Показать геопозицию - открывает окно просмотра геопозиции.
  • Добавить\Удалить из избранных - добавляет или удаляет фото из избранных.

  • Сообщить об ощибке - сообщить об ошибке распознования и отправить данные об ошибке на сервер.

• Помощь

  • Открыть руководство пользователя - открывает документацию в обраузере.

  • О программе - открывает окно сведений о программе.

  • Проверить обновления - выполнить проверку обновлений.

Панель быстрых команд

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

• Открыть... - открывает диалоговое окно для выбора попки с фотографиями.

• Обработать все - запускает процесс поиска объектов.

• Сохранить - сохраняет результаты распознования в выбранную папку.

• Сбросить - сбрасывает масштаб изображения и распологает его по центру в просмотерщике изображений.

• Помощник - открывает окно помощника по распознованию фото.

• Рамка - показывает или скрывает рамку с объектом на озображении.

Просмоторщик фотографий

Просмоторщик фотографий позволяет просмотреть выбранную фотографию из списка фотографий, изменять ее масштаб и просматривать отдельные области фотографии.

Элементы управления:

• Правая кномка мыши - перемещает фотографию по просмотрщику.

• Колесико мыши - изменяет масштаб.

• Левая кнопка мыши - открывает контекстное меню.

Контекстное меню

• Показать геопозицию - открывает окно просмотра геопозиции.
• Добавить\Удалить из избранных - добавляет или удаляет фото из избранных.

Контекстное меню

Список фотографий

Список фотографий позволяет итерироваться между фотографиями, отслеживать статусы фотографий и сортировать фотографии.

Сптсок фотографий

Список фотографий состоит из стедующих элементов:

1. Фильтор - позволяет фильтровать фотографии по следубщим категориям:

   1. Все фото - отобразить все фото (без фильтра).

   2. Фото с объектами - отобразить только фото с объектами.

   3. Избранные фото - отобразить только избранные фото.

2. Индекаторы фотографий - индекаторы, показывающие атрибуты фотографий:

   1. 🎯 - показывает есть ли объект на изображении.
   2. ❤️ - показывает добавлено ли изображение в избраное.
   3. 🔍 - показывает было ли просмотрено изображение.
3. Миниатюра изображения - позволяет легко просматривать фотографию.

4. Имя файла - показывает цифры из имени файла. Например файл с названием gosha20777.png будет отображаться как 20777. Полное имя файла можно вуидеть, если навести курсор мыши на изображение:
5. Переключатель страниц - если в списке большое колличество изображений, то изображения сортируются по страницам подобно страницам в поискавеке (Яндекс, google). Таким образом приложение потребляет меньше ресурсов.

Строка состояния

Строка состояния отражает текущее состояние программы

Строка состояния может отражать такие статусы

• Reedy - статус означает что программа готова к работе.

• Working - статус означает что программа находится в процессе обработки задачи (например анализ или загрузка изображений).

• Error - статус означает что какая-либо операция завершилась с ошибкой (например при попытке загрузки озображения возникла ошибка и т. д.).

Строка состояния имеет следующую структуру

Статус | дополнительная информация

Статус	Цвет	Дополнительная информация
Ready	Синий	Пусто Путь до выбранного изображения
Working	Ораньжевый	Имя выполняемой операции Процент выполнения операции
Error	Красный	Сообщение об ошибке

Помощник распознования

Помощник распознования - вспомогательное окно, дублирующее основной функциоал прграммы и позволяющее упростить процесс запуска распознавания изображений.

Приветсвенное сообщение

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

Приветствие

• Далее - перейти к шагу 1.

Шаг 1: Выбор папки с фотографиями

На этом шаге пьзовлю предлагается выбрать папку с фотографиями, это можно сделать нажав кнопку выбать фото или введя путь до папки в соответствующее поле.

Шаг 1

• Далее - перейти к шагу 2.

• Назад - вернуться к предыдущему шагу.

Шаг 2: Выбор папки для сохранения

На этом шаге пьзовлю предлагается выбрать папку для сохранения результатов.

Шаг 2

• Далее - перейти к шагу 3.

• Назад - вернуться к предыдущему шагу.

Шаг 3: Запуск распознования.

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

Шаг 3

• Обработать все - запустить распознавание.

• Назад - вернуться к предыдущему шагу.

Процесс распознования

В этом окне отображается процесс распознованя изображений. Пользователь может отменить процесс, нажав на кнопку стоп.

• Повторить - вернуться к шагу 1.

• Закрыть - выйти из помощника.

Настройки

Настройки позволяют выполнить конфигурацию программы - настроить тему офформления, язык приложения, загрузить и установить ML модель.

• Для сохранения настроек нажмите кнопку Применить.

• Для возврата исходных настроек нажмите кнопку Отмена.

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

Общие настройки

Общие настройки

• Язык - позволяет сменить язык программы. На выбор доступно два языка:

  • Русский

  • Английский

• Тема - позволяет сменить тему офформления между темной или светлой.

• Цвет рамки - позволяет выбрать цвет рамки, которой обводится объект. на выбор датупны такие цвета:

  • Красный

  • Зеленый

  • Синий

  • Берюзовый

  • Желтый

  • Пурпурный

ML Модель

ML модель

В данном окне выводится информация о выбранной модели:

• ML модель:

  • Имя - название модели.

  • Версия - версия модели.

  • Тип выполнения - устройство на котором производятся вычисления (CPU, GPU, TPU и т.д.).

  • Автор - автор модели.

  • Компания - организация, поставляющая модель.

  • Оисание - краткое описание модели.

  • Url - ссылка на исходный код модели.

  • Тег - уникальный тег модели.

  • Поддерживаемые ОС - список поддерживаемых операционных систем.

• Пороговое значение (чувствительность) - величина в % характеризующая степень срабатывания модели. Чем меньше эта величина, тем больше объектов будет находить нейронная сеть (в том числе и ложных).

• Например если на изображении находится человек и артефакт (например бочка или мусор) то ML модель отметит человека с уверенностью в 40% а артефакт с увереностью в 20%. Если при этом пороговое значение стоит на отметке в 30% то артефакт будет проигнорирован. Если пороговое значение установить в 15% то будут отмечены оба объекта.

• От локации к локации эти показатели могут меняться. Таким образом у пользователя есть возможность провезди донастройку модели в случае большого колличества ложных сработываней. Или наоборот, если алгоритм ничего не нашел, имеет смысл понизить пороговое значение.

• Значение в 15% яаляется оптимальным.

• Репозиторий - ссылка на репозиторий откуда будут скачиваться модели. api.lacmus.ml - официальный репозиторий lacmus foundation. Но команда lacmus не запрещает настраивать и разворачивать собственные репозитории.

• Обновить - обновить информацию о модели

Установленные модели

В данном окне отображается спимок моделие установленных в систему.

Установленные модели

Каджый элемент содержит краткую итформацию о модели, ее типе, авторе, версии и т.д.

• Удалить - удалить соответствующую модель.

• Активировать - выбрать соответсвующую модель для распознования.

• Импортировать - установить модель из файла (опция может быть полезна в условиях отсутсвия Интернета).

• Обновить - обновить список моделей.

Доступные модели

В данном окне отображается спимок моделей доступных для загрузки из репозитория.

Доступные модели

• Установить - установить соответствующую модель в систему.

• Обновить - обновить список моделей.

Параметры сохранения

Здесь пользователь может выбрать дополнительные опции сохранения результатов.

Параметры сохранения

• Тип сохраняемых фотографий - тип фотографий, которые нужно сохранить:

  • Все фото.

  • Фото с объектами.

  • Избранные фото.

• Сохранить исходные фотографии - копировать исходные фото в папку сохранения.

• Сохранить XML аннотации - в папке сохранения добавятся XML файлы.

• Сохранить фото с нарисованными обьектами - в папке сохранения добавятся фото с нарисованными рамками объектов.

• Сохранить вырезанные объекты - в папке сохранения сохранятся вырезанные объекты.

• Открыть... - выбрать папку для сохранения.

• Сохранить - сохранить фотографии.

Окно просмотра геопозиции

В этом окне пользователь может просмотреть геопозицию центра фотографии, а также получить информацию о метаданных изображения.

Геопозиция

• QR код - ссылка на геопозицию (Open Street Maps)

• Широта - широта в WGS84.

• Долгота - долгота в WGS84.

• Высота - высота над уровнем моря.

• Открыть с помошью:

  • Яндекс - открыть точку в Яндекс.Картах.

  • Google Maps - открыть точку в Google maps.

  • Open Street Maps - открыть в OSM.

• Методанные - таблица с методанными изображения.

Отправка сообщения об ошибке

Тут пользователь может отправить сообщение об ошибке распознавания.

• Эти данные будут отправлены к нам на сервер, а затем промодерированы нами.

• Это позволяет улучшить качество распознования ML моделей.

• Также это позволяет пополнять наш публичный набор данных.

Сообщить об ошибке

Пользователю предлагается выбрать тип ошибки

• Человек был пропущен на фото алгоритмом

• Алгоритм отметил неверный объект

Информация о программе

Здесь можно просмотреть информацию о программе, ее версию, получить сведенья о лицензии.

О программе

• Лицензия - просмотреть информацию о лицензии.
• GitHub - открыть github страницу проекта.
• Веб сайт - открыть сайт проекта.

Журнал событей (Лог)

• В лог попадают все события которые происходят в программе. Лог позволяет разработчикам легко отследить причину неисправности, а пользователи могут добыть оттуда полезную информацию.

• Лог также сохраняется в файл.

Лог приложения