ChomboVis

From SourceWiki
Revision as of 15:01, 12 January 2009 by GethinWilliams (talk | contribs)
Jump to navigation Jump to search

Introduction

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.

Prequisites

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.

Python Megawidgets

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.

HDF5 (v1.6.5)

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

Python (v2.3.3)

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

VTK (v4.4)

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.

Unpack normally:

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

on dartagnan.

You will need to congigure the build using:

ccmake .

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 

Now type:

cmake .

followed by:

make install

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:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/chombovis/ChomboVis-4.16.11/lib/vtk

Calling ChomboVis from a Debugger