About this software — Clawpack 5.14.x documentation

Clawpack stands for “Conservation Laws Package” and was initially developed for linear and nonlinear hyperbolic systems of conservation laws, with a focus on implementing high-resolution Godunov type methods using limiters in a general framework applicable to many applications. These finite volume methods require a “Riemann solver” to resolve the jump discontinuity at the interface between two grid cells into waves propagating into the neighboring cells. The formulation used in Clawpack allows easy extension to the solution of hyperbolic problems that are not in conservation form.
See Wave-propagation algorithms for a brief description of the finite volume methods used in Clawpack and Riemann solvers for a description of the subroutine(s) needed to specify the hyperbolic equation being solved.
Adaptive mesh refinement is included, see AMRClaw Description and Detailed Contents, and routines specialized to depth-averaged geophysical flows can be found in GeoClaw Description and Contents.
The PyClaw software provides a more pythonic interface and parallelism that scales to tens of thousands of cores.
New users may wish to read Which Clawpack solver should I use? before starting.
The “wave propagation” algorithms implemented in Clawpack are discribed in detail in the book Finite Volume Methods for Hyperbolic Problems [LeVeque-FVMHP]. Virtually all of the figures in this book were generated using Clawpack (version 4.3). See Examples from the book FVMHP for a list of available examples with pointers to the codes and resulting plots.
See the Bibliography for some pointers to papers describing Clawpack and the algorithms used in more detail.
Clawpack is distributed under the terms of the Berkeley Software Distribution (BSD) license.
See License for details.
Many people have contributed to the development of Clawpack since its inception in 1994.
Major algorithmic and software design contributions have been made by the following individuals:
Randall J. LeVeque, University of Washington, @rjleveque.
Marsha Berger, Courant Institute, NYU, @mjberger.
Jan Olav Langseth, Norwegian Defence Research Establishment.
David George, USGS Cascades Volcano Observatory, @dlgeorge.
David Ketcheson, KAUST @ketch.
Kyle Mandli, UT-Austin, @mandli.
Other major contributors include:
Aron Ahmadia, @ahmadia.
Amal Alghamdi, @amal-ghamdi.
Ian Bolliger, @bolliger32.
Donna Calhoun, @donnaboise.
Ondřej Čertík, @certik.
Brisa Davis, @BrisaDavis.
Grady Lemoine, @gradylemoine.
Matteo Parsani, @mparsani.
Xinsheng Qin @xinshengqin.
Avi Schwarzschild @aks2203.
Andy Terrel, @aterrel.
Chris Vogl, @cjvogl.
Numerous students and other users have also contributed towards this software, by finding bugs, suggesting improvements, and exploring its use on new applications. Thank you!
If you use Clawpack in publications, please cite the software itself as well, with a citation similar to the following:
Please fill in the version number that you used, and its year, with the appropriate DOI from Zenodo, if available. See Releases of Clawpack and release notes.
It is best to refer to the particular release used to obtain your results, As a general DOI, if you need to refer to multiple past releases, or to cite Clawpack more generally, you can also use the DOI 10.17605/osf.io/kmw6h, which links to a page with tar files for all recent releases.
Also please cite the recent article:
Please also cite at least one of the following regarding the algorithms used in Clawpack (click the links for bibtex citations):
Classic algorithms in 1d and 2d: [LeVeque97], [LeVeque-FVMHP]
3d classic algorithms: [LangsethLeVeque00]
AMR: [BergerLeVeque98]
f-wave algorithms: [BaleLevMitRoss02]