📈 Подсчёт пчёл на входе и выходе - на edge

🎯 Назначение

Система мониторинга трафика пчёл в реальном времени, которая считает отдельных пчёл, входящих и выходящих из улья, с помощью компьютерного зрения на edge-устройствах.

🎭 Пользовательская история

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

🚀 Ключевые преимущества

• Автоматический мониторинг: без ручного подсчёта, круглосуточное отслеживание
• Раннее выявление проблем: необычные паттерны трафика могут указывать на роение, грабёж или болезни
• Инсайты на основе данных: отслеживание потерь, эффективности вылета и сезонных паттернов
• Обработка на edge: анализ в реальном времени без зависимости от интернета

🔧 Технический обзор

Модель YOLO v8 (weights/best.pt) на edge-устройствах детектирует и трекает отдельных пчёл, пересекающих настраиваемую границу входа. DeepSORT с анализом траекторий различает входящее и исходящее движение относительно линии детекции на настраиваемой высоте (по умолчанию 50% кадра).

📋 Критерии приёмки

• Устройство детектирует и трекает отдельных пчёл с моделью YOLO v8
• Корректно классифицирует направление (вход/выход) по пересечению траектории линии детекции
• Обрабатывает видео в реальном времени с настраиваемым FPS
• Отправляет телеметрию каждые 30 секунд (настраиваемый VIDEO_CHUNK_LENGTH_SEC)
• Рассчитывает производные метрики: средняя скорость, 95-й перцентиль скорости, число неподвижных пчёл
• Поддерживает дневной и ночной режим (DAY_START_HOUR/DAY_END_HOUR)
• Стабильно работает с USB-камерами (V4L2 на Linux, AVFoundation на macOS)

🚫 Вне области

• Обнаружение грабёжа (отдельная функция)
• Классификация видов (ос, шершней - отдельно)
• Детекция пыльцы на отдельных пчёлах
• Идентификация матки по видео летка

🏗️ Подход к реализации

• AI-модель: YOLO v8 (Ultralytics) с кастомными весами детекции пчёл
• Трекинг: DeepSORT с историей траекторий (хранение defaultdict)
• Линия детекции: настраиваемая горизонтальная линия в процентах от высоты кадра
• Оборудование: USB-камеры через OpenCV (CAP_V4L2/CAP_AVFOUNDATION)
• Обработка: пакетная обработка кадров с потоками для асинхронной телеметрии
• Выход: кодирование видео AVC1/MP4V с оверлеями визуализации

📊 Метрики успеха

• Обработка в реальном времени с настраиваемым FPS
• Классификация направления по траектории с детекцией пересечения
• Передача телеметрии каждые 30 секунд на настроенный endpoint
• Локальное сохранение в ежедневно ротируемых JSONL-файлах
• Автоопределение камеры на Linux и macOS

🔗 Связанные функции

• 📊 Отчётность метрик движения пчёл
• 🛣️ Генерация тепловых карт летка
• 📈 Telemetry API

📚 Ресурсы и ссылки

• Репозиторий Entrance Observer
• Реализация YOLO v8 Ultralytics
• Бэкенды камеры OpenCV

💬 Заметки

Ключевая функция на базе YOLO v8 с DeepSORT-трекингом. Настраиваемая линия детекции, дневной/ночной режимы и расчёт метрик, включая анализ скорости и обнаружение неподвижных пчёл.