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 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.
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
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
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