/btools

Automatic insect tracking and behavior detection.

Primary LanguageJavaGNU Affero General Public License v3.0AGPL-3.0

Overview

bTools is a set of programs for identifying and tracking insects in images or videos with the help of a tiny matrix barcode, called bCode. It also contains detectors for behaviors such as movement and, for honey bees, flight activity, the mouth-to-mouth exchange of liquid (trophallaxis), and worker egg-laying.

Getting started

If you just want to use our software, please download our most recent release and then follow the instructions in the wiki.

If you want to experiment with the code, please choose a branch and download or clone the repository. Next, import the scr folder in your favorite IDE, add the JAR packages in the lib folder to the Java classpath, and you are ready to go.

Tools

BCodeMaker.jar - draws 2048 unique, printable bCodes.
BCodeDetector.jar - detects bCodes in digital images.
Converter.jar - converts raw bCode detection results to a more useful format.
Indexer.jar - indexes raw bCode detection results.
TrophallaxisDetector.jar - detects liquid food exchange among honey bees.
MovementDetector.jar - detects movement.
FlightActivityDetector.jar - detects hive exits and returns.
EggLayingDetector.jar - detects worker egg-laying.

Documentation

Brief documentation and a tutorial are available in the wiki.

Bug reports

If you find a bug, please submit it as an Issue.

Contributing

Please consider contributing your improvements and additions by sending a pull request.

Versions

bTools uses Semantic Versioning. The development branch is the latest version of bTools, while the master branch contains the latest stable release. For information about each release, please check out the Changelog.

License

This software is distributed under the GNU Affero General Public License v3 license and uses third party software that is distributed under its own terms.

Contact

If you have questions about bTools, please contact Tim.