+-------------------------------------------------------------+
|                                                             |
|   P2MESH                                                    |
|                                                             |
|      a collection of generic classes for PDE solvers        |
|               on unstructured 2-D grids.                    |
|                                                             |
|   date: 2002, 4 April                                       |
|                                                             |
+-------------------------------------------------------------+

The software library comes in a unique file to be included in all
P2MESH-based applications, namely `p2mesh.hh'.

No installation is required, no library files are to be precompiled and
linked.

The directory `doc/' contains three postscript
files which are the user manual, a description of the library
implementation and a primer introduction to programming with `p2mesh.hh'. 

The directory `test/' contains some test driver programs.  The directory
`test/meshes/' contains input data files for test drivers and `test/meshes_ps/'
the postscript pictures of the meshes. The test drivers produces output
files *.out to be compared with the corresponding *.expected files.

The directory `examples/' contains some application programs described 
in `primer.ps' and their input data. When the application programs are
run, they produce a final *.mtv file, suitable to visualization by
using the tool "plotmtv". They may also be compared with the final 
expected files *.mtv.expected.

WARNING -------------------------------------------------------------------
All *.expected files in test/ and examples/ are generated on a 64 bit
Sun-Solaris platform. If comparison with *.out and *.mtv files is performed 
by using the Unix command "diff", some discrepancies in floating point 
numbers could appear due to different roundings.
---------------------------------------------------------------------------

The P2MESH package has the following structure:

-- README    : this file
-- p2mesh.hh : the library file
-- abstract  : work abstract in ascii format

-- doc/
     -- userman.ps.gz : user manual for P2MESH programmers
     -- kernel.ps.gz  : internal implementation description
     -- primer.ps.gz  : beginner's introduction with commented examples

-- test/ : this directory contains some test driver programs
     -- makefile
     -- p2print.hh
     -- checkall.cc
     -- testall_triangle.cc
     -- testall_quad.cc
     -- testall_marker.cc
     -- testall_triangle.expected
     -- testall_triangle_l.expected
     -- testall_quad.expected
     -- testall_quad_l.expected
     -- testall_marker.expected
 
     -- meshes/ : mesh data sets used by the test driver programs
          -- mesh.grd        : data for read_map_mesh method

          -- mesh.node  -+
          -- mesh.ele    |   : data for a triangle-based mesh
          -- mesh.edge  -+

          -- mmesh.node -+
          -- mmesh.ele   |   : data for a triangle-based mesh with user 
          -- mmesh.edge -+     defined markers

          -- qmesh.node -+
          -- qmesh.ele   |   : data for a quadrilateral-based mesh
          -- qmesh.edge -+

    -- meshes_ps/ : pictures of the meshes generated by test driver
                    programs or that are in meshes/
          -- map_mesh.ps
          -- qmap_mesh.ps
          -- qread_map_mesh.ps
          -- qread_mesh.ps
          -- qstd_tensor_mesh.ps
          -- qtensor_mesh.ps
          -- read_map_mesh.ps
          -- read_mesh.ps
          -- std_tensor_mesh.ps
          -- tensor_mesh.ps

-- examples/ : sources of the application programs described
               in doc/primer.ps
     -- makefile
     -- p2_solver.cc
     -- q2_solver.cc
     -- cc_solver.cc
     -- cv_solver.cc
     -- cc.mtv.expected
     -- cv.mtv.expected
     -- p2.mtv.expected
     -- q2.mtv.expected
     -- eu.cc
     -- eu.hh
     -- ramp.node -+
     -- ramp.ele   |   : data for a triangle-based mesh
     -- ramp.edge -+
     -- ramp.inp       : run time data for the Euler problem. 

---------------------------------------------------------------------------
Enrico Bertolazzi
Department of Mechanics and Structures Engineering            
University of Trento
Via Mesiano 77                       Tel: +39-461-882590
I-38050 Trento                       Fax: +39-461-882599
Italy                                mailto:enrico.bertolazzi@ing.unitn.it
---------------------------------------------------------------------------
Gianmarco Manzini
Institute of Numerical Analysis
Consiglio Nazionale delle Ricerche (CNR)           
Via Ferrata 1                        Tel: +39-382-548215
I-27100 Pavia                        Fax: +39-382-548300
Italy                                mailto:gianmarco.manzini@ian.pv.cnr.it
---------------------------------------------------------------------------
