How to get RHESSys

From Rhessys
Revision as of 08:46, 10 October 2012 by Jchoate (talk | contribs)
Jump to navigationJump to search

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.) 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.


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