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.
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.
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.
Brief documentation and a tutorial are available in the wiki.
If you find a bug, please submit it as an Issue.
Please consider contributing your improvements and additions by sending a pull request.
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.
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.
If you have questions about bTools, please contact Tim.