CentPack Documentation

How to Obtain CentPack

Precompiled CentPack libraries for several architectures can be downloaded from our software page. The source code (C++) is also available for registered users. Both versions are distributed with sample source files that implement the auxiliary functions required to compile a central solver.

How to Install CentPack

The following are instructions for a quick installation, if you need detailed information, please read this README file, or CentPack user's guide.

Precompiled libraries: If you downloaded any of the precompiled binaries, you just need to extract the directory CP-1.0 from the downloaded archive and place it in your home directory (or anywhere else where you have write permission).

Source code: To compile and install the source code extract the directory CP-1.0 from the downloaded archive and place it in your home directory (or anywhere else where you have write permission). Then, open a command shell and type

> cd CP-1.0/

> make libs

If everything goes well, the directory CP-1.0/lib/ should now contain seven libraries, one for each central solver and one for the array classes used by CentPack.

-close-

How to use CentPack

Once CentPack libraries have been installed, you can compile and run some or all the examples distributed with the package or create your own central solver for other hyperbolic problems.

To compile all the examples at once, type

> make samples

this will create a directory for each of the examples we provide (each one using a different central solver) inside the directory CP-1.0/samples/.

To run one of those examples, go to the corresponding subdirectory, and type ./example_name. For instance, to run a solver for Burgers' equation, from the CP-1.0 directory, you can type

> cd samples/burgers_1d_SD3/

> ./burgers_1d_SD3

while running, after each time step, the code will produce one line of output to the screen that will let you monitor the progress of the simulation. When the simulation is done, you can find the files containing the numerical solution in the subdirectory u_files/. The times at which the output was produced can be found in the files outputted to t_files/.

For information on how to compile a single application, modify input parameters, manipulate output, etc., please refer to the README file or the user guide below.

-close-

User's Guide

For complete information about CentPack, read the user's guide. There you can find detailed information about the structure of the code, the algorithm, and each central solver implemented in this version.