Installation tutorial

OPERADAR — Installation Guide

OPERADAR requires Python 3.12 and must be installed in an isolated virtual environment.
This guide provides copy-paste safe, step-by-step instructions

Prerequisites

• Python 3.12 (verify with python3 --version)
• venv (included with Python)
• Git
• For HPC at Météo France (belenos), add in the .gitconfig file :

[http]
        sslVerify = false

---

0. For belenos only

   module load python/3.12.12

1. Create a directory for virtual environments (safe to re-run):

   mkdir -p $HOME/virtual_envs
   cd $HOME/virtual_envs

2. Create the virtual environment:

   python3 -m venv operadar_env

3. Activate the environment:

   source operadar_env/bin/activate

4. Verify the activation (it should point to .../operadar_env/bin/python):

   which python

5. Upgrade packaging tools:

   pip install -U pip setuptools wheel build

6. Clone the repository:

   cd $HOME
   git clone https://github.com/UMR-CNRM/operadar.git
   cd operadar

7. Install OPERADAR in editable mode (changes to source code are immediately active):

   pip install --prefer-binary -e .

8. Verify the installation:

   python -c "import operadar; print('OPERADAR imported successfully')"

9. Deactivate when finished (optional):

   deactivate

Quick Verification

To verify your installation in a new terminal later:

1. Activate your environment (choose the one you used):

   source $HOME/virtual_envs/operadar_env/bin/activate

2. Test the import:

   python -c "import operadar; print(operadar.__file__)"

---

Notes

• Editable install (-e .): This installs OPERADAR in development mode, so changes to the source code take effect immediately without needing to reinstall.

Running OPERADAR

See the Execution Guide for detailed usage instructions.