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:
- BeesBook Concept (Wario et al. 2015)
- Generating training data to detect honeybee markers (Sixt et al. 2017)
- Detecting and decoding honeybee markers (Wild et al. 2018)
- Lifetime Tracking (Boenisch et al. 2018)
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
The following software is required for long-term recording of HD videos.
The board layout and arduino code to run the flash boards and camera triggers can be found here: https://github.com/BioroboticsLab/bb_irflash
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
Code to send the generated video files to an arbitrary mount can be found here: https://github.com/BioroboticsLab/bb_imgstorage_nfs
The following tools are required to process the video files and extract individual bee detections and tracks.
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
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
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
The waggle dance software needs at least 60FPS cameras (low resolution is fine). It can be found here: https://github.com/nebw/wdd2/