dlbd is a python package built on the mouffet framework (https://github.com/vin985/mouffet) used to provide, train and evaluate bird detectors.
Git is a version control manager. It allows you to save your code and keep a history of all changes made to the code. A popular interface using git is the Github website on which this code is stored. To install easily our packages we will need to install git first. You can find it there:
If you do not already have one, first install a python version on your computer. A python 3 version is required. We recommend downloading the latest miniconda version that can be found here: https://docs.conda.io/en/latest/miniconda.html
The site provides information on how to install it on all platforms. Note that you will be required to use a terminal for program to work. On windows, miniconda installs a terminal directly. You can find it in the application start menu.
Once miniconda is install, open a terminal. To make sure the installation has worked correctly, you can try to enter the following command in the terminal:
python
This should launch a python terminal. To exit the python terminal, type:
exit()
The following steps are optional but are good practice in Python. If you do no want to proceed, go directly to the next section
To isolate our work, we will create a python environment. Python environments allow to create an isolated place where we can avoid package conflicts. To do so, type the following commands:
cd path/where_I_want_my_environment # Moves into the working directory
python -m venv mouffet_env
This should create the environment in the subfolder mouffet_env. Now that it is created, we need to activate it to let python know where to install our packages
mouffet_env/Scripts/activate # This should be the path on Windows
source mouffet_env/bin/activate # This should work on Linux and Mac
Now we need to install the dependencies. To do so we will install them using the pip package manager that comes with python. If this is the first time you use python, you will probably need to update pip. For that, type in you terminal:
pip install pip --upgrade
Once this is done, you can install the mouffet package using this command:
pip install -U git+https://github.com/vin985/dlbd.git