gaspype/examples
Nicolas Kruse 0578b552be Example-readme updated 2025-06-06 10:48:30 +02:00
..
README.md Example-readme updated 2025-06-06 10:48:30 +02:00
soec_methane.md files rearranged 2025-06-06 09:02:52 +02:00

README.md

Example scripts

Examples can be looked-up in the documentation rendered with results.

The gaspype examples from this directory are available in the documentation as downloadable Jupyter Notebooks or plain python scripts with comments.

The conversion is done like the following automated by the docs/source/render_examples.py script:

# Converting markdown with code sections to Jupyter Notebook and run it:
notedown examples/soec_methane.md --to notebook --output docs/source/_autogenerated/soec_methane.ipynb --run

# Converting the Jupyter Notebook to Markdown and a folder with image
# files placed in docs/source/_autogenerated/:
jupyter nbconvert --to markdown docs/source/_autogenerated/soec_methane.ipynb --output soec_methane.md

A new example Markdown file can be created from a Jupyter Notebook running the following command:

jupyter nbconvert --to new_example.ipynb --NbConvertApp.use_output_suffix=False --ClearOutputPreprocessor.enabled=True --output-dir examples/ --output new_example.md