Writing tutorials

The tutorials are written as jupyter notebook in the markdown format. The VASP calculations mocked using mock-vasp which is shipped with this package.

To write a new tutorial, one can first draft it in a jupyter notebook and then convert it to markdown format using the jupytext package:

jupytext my_tutorial.ipynb --to md

This will create a new file my_tutorial.md which can be edited in a text editor.

To include the mocked calculation in the tutorial (to run on machines without access to VASP) set the MOCK_VASP_VASP_CMD to the command to run the VASP executable during the execution of the notebook (e.g. make html for building the documentation).

Timing for the notebook execution

Document	Modified	Method	Run Time (s)	Status
concepts/parsing	2026-04-11 16:16	cache	1.72	✅
concepts/workflows	2026-04-11 16:16	cache	3.9	✅
howto/setup_calculations	2026-04-11 16:16	cache	0.82	✅
howto/work_with_other_codes	2026-04-11 16:16	cache	2.8	❌
tutorials/silicon_band_dos	2026-04-11 16:16	cache	34.81	✅
tutorials/silicon_relax	2026-04-11 16:17	cache	15.89	✅
tutorials/silicon_sp	2026-04-11 16:17	cache	7.96	✅