4. Installation#
4.1. Python version support#
NetSSE requires a Python version of 3.12 (or any later version) to be installed in the environment. It is also required to have the pip package manager installed.
If you do not have Python installed, you can download it from the Python website.
4.2. Option 1: Installing NetSSE with pip (recommended)#
To use NetSSE, install it in a virtual environment using pip:
(.venv) $ python3 -m pip install netsse
This command will install the latest stable version of NetSSE from the Python Package Index (PyPI). It will also install or update the Python packages that NetSSE is dependent on, when needed.
4.3. Option 2: Cloning the GitLab repository#
This option allows you to install NetSSE directly from the GitLab repository, therefore you can access the latest development version, possibly including unreleased features or bug fixes. There is however no guarantee of stability.
To clone the NetSSE repository from GitLab, use the following command:
$ git clone https://gitlab.gbar.dtu.dk/regmo/NetSSE.git
Once cloned, navigate into the cloned directory:
$ cd netsse
Then, install the package using pip for instance:
(.venv) $ python3 -m pip install .
4.4. Option 3: Downloading NetSSE from DTU Data#
The institutional data repository at the Technical University of Denmark provides access to the NetSSE package. You can download the source code of the latest release published on DTU Data. Please note however that there might be a delay between a new release on GitLab and the corresponding upload to DTU Data.
After extracting the files from the ZIP file, you can install NetSSE in your Python environment by navigating to the extracted folder and running for instance:
(.venv) $ python3 -m pip install .
4.5. Dependencies#
NetSSE depends on a number of other open-source Python packages, of which all of the necessary are automatically installed when using the pip install manager. The required package versions are as follows:
numpy>=2.0.0
scipy>=1.14.0
matplotlib>=3.8.4
geopy>=2.4.1
cartopy>=0.24.1
cdsapi>=0.7.5
4.6. User registration#
To help us improve and better understand our user community, we kindly ask all users to register to use NetSSE. Registration is free. If you have not already registered, please do so here:
If you have already registered, thank you! You do not need to register again and can continue using NetSSE as usual. Kindly ignore any registration prompts you may encounter.