Tutorial

###R.SUN.DISTRIBUTED EXAMPLE

Review the required dependencies to make sure you have everything install correctly

Using all of the Sol components is a relatively simple task. Running a module requires 2 steps. First you need to start the master node.

To start the master node execute the command r.sun.distributed -n "Project Name" -D [Project Directory] DEM.tif

The second step is to start worker nodes. If you are using the U of A HPC you can download submit_hpc.sh. Otherwise go to HPC Systems to find out more about loading workers.

r.sun.distributed specifically calculates a years worth solar insulation models include global irradiation rasters and insulation time rasters. Sol (specifically r.sun.distributed) creates a directory structure which will be required for all subsequent scripts - do not delete or modify if you wish to run further operations included in Sol.

r.sun.distributed will store its outputs in the daily folder.

proj_dir
└───DEM
    └───global
    |   └─── daily
    |   └─── monthly
    |   └─── annual
    └───insol
        └─── daily
        └─── monthly
        └─── annual

Notes:

• The project name will default to "r.sun.dist" if no name is specified
• All Sol components run on port 9101, which must be accessible from the outside.
• DEMs must be in GeoTiff format, ending in .tif
• If no project directory is specified, the output files will be located in the current working directory.

###R.SERIES.DISTRIBUTED EXAMPLE

r.series.distributed creates monthly and annual statistics of the daily rasters computed by r.sun.distributed. The following statistics are calculated:

• average
• median
• standard deviation
• variance

As with r.sun.distributed, r.series.distributed has two step to running, with a preliminary caveat.

In order for r.sun.distributed to work correctly, you must point it to the directory created by r.sun.distributed. This can be done by simply calling r.series.distributed from the proj_dir directory, or by passing it as an argument.

To start a r.series.distributed master node run r.series.distributed -f [MONTHLY/ANNUAL] -d proj_dir -n "Project Name"

You can start workers using the same method as r.sun.distributed.

Notes:

• The project name will default to "r.series.dist" if no name is specified
• All Sol components run on port 9101, which must be accessible from the outside.
• DEMs must be in GeoTiff format, ending in .tif
• If no project directory is specified, the output files will be located in the current working directory.