Download

BEARCLAW is distributed from a svn repository http://coanda.amath.unc.edu/svn/bearclaw. The Trac system is used to manage the project.

Installation

The following assumes that BEARCLAW is to be installed in your home directory, you have an svn client available on your system, and you are using a bash shell.

• Check out a copy of the distribution from the repository:

  cd ~
  svn co http://coanda.amath.unc.edu/svn/bearclaw

• Set BEARCLAW environment variable (place this in your ~/.bashrc file also)

  export BEARCLAW=~\bearclaw

• The BEARCLAW distribution includes the required libraries under $BEARCLAW/hdf compiled using gcc and Intel Fortran (Version 10.0 as of 11/15/07). If you are using the same compilers you can skip this step. Otherwise, install HDF4 and HDF5 support libraries (see http://hdf.ncsa.uiuc.edu for instructions). Set the LD_LIBRARY_PATH environment variable:

export LD_LIBRARY_PATH=$BEARCLAW/hdf/lib

* The support libraries differ on 32bit and 64bit systems.

• For 32bit systems

cd $BEARCLAW/hdf
ln -s lib lib32
ln -s include include32

• For 64bit systems

cd $BEARCLAW/hdf
ln -s lib lib64
ln -s include include64

• Edit $BEARCLAW/Makefile.inc paths and options. The relevant section of Makefile.inc is shown below.

##################################################################################
# Local installation options
# Set the following paths to reflect your installation. (1-3)
#
# 1. Location of HDF include, module, lib files
HDFINC=$(BEARCLAW)/hdf/include
HDFMOD=$(BEARCLAW)/hdf/lib
HDFLIBS = -L$(BEARCLAW)/hdf/lib -lhdf5_fortran -lhdf5 -lmfhdf -ldf -ljpeg -lz -lsz
#
# 2. Compiler/linker choices for serial/parallel compilation
#
COMPILER = ifort          # Intel Fortran Compiler
LINKER = ifort
MPICOMPILER = mpif90      
MPILINKER = mpif90
#
# 3. Compilation options (Default is normal debugging)
FFLAGS = -g
LFLAGS =
#    Extensive debugging with full run-time checks and profiling
#FFLAGS = -g -qp -zero
#LFLAGS = -qp
#    Extensive optimization
#FFLAGS = -O3 -tpp7 -mp1 -prec_div -pc80 -ip -unroll -w  
#LFLAGS = 

# End of installation options
#####################################################################################

• Verify the installation by compiling and executing an example

  cd $BEARCLAW/examples/wavebear/2d/advection/example1
  make
  xbear

• Visualize results using opendx

  dx -image -program advect.net

• Visualize results using matlab. In your matlab session:

  cd $BEARCLAW/examples/wavebear/2d/advection/example1/out
  path(path,'~/bearclaw/matlab')
  plothdf2