###########################################################################

    A D G F E M  -- Adaptive Discontinuous Galerkin Finite Element Method

##########################################################################

Charles University Prague, Faculty of Mathematics and Physics

Authors: Vit Dolejsi, Filip Roskovec, Jiri Hozman, Ivana Sebestova, Ondrej Bartos,
Jaroslav Hajek, Martin Holik

SUMMARY:
Adgfem is the in-house code developed in Charles University Prague
for the numerical solution of nonlinear convection-diffusion equations
including the scalar problems, Euler equations, compressible Navier-Stokes equations,
Richard's equation, shallow water equation, pedestrian flows.

The code is permanently under development, i.e., it is not optimize and it can
sometimes fail due to incorrect settings and not sufficiently robust implementation.


LIBRARY contains several directories
* SRC_O    : source files
* Grids    : computational grids
* Subgrids : used in goal-oriented error estimates
* others ... contains example of <file.ini> with testing data


INSTALATION

Using gfortran, otherwise modify Makefile

> tar xfz adgfem.tgz
> cd adgfem
> ./install.sh



RUNNING of the code
> Adgfem <file.ini>

<file.ini> contains data for the setting of the problem, used mesh, type of
numerical methods, polynomial approximation degrees, nonlinear and linear algebraic
solvers, stopping criteria, error estimation technique, mesh adaptivity, etc.

Many files arise as outputs, 'Sol*.vtk' and 'Tri*.vtk' can be used for "Paraview"
visualization software. Files 'sol*' and 'tri*' can be used for adgfem visualization
tools, e.g.,

> ../SRC_O/plotdgm tri-00000 sol-00000

create the sequence of files 'gnu.00', 'gnu.01', 'gnu.02', etc. the specification
is given in input date file 'plot.dgm'


EXAMPLE

directory 'Eulerian' contains several <file.ini>, e.g.,
file 'nacaM0.50.ini' contains data for the compressible Navier-Stokes
equations, flow around NACA0012 profile with inlet Mach number=0.5,
angle of attack 2 degrees and Reynolds number 5000.
Running of this example:

> cd euleriann
> ../SRC_O/Adgfem nacaM0.05.ini

# after the end of the computation
> ../SRC_O/plotdgm tri-00000 sol-00000

> gnuplot

gnuplot> plot 'gnu.03' w l                # plot the isolines of the Mach number 
gnuplot> plot 'gnu.03' w l,'gnu.00' w l   # plot the isolines of the Mach number with the mesh


CONTACTS:
Vit Dolejsi, dolejsi@karlin.mff.cuni.cz