Installation

Pre-requisites

Anaconda python: Install the anaconda python distribution (or miniconda). If conda is already installed on your system, make sure you have conda v4.8.4+. If not, update from an older version with conda update conda.

CUDA libraries for using the GPU: While DAS works well for annotating song using CPUs, GPUs will greatly improve annotation speed and are highly recommended for training. DAS uses Tensorflow as a deep-learning backend. To ensure that Tensorflow can utilize the GPU, the required CUDA libraries need to be installed. See the tensorflow docs for details.

Libsoundfile (linux only): If you are on linux and want to load audio from a wide range of audio formats (other than wav), then you need to install libsndfile. The GUI uses the soundfile python package, which relies on libsndfile. libsndfile will be automatically installed on Windows and macOS. On Linux, the library needs to be installed manually with: sudo apt-get install libsndfile1. Again, this is only required if you need to load data from more exotic audio files.

Visual C++ runtime (windows only): This is typically installed so only required if DAS fails to load the native tensorflow runtime. Download the latest version here.

Install DAS

Create an anaconda environment called das that contains all the required packages, including the GUI:

conda env create ncb/das-env -n das

If you do not need the graphical user interface (for instance, when training DAS on a server), install the non-GUI version:

conda env create ncb/das-nogui-env -n das

Update

Don’t. It only causes problems in our experience. We recommend installing new versions of DAS into a fresh environment. The brave can update using pip:

conda activate das
pip install das --update  # DAS itself
pip install xarray_behave --update  # the GUI

Test the installation (Optional)

To quickly test the installation, run these commands in the terminal:

conda activate das  # activate the conda environment
das train --help  # test das training
das gui  # start the GUI

The second command will display the command line arguments for das train. The last command, das gui, will start the graphical user interface - this step will not work with the non-GUI install.

Make a desktop icon (Optional)

To start the DAS GUI without having to use a terminal, create a clickable startup script on the desktop.

On macOS or linux, place a text file called das.sh (linux) or das.command (macOS) with the following content on the desktop:

# /bin/bash
source $CONDA_PREFIX/etc/profile.d/conda.sh
conda activate das
das gui

Make the files executable with chmod +x FILENAME, where FILENAME is das.sh (linux) or das.command (macOS).

For windows, place a text file called das.bat with the following content on the desktop:

TITLE DAS
CALL conda.bat activate das
das gui

Next steps

If all is working, you can now use DAS to annotate song. To get started, you will first need to train a network on your own data. For that you need annotated audio - either create new annotations using the GUI or convert existing annotations using python scripts.