Installation

TUMBLE uses the GNU Automake/Autoconf/libtool programs to configure and build. We prefer to install to a subdirectory of the TUMBLE directory rather than to the /usr directory as TUMBLE is an experimental package.

There are two key shell variables that must be set correctly for TUMBLE to function.

  1. TUMBLE_DIR - set to the root of the TUMBLE directory
  2. TUMBLE_REPOS - A directory to store archived output from TUMBLE's ruby frontend experiment system. This should not be a subdirectory of TUMBLE_DIR as it should be more permenant that a working SVN copy of TUMBLE.

Required Software

  1. OpenGL/glut
  2. ruby >=1.8
  3. swig >=1.3.21
  4. petsc >=2.2.0 with 'g_c++' and 'O_c++' BOPT versions built (see PETSC)
  5. gcc >= 3.2.0

Supported Platforms

  1. CS Facilities Redhat 9.0 Linux
  2. Mac OS X
  3. Most Linux flavors (Suse, Gentoo, etc. )

Instructions

If you will be working frequently with TUMBLE, we recommend you set all shell variables in your .bashrc or .tcshrc. Also it is recommended you always run the debugging version by specifying the '-d' flag in step 4.
  1. set shell variable TUMBLE_DIR to the TUMBLE root directory
  2. set shell variable TUMBLE_REPOS to an empty directory. This is where the experiment data will be saved when using the new experiment system
  3. make sure petsc shell variables are set. See PETSC for details. BOPT is set automatically, but make sure you have built both O_c++ and g_c++ versions of PETSC.
    1. PETSC_DIR
    2. PETSC_ARCH
  4. run ./setup.sh or ./setup.sh -d for debugging.
  5. make
  6. make install

Testing

Assuming you have configured and built TUMBLE, you can run the following commands to test it:

This should run 10 timesteps of simple NavierStokes flow in a tube
$ ./bin/tumble-run.rb -t 10 -i test/experiments/tube.exp

This should create a model of a ventricular assist pump.
$ ./bin/tumble-run.rb -t 0 -i test/experiments/pump_multiscale.exp

Assuming you can open an x-window, you can view the output with:
$ ./bin/tumble-view.rb -e tube
$ ./bin/tumble-view.rb -e pump_multiscale

You can play around with a mesh using:
$ ./bin/tumble-debug.rb

Troubleshooting

If the build fails to find X11 headers or libraries, you may need to specify these manually. This can be done by either:
  1. running:
    1. $ export LDFLAGS="$LDFLAGS -L/path/to/x11/libs"
    2. $ export CPPFLAGS="$CPPFLAGS -I/path/to/x11/headers"
  2. Or, editing configure.ac, and making the same changes to CPPFLAGS and LDFLAGS

Either way, go back to step "4" in the installation process

Please report any problems to: Mark Olah (mjo@andrew.cmu.edu)

Generated on Mon May 24 09:53:32 2010 for TUMBLE by  doxygen 1.5.2