Multiple Target Tracking -- Course work at Linköping University
Code repository for Python implementations of some multiple target tracking algorithms, specifically developed for the course Target Tracking at Linköping University, see Target Tracking. See Getting started for information on how to run the code and generate result plots.
Run Notebooks on Binder
The notebooks are hosted on Binder and can immediately be run. However, Binder is quite slow and the algorithms will not run even somewhat quick there. It is advised to follow Getting started locally instead.
Getting started locally
Make sure to have Docker installed on your computer, see Installing Docker. Then follow the steps below.
Alternative 1: Building the Docker image locally
Step 1
Clone the repository
git clone https://gitlab.liu.se/phd-courses/multiple-target-tracking.git
cd multiple-target-trackingStep 2
Build the Docker image
docker build -t targettracking -f Dockerfile .Step 3
Run the Docker image
docker run --rm -it -p 8888:8888 targettrackingThis opens up a Jupyter lab instance on port 8888 which you can open in any browser.
Alternative 2: Pull Docker image from Container Registry
Run the Docker image (with notebooks) by running
docker run --rm -it -p 8888:8888 gitlab.liu.se:5000/phd-courses/multiple-target-trackingDocumentation
The documentation is hosted on Gitlab pages but is also buildable locally in the provided Docker image. The documentation can be found here.
Building the documentation locally
To build the documentation the following procedure is suggested. It is assumed that the Docker image has been built already. Otherwise, substitute targettracking with gitlab.liu.se:5000/phd-courses/multiple-target-tracking below.
docker run --rm -it -v "$(pwd)":/home/jovyan/work targettracking pdoc --html --output-dir work/html/ src/This will map your current folder into the jovyan/work folder in the container. Then, it builds the documentation to that directory and removes the container. The documentation is available in your current directory.