To get a local copy up and running follow these simple steps.
This algorithm is intended for processing videos recorded during experiments with head-restrained rodents, focused on their whiskers.
Using it on videos where the head of the rodent is moving freely will not provide accurate results and may even cause the program to crash. In addition, the background of the video should be stable for the whole duration of whisker-tracking, meaning that only whiskers should ideally be moving, while no lighting conditions are altered or external objects are moving.
Install: CUDA - OpenCV with CUDA support - OpenBLAS (or LAPACK) - Qt5
The project has only been tested on Ubuntu, CUDA-capable, systems thus far. This means that, in order to run WhiskEras 2.0 you will need a linux system and a CUDA-capable GPU, if you are going to use a GPU at all.
Install CUDA. WhiskEras 2.0 has been tested to work with CUDA 11.2. CUDA 10.2 was tested to work too, but then the CUB library will have to be downloaded and linked manually where appropriate.
Install OpenCV with CUDA support. An example guide can be found here. WhiskEras 2.0 has been tested to work with OpenCV 4.2.2 and 4.5.2.
Install OpenBLAS (or LAPACK). From an Ubuntu terminal
The rest of the packages have been provided in libs directory.
There are two ways to run WhiskEras 2.0
Either you can directly run the pre-built binary executable, or build it yourself. You can try to directly run the executable, but if some required package is missing from your system, it will probably not run. In that case, it is better to try and build it, see the errors and address them correspondingly.
Run the binary only:
Download just the file WhiskEras_GUI in the bin directory of the repository.
Go to the directory of the file and open a terminal in that directory (right-click on the directory, Open From Terminal).
Change permissions of the binary to make it executable