This repository contains documentation that is common across the many simulation and modelling repositories owned by the Met Office.

A quick and clean way to get the package dependencies is via uv package manager.

Ps: Optional system dependencies for PDF generation may require LaTeX distributions and other third-party libraries.

git clone https://github.com/MetOffice/simulation-systems
cd simulation-systems

# Install dependencies (see pyproject.toml) in project .venv
uv sync
uv run make clean html

# Verify documentation
firefox build/html/index.html

Alternatively, if your have Python-3.11 or higher installed (sphinx==8.2.3 requirement), you can install the dependencies in a virtual environment via pip, and build the documentation like:

cd simulation-systems

</path/to/python3.11+> -m venv .venv
source .venv/bin/activate
pip install .
make clean html

conda env create -f env.yml
conda activate sphinx_doc_env
make clean html
firefox build/html/index.html

The documentation is written in sphinx markup. To develop changes to this documentation first create an issue detailing the changes that are required. Then create a branch in a clone of this repository, linking it to your issue and regularly building your changes as described above.

Once happy with your development create a pull request and request a review from MetOffice/ssdteam.