SOLVCON 0.1.4

Solvers of Conservation Laws

SOLVCON is a collection of conservation-law solvers that use the space-time Conservation Element and Solution Element (CESE) method.

Install

Clone the hg repository from https://bitbucket.org/solvcon/solvcon:

$ hg clone https://bitbucket.org/solvcon/solvcon

SOLVCON needs the following packages: gcc 4.3+ (clang on OSX works as well), SCons 2+, Python 2.7, Cython 0.16+, Numpy 1.5+, LAPACK, NetCDF 4+, SCOTCH 6.0+, Nose 1.0+, Paramiko 1.14+, boto 2.29.1+, gmsh 2.5+, and VTK 5.6+.

In the contrib/ directory, you can find the scripts for installing these dependencies:

• aptget.*.sh for Debian/Ubuntu

• conda.sh for Miniconda/Anaconda

The binary part of SOLVCON should be built with SCons:

$ scons scmods

Then add the installation path to the environment variables $PATH and $PYTHONPATH.

Additional build and tests:

• Building document requires Sphinx 1.1.2+, Sphinxcontrib issue tracker 0.11, and graphviz 2.28+. Once the binary of SOLVCON is built, the following commands can build the document:

  $ cd doc
  $ make html

  The built document will be available at doc/build/html/.

• Unit tests should be run with Nose:

  $ nosetests

• Another set of tests are collected in ftests/ directory, and can be run with:

  $ nosetests ftests/*

  Some tests in ftests/ involve remote procedure call (RPC) that uses ssh. You need to set up the public key authentication to properly run them.