Tutorials¶

Interactive Jupyter notebook tutorials that walk you through Hera's core workflows step by step with real code and output.

These notebooks complement the User Guide — they show the same concepts in a hands-on, executable format.

Beginner Tutorials¶

Start here if you're new to Hera. These notebooks cover the fundamentals in order:

Notebook	What you'll learn	Related docs	Download
Project	Creating projects (CLI + Python), caseConfiguration.json, loading documents manually	Projects	:material-download: .ipynb
Toolkit and DataSource	What toolkits are, available toolkit names, initializing toolkits, data source JSON structure	Key Concepts, Working with Data	:material-download: .ipynb
DataSource	Adding data sources, versioning, listing, querying, getting data, deleting	Working with Data > Data Sources	:material-download: .ipynb
Repository	Repository management (add, list, remove, show), JSON structure, DataSource vs Measurements items	Key Concepts > Repositories, CLI Reference	:material-download: .ipynb

Notebook	What you'll learn	Related docs	Download
Tile Toolkit	Map images from tile servers, WGS84 and ITM coordinates, custom tile servers	Measurements > Tiles	:material-download: .ipynb

Activate the Hera environment:
```
source activate_hera.sh
```
Make sure MongoDB is running:
```
make mongo-up
```
Start Jupyter:
```
jupyter lab docs/tutorials/
```
Run the notebooks in order: Project → Toolkit and DataSource → DataSource → Repository.

The full collection of Jupyter notebooks (including advanced topics) is in the repository under hera/doc/jupyter/:

Directory	Content
`hera/doc/jupyter/User/datalayer/`	Data layer deep dives: low-level access, caching, version management
`hera/doc/jupyter/User/toolkits/measurments/GIS/`	GIS toolkits: topography, buildings, demography, land cover, tiles
`hera/doc/jupyter/User/toolkits/measurments/experiment/`	Experiment creation and usage
`hera/doc/jupyter/User/toolkits/measurments/low_frequency/`	Meteorology low-frequency data
`hera/doc/jupyter/User/toolkits/simulations/`	OpenFOAM, Gaussian dispersion, wind profile, Hermes workflows
`hera/doc/jupyter/User/toolkits/risskassessment/`	Risk assessment
`hera/doc/jupyter/User/utils/`	Utilities: JSON, units (Unum), queries, DataFrames, contours, Slurm
`hera/doc/jupyter/Developer/`	Developer-focused notebooks with additional low-level details