Installation

You can install Campo on Windows, macOS or Linux. Supported Python versions are 3.6 up to 3.9.

Installing Python

We suggest to install Miniconda, a Python package and environment management system. An alternative distribution is Anaconda provided by Continuum Analytics. The user guide and short reference on the conda pacakge manager can be found here.

Installing Campo using Conda

We provide an environment file that you can use to install Campo. Download the file or copy the following content to a file named campo.yaml:

name: campo
channels:
  - conda-forge
dependencies:
  - python=3.8
  - numpy
  - lue
  - pcraster
  - matplotlib
  - xarray
  - pandas
  - gdal
  - networkx
  - spyder
  - qgis
  - pip
  - pip:
    - https://campo.computationalgeography.org/download/campo-0.0.28-py3-none-any.whl

then install it with

conda env create -f campo.yaml

After a successful installation you can activate your campo environment with

conda activate campo

You can test your installation by printing the Campo version number

python -c "import campo; print(campo.__version__)"

Upgrading Campo using pip

Most likely it is sufficient to upgrade the Campo module instead of recreating the conda environment. Within your campo environment you can upgrade Campo to a newer version using pip:

pip install https://campo.computationalgeography.org/download/campo-0.0.28-py3-none-any.whl