LaGuer / riemann_book

An interactive book about the Riemann problem for hyperbolic PDEs, using Jupyter notebooks. Work in progress.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status codecov Coverage Status Travis Build status Binder Colab

Riemann Problems and Jupyter Solutions

by David I. Ketcheson, Randall J. LeVeque, and Mauricio del Razo Sarmina

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.

View static webpages

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.

Installation

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.

Docker

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]

Execute in the cloud

Windows Azure

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.

Binder

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.

About

An interactive book about the Riemann problem for hyperbolic PDEs, using Jupyter notebooks. Work in progress.

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Jupyter Notebook 66.2%Language:HTML 27.5%Language:Python 4.3%Language:TeX 1.9%Language:Fortran 0.1%Language:Smarty 0.0%Language:CSS 0.0%Language:Dockerfile 0.0%Language:Shell 0.0%