Skip to content
timlandgraf edited this page Nov 5, 2019 · 16 revisions

BeesBook: Tracking All Honeybees in the Observation Hive Over Their Lifetimes

This page gives an overview about the required hard- and software to setup a BeesBook System.

Want to know what the BeesBook system is? Read these papers:

Want to set up a BeesBook system and want to know what to buy? Check out our shopping list on Google Docs: https://docs.google.com/spreadsheets/d/1z-Vb9nyhvx-7WNBayCk0QtEguCbCXwpLEP0vvgKUmIA/edit?usp=sharing

HD Recording

The following software is required for long-term recording of HD videos.

Lighting

The board layout and arduino code to run the flash boards and camera triggers can be found here: https://github.com/BioroboticsLab/bb_irflash

Recording

The code to record video data from XIMEA or FLEA3 cams can be found here: https://github.com/BioroboticsLab/bb_imgacquisition

Software to generate image statistics during the recording can be found here: https://github.com/BioroboticsLab/bb_statistics

Software for a live display of images, decodings, population, and more can be found here: https://github.com/BioroboticsLab/bb_live

Video Archival Storage

Code to send the generated video files to an arbitrary mount can be found here: https://github.com/BioroboticsLab/bb_imgstorage_nfs

Processing HD images

The following tools are required to process the video files and extract individual bee detections and tracks.

Localizing and Detection Pipeline

The toolchain to localize bees and decode tags in images and videos can be found here: https://github.com/BioroboticsLab/bb_pipeline

The resulting data will be stored in the bb_binary format

Bee Tracking

The software to apply camera homographies, link detections (marked and unmarked) over time, assign unique track identifiers, and correct tag decoding errors can be found here: https://github.com/BioroboticsLab/bb_tracking

Productivity

Helper tools to interact with a database based on the tracking results can be found here: https://github.com/BioroboticsLab/bb_behavior

Helper tools to convert and draw BeesBook tags, detect fiducial markers, and more can be found here: https://github.com/BioroboticsLab/bb_utils

Software for a server that can be used in an API to retrieve image data from frame IDs can be found here: https://github.com/BioroboticsLab/beesbook_backend

Android-App to decode markers with your phone: https://github.com/BioroboticsLab/beetag_app

High-Speed Waggle Dance Recognition

The waggle dance software needs at least 60FPS cameras (low resolution is fine). It can be found here: https://github.com/nebw/wdd2/