ChomboVis is a visualisation package from the makers of CHOMBO. It is no longer supported and VisIt is now the visulaisation tool of choice. However, ChomboVis may still be useful for debugging purposes and so the notes below describe how to build and run this package.
In addition to these notes, you may like to look at http://seesar.lbl.gov/anag/chombo/chomboVis/UsersGuide.html.
ChomboVis relies upon a number of other packages, so you will need to install these before building ChomboVis. However, the default build for ChomboVis assumes that they are built inside it's own build directory, so you will need to unpack the ChmboVis tar file first. On dartagnan I untarred it in /opt/chombovis. You can copy the tar file, ChomboVis-4.16.11.tar.gz from that directory.
Needs to be unpacked so that it is a generally available package for Python. On dartagnan (CentOS), I used:
yum install python-pmw
to quickly achieve this, but you can also get the package from http://sourceforge.net/projects/pmw.
You can copy /opt/chombovis/ChomboVis-4.16.9-and-everything/hdf5-1.6.5.tar.gz on dartagnan, and build using:
tar -xzf hdf5-1.6.5.tar.gz cd hdf5-1.6.5 ./configure --prefix=/opt/chombovis/ChomboVis-4.16.11 make install
You can copy /opt/chombovis/ChomboVis-4.16.9-and-everything/Python-2.3.3.tar.gz and build using:
tar -xzf Python-2.3.3.tar.gz cd Python-2.3.3 ./configure --prefix=/opt/chombovis/ChomboVis-4.16.11 make install
You can copy /opt/chombovis/ChomboVis-4.16.9-and-everything/vtk4.4-src.tar.gz. The build is different, however, and also a bit buggy.
tar -xzf vtk4.4-src.tar.gz cd vtk4.4-src/VTK
You will need cmake installed on your machine to build the package. I used:
yum install cmake
You will need to congigure the build using:
My settings were:
BUILD_EXAMPLES OFF BUILD_SHARED_LIBS ON CMAKE_BACKWARDS_COMPATIBILITY 2.2 CMAKE_BUILD_TYPE CMAKE_INSTALL_PREFIX /opt/chombovis/ChomboVis-4.16.11 PYTHON_INCLUDE_PATH /usr/include/python2.4 PYTHON_LIBRARY /usr/lib64/python2.4/config/libpython2.4.a VTK_DATA_ROOT VTK_DATA_ROOT-NOTFOUND VTK_GLEXT_FILE /opt/chombovis/ChomboVis-4.16.11/vtk4.4-src/VTK/Utilities/ParseOGLExt/headers/ VTK_GLXEXT_FILE /opt/chombovis/ChomboVis-4.16.11/vtk4.4-src/VTK/Utilities/ParseOGLExt/headers/ VTK_USE_HYBRID ON VTK_USE_PARALLEL ON VTK_USE_PATENTED ON VTK_USE_RENDERING ON VTK_WGLEXT_FILE /opt/chombovis/ChomboVis-4.16.11/vtk4.4-src/VTK/Utilities/ParseOGLExt/headers/ VTK_WRAP_JAVA OFF VTK_WRAP_PYTHON ON VTK_WRAP_TCL ON
Building ChomboVis (v4.16.11)
Now you can move on to building ChomboVis itself:
./configure --prefix=/opt/chombovis/ChomboVis-4.16.11 --disable-unittests make install
In order to run bin/chombovis, you will need to augment your LD_LIBRARY_PATH:
Calling ChomboVis from a Debugger
Page 131 of the CHOMBO user manual, http://seesar.lbl.gov/ANAG/chombo, lists a number of commands you can issue when running CHOMBO in a debugger (gdb, ddd) (you will need to set the environment variable CHOMBOVIS_HOME appropriately):
One may use the writeFAB, writeFABname, writeLevel, and writeLevelname functions described in section 6.3 to write data in a FArrayBox or LevelData<FArrayBox> to a file, and then call ChomboVis from a shell to view the data. Alternatively, the viewFAB and viewLevel functions allow ChomboVis to be called directly from the gdb session. To use these functions, the environment variable CHOMBOVIS HOME must be defined and set to the location of the ChomboVis installation directory tree; the chombovis executable must be located in $(CHOMBOVIS HOME)/bin. Then, if one has an FArrayBox fab and a LevelData<FArrayBox> ldf, one may do the following: <gdb prompt> call viewFAB(&fab) <gdb prompt> call viewLevel(&ldf) which will result in fab and ldf being written to separate temporary files, and then two chombovis processes being started, one for fab, and one for ldf.