DeepLabCut Legacy (≤ 2.2.0.2)¶

Warning!

The documentation below is for DeepLabCut version 2.2.0.2. Please see here for newer versions.

DeepLabCut is a toolbox for markerless pose estimation of animals performing various tasks.

DeepLabCut is available as a module on Apocrita.

Usage¶

DeepLabCut only works on GPU nodes

DeepLabCut only works on the GPU nodes. Attempting to run DeepLabCut on any other node type will result in a Python error. Before using DeepLabCut, researchers need to request access to the GPU nodes, or have access to the DERI/Andrena GPU nodes.

To run the default version of DeepLabCut, simply load the deeplabcut module:

module load deeplabcut/2.2.0.2

Loading the module will automatically activate an Anaconda environment, containing DeepLabCut and its dependencies.

Example job¶

GPU job¶

DeepLabCut only uses one GPU

DeepLabCut only uses one GPU, so job scripts should only request one GPU. The following job script will use a script from the DeepLabCut examples directory to create a project and run some tasks.

#!/bin/bash
#$ -cwd
#$ -j y
#$ -pe smp 12
#$ -l h_vmem=7.5G
#$ -l h_rt=240:0:0
#$ -l gpu=1
#$ -l gpu_type="volta|ampere"
# Approved DERI users can include the following line
#$ -l cluster=andrena

module load deeplabcut/2.2.0.2

cd ~/DeepLabCut/examples
python testscript.py