===============================================================================
PARTICLECLAW
===============================================================================
A numerical scheme for scalar conservation and balance laws
    u_t+(f(u))_x = g(x,u)
in one space dimension.
It is a characteristic particle method that is exactly conservative, total
variation diminishing, entropy decreasing, and has no numerical dissipation
away from shocks.

Version 1.0
Copyright (c) 2008 Benjamin Seibold and Yossi Farjoun
http://math.mit.edu/~seibold/research/particleclaw
http://arxiv.org/abs/0809.0726

===============================================================================
Files
===============================================================================
particleclaw.m              The computational code
pclaw_ex_quartic.m          Example flow under a quartic flux function
pclaw_ex_burgers.m          Example Burgers' equation
pclaw_ex_bucklev.m          Example Buckley-Leverett equation
pclaw_ex_obstacle.m         Example flow over obstactle
pclaw_ex_obstacle_disode.m  Example flow over obstactle with special treatment
pclaw_load.m                Load a stored computational data file
pclaw_animate.m             Load and animating a sequence of data files
README.txt                  This file.

===============================================================================
Operation
===============================================================================
All program files are m-files for Matlab.
The individual example files "pclaw_ex_*" define the problem and its
parameters. Running the example file calls the computational code
"particleclaw" with the specific parameters. The program particleclaw cannot
be called without parameters.

To run computation: pclaw_ex_*
To animate results: pclaw_animate

To change the problem or its parameters: Modify an existing example file.
In the example file, also specify whether the computational results shall
be plotted and/or saved in files.

===============================================================================
Copyright (c) 2008 Benjamin Seibold and Yossi Farjoun

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction for non-commercial purposes, including
without limitation the rights to use, copy, modify, merge, publish, and/or
distribute copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software, and credit has to be
given to the authors in publications that are in any form based on this
Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
===============================================================================