README

README

Using BioTracker

See the wiki.

Running BioTracker from prebuild binaries:

The releases github page provides stable version. Most recent binaries can be grabbed from the pipeline.

• BioTracker core application
• Some trackers. For example the Background subtraction tracker

Building trackers against prebuild BioTracker

This will enable you to only build your own plugin without having to care about the robotracker toolchaining/dependencies/etc..

• Download Interfaces project and add it to your toolchain (e.g. cmake prefix path)
• Optional: Do the same for the utility project, if you need it
• Download and install the BioTracker core application
• It might be helpful to use some basic tracker as a template: https://github.com/BioroboticsLab/biotracker_sampletracker
• Make sure to implement the IBehavior interface
• Build
• Put your artifact in the Plugins section
• Run and Enjoy

Build dependencies

Building the BioTracker needs:

• opencv (> 3.0)
• QT (>= 5.4)
• Boost
• CMake (>= 3.13)
• Buildtools (Tested: MSVC buildtools or g++)
• recommendet: ninja

Building BioTracker (Windows x64)

The dockerfile documents the dependency installation: (includes dependencies for all projects, e.g. BioTracker, interfaces, ...)

Install and configure those dependencies. A shorthand to the dockerfile is using vcpkg Get the boost and opencv packages:
vcpkg install boost-property-tree:x64-windows-14.16 boost-bimap:x64-windows-14.16 boost-assign:x64-windows-14.16 boost-system:x64-windows-14.16 boost-filesystem:x64-windows-14.16 boost-chrono:x64-windows-14.16 boost-timer:x64-windows-14.16 boost-program-options:x64-windows-14.16
vcpkg install openblas:x64-windows-14.16 opencv[opengl,ffmpeg,ximea,cuda]:x64-windows-14.16
... and Qt systemwide using Qt5_dir
Now call cmake with some switches to include vcpkg: -DCMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-14.16
... and build. Proceed withe the build steps as in the linux section.

Building BioTracker (Linux)

The dockerfile documents the dependency installation: (includes dependencies for all projects, e.g. BioTracker, interfaces, ...)
Having set all the library paths you can build it just like any cmake project. It's split into a few repositories for modularization. Clone, build and install them in order: Interfaces, Utility, Behavior loader, the BioTracker itself and any tracking plugin of your liking, eg. the Background subtraction tracker.

Building BioTracker (OSX)

Technically the BioTracker should build using the CMake toolchain and run on OSX. This is not officially supported, though.