Installation

Currently we recommend using the provided conda environment file to install gridwxcomp and its dependencies in a virtual environment. Download the environment.yml file and then install and activate it. If you don’t have conda get it here. To install dependencies in a virtual environment run

$ conda env create -f environment.yml

To activate the environment before using gridwxcomp run

$ conda activate gridwxcomp

After installing all the dependencies using conda, install gridwxcomp using pip,

$ pip install gridwxcomp

Due to dependency conflicts you may have issues directly installing with pip before activating the conda environment. This is because the package includes several modules that are not pure Python such as GDAL and pyproj which seem to be better handled by conda.

Alternatively, or if there are installation issues, you can manually install. First activate the gridwxcomp conda environment (above). Next, clone or download the package from GitHub or PyPI and then install locally with pip in “editable” mode. For example with cloning,

$ git clone https://github.com/WSWUP/gridwxcomp.git
$ cd gridwxcomp

If you are experiencing errors on installing the gridwxcomp conda environment above with dependencies. For example, if the Shapely package is not installing from the enironment.yml file, remove it or modify it from the “setup.py” file in the install requirements section before you install gridwxcomp from source with:

$ pip install -e .

More help with installation issues related to dependency conflicts can be found in the gridwxcomp issues on GitHub, be sure to check the closed issues as well.