Installation¶
Installing only the FORTRAN program¶
If you are only interested in the FORTRAN source files for the weather generator, checkout the gwgen_f90 repository.
It is implemented as a submodule in this repository in the src directory
Installing the full GWGEN¶
If you not only want the source code, but also the parameterization or the experiment organization features of the model, you need the full python package which includes the FORTRAN source files.
The code is hosted open-source on Github and can be downloaded via
git clone https://github.com/ARVE-Research/gwgen.git
or as a zipped archive directly from Github.
Installing the requirements¶
You need a FORTRAN 95 compiler (see Installing only the FORTRAN program). Furthermore, you need python and the following python packages:
- model-organization: For the command line utility and the experiments organization
- matplotlib, seaborn and psyplot: For the visualization
- xarray, statsmodels, numpy and scipy: For the calculations
- dask (only necessary for the
cross correlation
parameterization task) - cartopy: For the Kolmogorov-Smirnoff
(
ks
) evaluation task.
The recommended way to install these requirements is using conda. We provide two methodologies here
1. Installing into an existing conda distribution¶
If you already have conda installed, we recommend you just use
this conda environment file
and create a
new virtual environment via
conda env create -f gwgen_environment.yml
source activate gwgen
2. Installation including conda¶
With every new gwgen
release, we also provide executables to install
conda and gwgen on our releases page. This is probably the easiest way to
install it.
After selecting the right file for your operating system (MacOS or Linux), you can simply install it via
bash <downloaded-file.sh>
and follow the instructions.
Installing GWGEN¶
After having successfully installed python, just install the gwgen package via
python setup.py install
You can test whether it was successfully installed by typing:
gwgen -h
Note
If you download the repository from Github via git clone
, you have to
initialize the src
submodule via:
git submodule update --init gwgen/src