Using the Project’s environment

Module to support the courses “Visualizacion de la Información” from Universidad del Desarrollo and “Ciencia de Datos Geográficos” from Universidad de Chile.

Author: Eduardo Graells-Garrido (eduardo.graells@bsc.es)

Installing Environment & Dependencies

To use the scripts in this repository, you must have Anaconda installed on the systems that will be running the scripts. This will simplify the processes of installing all the dependencies.

For reference, see: Manage Anaconda Environments

The package counts with a Makefile with useful commands and functions. You must use this Makefile to ensure that you have all of the necessary dependencies, as well the correct conda environment.

Show all available functions in the Makefile

You can use the Makefile for running common tasks like updating environments, cleaning extra files, and more.

To show all available functions in the Makefile, run:

make show-help

Available rules:

clean               Deletes all build, test, coverage, and Python artifacts
clean-build         Remove build artifacts
clean-pyc           Removes Python file artifacts
clean-test          Remove test and coverage artifacts
environment         Set up python interpreter environment - Using environment.yml
lint                Lint using flake8
remove_environment  Delete python interpreter environment
test_environment    Test python environment is setup correctly
update_environment  Update python interpreter environment

Create environment

In order to properly run the commands of this project, you should install the necessary packages before. For this, you will to have installed Anaconda, because otherwise you will not be able to use this command.

The name of the environment and its dependencies are explicitely shown in the environment.yml file. In order to create the environment, you must run:

make environment

The main file that lists all of the dependencies for the project can be found as environment.yml.

Activating the environment

Once the environment has been installed, you can now activate the environment by typing

source activate aves

Nota

Depending on your installation of Anaconda, you might have to use the command:

conda activate aves

instead.

Updating environment

You can always update the project’s environment. The package dependencies are handled by the environment.yml file, and sometimes these packages need to updaetd.

You can updated the project’s environments by running:

make update_environment

This will update the versions of each of the necessary packages.

Deactivating environment

Once you are done running the scripts of this project, you should deactivate the environment. To do so, run:

source deactivate

Nota

Depending on your installation of Anaconda, you might have to use the command:

conda deactivate

instead.

Auto-activate environment

To make it easier to activate the necessary environment, one can use the conda-auto-env package, which activates the necessary environment automatically.

See the link above for more information!

Project based on the cookiecutter data science project template