How to get RHESSys

Getting the source

The source for RHESSys and various tools for use with RHESSys is hosted on sourceforge and accessible via anonymous subversion access. For the latest stable release, check out

$> svn co https://rhessys.svn.sourceforge.net/svnroot/rhessys/tags/5.14.4

For the latest development version, check out

$> svn co https://rhessys.svn.sourceforge.net/svnroot/rhessys/trunk/

These are instructions for installing the GRASS 6.4 binary, RHESSys, and R on Mac OS X. (There may be differences on Linux or a virtual machine, but hopefully the procedures will be the same/similar, or users of these other platforms can find the installation information to aid them. At this time we don not provide support for PC users, not all RHESSys/GRASS interface programs are PC compatible). In order to install certain RHESSys programs (g2w and CF), GRASS libraries and header files must first be installed, therefore, you must first install GRASS.

Installing GRASS GIS

Frameworks of various Unix image format and GIS libraries are the base requirements for GRASS on Mac OS X. GRASS requires that the frameworks packages be installed prior to installation of GRASS.

You can download the frameworks packages for Mac OS X at: http://www.kyngchaos.com/software/frameworks

Locating GRASS GISBASE

OS X

If you are running GRASS from the application folder, your GISBASE will be /Applications/<GRASS application name>/Contents/MacOS. For example, if your GRASS application was named GRASS-6.4, you would type the command:

$> export GISBASE=/Applications/GRASS-6.4.app/Contents/MacOS

Building RHESSys

The RHESSys source tree contains three separate tools: rhessys, cf, and g2w. Note that default values are specified in the makefiles. This means if you choose to override them you must specify the -e option when running make. As a convenience there is a makefile at the trunk of the source tree that will build and install all RHESSys programs. Before running that file, make sure that you have set all necessary environment variables as listed below.

rhessys

Dependencies

• None

Build Instructions

from the RHESSys/trunk directory containing the makefile

$> make; make install

Environmental Variables

Name	Description	Default
RHESSYS_BIN	The path of the RHESSys installation location	/usr/local/bin
PGM	Name of the RHESSys binary prodouced	rhessys<version>
CC	C Compiler to use	gcc

cf

Dependencies

• GRASS version 6.x

Build Instructions

$> make; make install

Environmental Variables

Name	Description	Default
RHESSYS_BIN	The path of the RHESSys installation location	/usr/local/bin
PGM	Name of the create flowpaths executable	cf
GISBASE	Base GRASS install	none, this variable must be set
CC	C Compiler to use	gcc

g2w

Dependencies

• GRASS version 6.x

Build Instructions

$> make; make install

Environmental Variables

Name	Description	Default
RHESSYS_BIN	The path of the RHESSys installation location	/usr/local/bin
PGM	Name of the grass2world executable	g2w
GISBASE	Base GRASS install	none, this variable must be set
CC	C Compiler to use	gcc