How to get RHESSys
Contents
Getting the RHESSys source code
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/
Below 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
After installing the frameworks packages, install the GRASS 6.4 binary. You can download GRASS 6.4 for Mac OS X at: http://www.kyngchaos.com/software/grass
You can download GRASS for other platforms at: http://grass.fbk.eu/download/software.php (unknown if these downloads include the frameworks packages.) You may want to look here for additional assistance: http://grass.fbk.eu/grass64/source/REQUIREMENTS.html
Locating GRASS GISBASE
OS X
Some RHESSys programs will look for certain GRASS libraries and headers. You must set some environmental variables by pointing the GISBASE to where the libraries and headers are installed. On Mac OS X this should be /Applications/GRASS-6.4.app/Contents/MacOS (assuming you downloaded version 6.4; if you download a different version, then edit the command for the version you installed).
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 is named GRASS-6.4, you would type the command (Open a terminal window, and at the terminal window command prompt, type) :
$> export GISBASE=/Applications/GRASS-6.4.app/Contents/MacOS
If you are working on a platform other than Mac OS X, then point the GISBASE to wherever the GRASS libraries and headers are located.
Building RHESSys
The RHESSys source tree contains three separate tools: RHESSys, CF (create flowpaths), and g2w (GrassToWorld). 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 in a global install. 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 |
