How to install

PCR-GLOBWB is developed in Python and uses various supporting packages (e.g. pcraster, numpy and netcdf4). Therefore, beside the PCR-GLOBWB model code, you will need a working Python package environment to install the PCR-GLOBWB model. Here we provide a short guide to installing PCR-GLOBWB. Note that in this installation guide we assume you work on a Linux operating system.

Python package environment

Please follow the following steps to setup a PCR-GLOBWB environment:

  1. To create a Python package environment, we recommend to install Miniconda. Follow the Miniconda install instructions given here. A user guide and short reference on the conda package manager can be found here.

  2. Now that Miniconda is installed, you can use it to make a package environment. To install the correct packages and their versions, we have created an environment file on our GitHub repository (see also the example below). Use the environment file to install all required packages to a conda environment:

    conda env create --name pcrglobwb_python3 --file pcrglobwb_py3.yml

    This will create a environment named pcrglobwb_python3.

pcrglobwb_py3.yml 

name: pcrglobwb_python3
channels:
  - conda-forge
dependencies:
  - python>=3.6
  - numpy
  - pip
  - python-dateutil
  - six  
  - zlib
  - pcraster
  - pip:
    - netcdf4>=1.5.3
    - cdsapi
  - cdo
  - nco
  - ncview

PCR-GLOBWB model code

Please follow the following steps to get the PCR-GLOBWB model code:

  1. To save the model code, we recommend to install Git. Follow the Git install instructions here. A user guide and short reference on the git version control system can be found here.

  2. Now that Git is installed, you can use it to clone and track the PCR-GLOBWB model code from the the main branch of our GitHub repository:

    git clone https://github.com/UU-Hydro/PCR-GLOBWB_model.git

    This will clone PCR-GLOBWB, as well as the models version history, into the current working directory.