This repository contains a very simple video annotator for animal behavior.
This software was built using python 3.4, but it has been tested in many other python distros so you should interpret this as 3.4+ (up to 3.11). You can get this software from the terminal using.
git clone https://github.com/matiasandina/annotate_behavior_video.git
To install dependencies.
pip3 install -r requirements.txt
You are advised to do this in a virtual environment. For example:
git clone https://github.com/matiasandina/annotate_behavior_video.git
cd annotate_behavior_video
python3 -m venv .annotator
source .annotator/bin/activate
# some modules need numpy for install and you won't have it on a virtual environment
pip3 install numpy==1.22.0
pip3 install -r requirements.txt
In windows, activating venv works like:
python3 -m venv .annotator
.annotator\Scripts\activate
pip3 install -r requirements.txt
If you prefer conda, you can set up your virtual environment using it.
conda create --name .annotator python
conda activate .annotator
pip3 install -r requirements.txt
The main function is annotator.py, which uses 2 windows. The main window will contain most buttons used to control the video. The second window provides visual feedback for annotation.
From this window you control the reproduction, type annotation (aka, type of behavior) and saving of data.
From this window you can annotate the video and have a live ethogram representation of the annotations.
Here's an example showing minimal functions of the main app.
By using a config.yaml, you can label different behaviors. For example, here's the file as apears in the repo
behaviors:
- not-specific
- sleep
- micro-arousal
- quiet-awake
- moving-awake
- eating-awake
Which will be read into the annotator and produce:
Hot keys have been added with the following bindings.
self.key_options = ["a","s", "d", "f", "g", "h", "j", "k", "l"]
These will match the order of the behaviors on your config. Thus, following the example, "sleep" will be labeled when pressing "s".
Some updates will happen soon, this list contains the next things to be updated in order.
1. Allow for user to populate behavior categories at will on start-up.
1. Add function
on_key_press (allow hotkeys for scoring).1. Add ask before quit.
- Add colors/style to matplotlib.
- Make GUI look pretty
This repository contains some functions used to capture an LED blink on video. Future versions may or may not contain this functionality and documentation will not be developed for these.
This is a preliminary release. Please file issues to make this software work better.