Overview

This roll bundles the GEOS geometry engine, GDAL (Geospatial Data Abstraction Library) , and PROJ (Cartographic Projections Library) as well as as the R interfaces to geos (rgeos) and gdal (rgdal).

Other dependent R libraries are installed as well:

FNN foreign gstat RSAGA shapefiles spacetime intervals xts

For more information about GEOS,GDAL and PROJ please visit the official web pages:

• GEOS is a C++ port of the Java Topology Suite (JTS).
• GDAL is a translator library for raster geospatial data formats
• PROJ converts geographic longitude and latitude coordinates into cartesian coordinates

Requirements

To build/install this roll you must have root access to a Rocks development machine (e.g., a frontend or development appliance).

If your Rocks development machine does not have Internet access you must download the appropriate geo source file(s) using a machine that does have Internet access and copy them into the src/geos directory on your Rocks development machine.

Dependencies

The sdsc-roll must be installed on the build machine, since the build process depends on make include files provided by that roll.

The roll sources assume that modulefiles provided by SDSC compiler and R rolls are available, but it will build without them as long as the environment variables they provide are otherwise defined.

The build assumes that the R plyr, rcpp, sp, and zoo are available to R. The SDSC r-modules-roll installs these along with a variety of other R packages.

Building

To build the geo-roll, execute this on a Rocks development machine (e.g., a frontend or development appliance):

% make 2>&1 | tee build.log

A successful build will create the file geo-*.disk1.iso. If you built the roll on a Rocks frontend, proceed to the installation step. If you built the roll on a Rocks development appliance, you need to copy the roll to your Rocks frontend before continuing with installation.

This roll source supports building with different compilers. The ROLLCOMPILER make variable can be used to specify the names of compiler modulefiles to use for building the software, e.g.,

% make ROLLCOMPILER=intel 2>&1 | tee build.log

The build process recognizes "gnu", "intel" or "pgi" as the value for the ROLLCOMPILER variable. The default value is "gnu".

Installation

To install, execute these instructions on a Rocks frontend:

% rocks add roll *.iso
% rocks enable roll geo
% cd /export/rocks/install
% rocks create distro

Subsequent installs of compute and login nodes will then include the contents of the geo-roll. To avoid cluttering the cluster frontend with unused software, the geo-roll is configured to install only on compute and login nodes. To force installation on your frontend, run this command after adding the geo-roll to your distro

% rocks run roll geo host=NAME | bash

where NAME is the DNS name of a compute or login node in your cluster.

In addition to the software itself, the roll installs geo environment module files in:

/opt/modulefiles/applications/geo

## Testing

The geo-roll includes a test script which can be run to verify proper
installation of the roll binaries and module files. To run the test scripts
execute the following command(s):

```shell
% /root/rolltests/geo.t