Prerequisites¶
Before you get started with DHIS2 Climate Tools, make sure you have the following installed:
Git – for cloning repositories and managing updates.
Miniconda for managing a reproducible Python environment.
Follow the installation instructions.
Run
conda init --allin your terminal.Restart your terminal for the changes to take effect.
Supported Python versions¶
The DHIS2 Climate Tools supports the following Python versions: Python 3.10, 3.11, 3.12, and 3.13.
Download the DHIS2 Climate Tools toolkit¶
DHIS2 Climate Tools is available as a single GitHub repository, which contains:
A ready-to-use Python environment to get you started working with climate data and DHIS2
A set of How-to Guides and Reference Workflows as interactive Jupyter notebooks for learning and exploration, which are the same notebooks published on the website
To download the latest version of the toolkit to your local machine, clone the repository:
git clone https://github.com/dhis2/climate-toolsThe DHIS2 Climate Tools is updated on a continuous basis to update the notebooks and reference environment.
Setup the environment¶
First, use conda to create and activate the Python environment. For example, to setup an environment using Python 3.13:
conda create -n climate-tools python=3.13
conda activate climate-toolsInstall the dependencies in this order:
conda install -c conda-forge pymeeus jupyterlab ipywidgets jupyterlab_widgets
pip install -r requirements.txtRegister the environment as a Jupyter kernel¶
The Guides and Reference Workflows included with DHIS2 Climate Tools are provided as interactive Jupyter notebooks. To run them using the environment you just installed, register it as a Jupyter kernel:
python -m ipykernel install --user --name climate-toolsVerify that the climate-tools environment shows up in the list of kernels:
jupyter kernelspec listRunning the notebooks¶
You’re now ready to explore the included How-to Guides and Reference Workflows.
For help getting started with Jupyter notebooks, see our Jupyter guide.