Radial++ Files

                  =====================
                  RADIAL++ README FILE
                  =====================
                            
                     Testing Version
                      Version 0.0.5

==============================================================================
 Radial++
==============================================================================

Radial++ is a library of classes and templates in C++ for the numerical solution 
of partial differential equations (no weak solutions) and the interpolation
of scattered data by Radial Basis Functions (RBFs).

Radial++ works with generalized RBFs, like thin-plate splines, power splines,
Gaussian, multiquadrics and inverse multiquadrics. This means that you can
configurate the RBF to work with any degreee of the associated polynomial
to the RBF and also, give the free exponent in the generalized RBF.

In particular, we can interpolate data in any dimension, and also, the library
provide several examples for numerical solution of partial differential
equations by using the unsymmetric collocation method.

Radial use the library called Seldon to perform matrix and vector operations,
Seldon is included, so, you dont need to download Seldon.  It is convenient to
say that the best performance is obtained with the interface to BLAS and LAPACK,
see Seldon. Radial++ can work without the interface of BLAS and LAPACK. In 
particular, all the provided examples run without any external pre-installed 
library.

This README file describes how to install the libray called RADIAL++.

==============================================================================
 The Compiler
==============================================================================

Radial++ is supposed to be fully compliant with the C++ standard. 
Therefore, it can be compiled by GNU GCC (>=3.0; tested with version 3.4, 4.4). 
No tests were conducted with proprietary compilers under Unix, but the 
compliance with the C++ standard should ensure portability.  Please tell 
me if you have any problem running the test problems.

==============================================================================
 Installation
==============================================================================
The library called Radial++ is ready to run "out the box", it is not neccesary
to have a previous library installed in your machine. All the necessary files
are contained in Radial++.

To compile the examples only modify the file:

  examples/Makefile.in 

in particular the "tag" <RBF> which correspond to the path where the library 
was unzipped.

!!This is the only modification that you need to do to run all the examples.


If additionn, optionally, in the file examples/Makefile.in you can modify the
compiler selected (CXX==?) and the flags in the compilation (CXXFLAGS=?)

==============================================================================
 Running Examples
==============================================================================
Before to continue, check that  you are using the correct Makefile.in  for your 
system.

The examples are divided into two categories:

examples/interpolation
examples/pde

each folder has several folders

examples/interpolation/1d
         interpolation/2d
         interpolation/3d

examples/pde/advection
         pde/allen-cahn
         pde/burger
         pde/circle        <- Poisson in the circle with analytical solution
         pde/helmholtz
         pde/poisson
         pde/laplace
         
         
Inside of each folder you only need to write in the shell:  

make help

and follow the given instructions.


==============================================================================
 Author
==============================================================================
This work was proposed by the professor Pedro Gonzalez-Casanova, and provide me
the theoretical background. 

Jose Antonio Munoz-Gomez
jantoniomex@gmail.com
University of Guadalajara
Mexico
2  Agosto  2009