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 (However, I do not know if these downloads include the frameworks packages.) You may want to look here: http://grass.fbk.eu/grass64/source/REQUIREMENTS.html
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
Linux
Windows
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 |
