TerraWing - БПЛА в АПК

TerraWing - сервис для распознавания препятствий на пути движения БПЛА и их классификации. Наше решение предназначено для использования в агропромышленном комплексе.

Уникальность

Быстродействие работы системы
Проект доведен до стадии MVP
Использование

Перспективы развития

Специализированный датасет
Плагины ИИ встраиваемые на сервере для возможности работы с разными задачами
Автоматическое составление карты рабочей местности для дрона
Совместная работа нескольких БПЛА
Интеграция с погодными сервисами.

Начало работы

Установим pyenv для удобного управления версиями python

Windows Chocolatey: choco install pyenv-win
Linux/macOS: curl https://pyenv.run | bash

Просмотр доступных версий python в pyenv: pyenv install --list Устанавливаем python не ниже версии 3.11: pyenv install 3.11.8

Устанавливаем пакетный менеджер poetry

Windows Powershell: (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
Linux/macOS: curl -sSL https://install.python-poetry.org | python3 -

Виртуальное окружение

Если Вы используете pyenv выполните следующие команды:

poetry config virtualenvs.prefer-active-python true
pyenv local <номер версии python, в нашем случае 3.11.8>

Подготовка виртуального окружения для poetry: poetry use env <номер версии python, в нашем случае 3.11.8>
Входим в виртуальное окружение poetry shell
Установка зависимостей: poetry install

Копируем шаблон файла настроек:

Windows: copy .env.dist .env
Linux/macOS: cp .env.dist .env

Редактируем в .env наши настройки...

Запуск сервера

Выполняем команду python app.py

Dev

Помощь в разработке

Линтер ruff
Для запуска использовать следующую команду poetry run ruff check src
Форматирование кода black
Для запуска используем следующую команду: poetry run black src

Тесты сервера

В папке tests вы можете найти файл test_video_stream.py Этот файл дает нам возможность эмитировать дрон, посылая в качестве видеопотока на сервер либо любой файл с видео, либо транслировать свою веб-камеру.

Для запуска клиента с трансляцией заранее заготовленного видео используйте эту команду: python test_video_stream.py <drone_id> <drone_secret> --video_source <путь>

Note

Если вы хотите транслировать веб-камеру, то просто удалите аргумент video_source

Обучение модели

Ссылка на датасет: https://www.kaggle.com/datasets/dimflix/obstacles-in-flight-for-drones
По пути src/neural_network вы можете найти файл TrainNeuralNetwork.ipynb. Как-раз таки он служит для обучения нейронки.

Note

Датасет должен находиться в папке src/data/DATASET

Warning

Если вы используете Pycharm и индексацию файлов, советуем вам добавить папку с датасетом в исключение (excluded). Это можно сделать нажатием правой кнопки мыши по папке, после чего выбрав пункт Mark Directory as. Там вам нужно выбрать excluded.

Лицензия

Полный текст лицензии доступен здесь: Юридический кодекс CC BY-NC 4.0.

Вы можете свободно использовать:

Делиться — копировать и распространять материал на любом носителе или в любом формате
Адаптировать — переделывать, преобразовывать и дополнять материал Лицензиар не может лишить вас этих прав, пока вы соблюдаете условия лицензии.

На следующих условиях:

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

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

DIMFLIX-OFFICIAL/TerraWing