Installation#

The package can be installed directly from git.smhi.se. Start by

git clone https://git.smhi.se/ai-for-obs/dawsonia.git
Do you plan to contribute back your changes?

Create a virtual environment, activate it and change directory to repository that we just cloned now.

python3.11 -m venv venv
source venv/bin/activate
cd dawsonia
python -m pip install invoke nox pip-tools
py -m venv venv
venv\Scripts\activate
cd dawsonia
python -m pip install invoke nox pip-tools

Note

Install Miniforge as instructed here conda-forge/miniforge

Important

The package has been tested in Linux machines with Python 3.11 but other OS and newer Python versions can also work. For non-Linux machines, Conda / Mamba is preferred.

To install the package, follow the most suitable approach based on the hardware your machine has.

python -m pip install -r requirements/main.txt -e '.[cpu,pypi]'
python -m pip install -r requirements/main.txt -e '.[server,pypi]'
python -m pip install -r requirements/main.txt -e '.[rocm,pypi]'
python -m pip install -r requirements/main.txt -e '.[cuda,pypi]'
# Either without pinned dependencies
mamba env create -f requirements/environment.yaml
# or with pinned dependencies
mamba env create -f requirements/environment_full.yaml
# followed by:
mamba activate dawsonia
python -m pip install -e '.[conda]'

Warning

Intended to be used by developers only! To get exact versions invoke dev.install

Proceed to Getting started ⏩