This repository contains work on a book in progress (nearly complete) to illustrate Riemann solutions and approximate Riemann solvers in Jupyter notebooks.

Contributors: @ketch, @rjleveque, and @maojrs.

The notebooks are saved in Github with the output stripped out. You can view the html rendered notebooks with output intact on this webpage. These are static views (no execution or interactive widgets), but some notebooks include animations that will play. These may not be up to date with the versions in this repository during the development phase of this project.

To install the dependencies for the book, see https://github.com/clawpack/riemann_book/wiki/Installation. Then clone this repository to get all the notebooks. A table of contents and suggested order for reading the notebooks is given in Index.ipynb.

Rather than installing all the dependencies, if you have Docker installed you can use the Dockerfile in this repository. See Docker.md for instructions.

[Add instructions for Dockerhub]

Rather than installing software, you can execute the notebooks on the cloud using the Microsoft Azure Notebooks cloud service: Create a free account and then clone the riemann_book library. These may not be up to date with the versions in this repository during the development phase of this project.

This is still under development using the latest version of binder. You can try it out for these notebooks at this link: https://beta.mybinder.org/v2/gh/clawpack/riemann_book/master

This should start up a notebook server on a Jupyterhub that lets you execute all the notebooks with no installation required.