2. Installation

Geo2Grid is released as an all-in-one tarball for Enterprise Linux systems. The tarball, or software bundle, provided by the CSPP for Geostationary Satellites (CSPP Geo) team includes a python runtime and all of the necessary third-party software to run the features provided by Geo2Grid. The tarball uses bash scripts for conveniently calling the python software or utilities provided by third-party vendors. The software bundle is only supported on CentOS6-compatible systems, but may work on other Linux systems as well. There are other ways to install Geo2Grid on other operating systems, but the instructions to do so are beyond the scope of this documentation.

Please Contact Us if you have questions about installation.

2.1. Geo2Grid Software

The Geo2Grid tarball can be downloaded from the CSPP Geo website: http://cimss.ssec.wisc.edu/csppgeo/

To install the software, unpack the tarball:

tar xf CSPP_GEO2GRID_V1.0.0.tar.gz

This will create a Geo2Grid software bundle directory, geo2grid_v_1_0_0. To simplify calling scripts included in the bundle the following line should be added to your .bash_profile:

export GEO2GRID_HOME=/path/to/geo2grid_v_1_0_0

All other environment information needed to run is automatically loaded by the scripts provided by Geo2Grid. Scripts are typically invoked using:

$GEO2GRID_HOME/bin/<g2g_script.sh> ...

To execute commands without including the preceding directory path, or if using in a script in its own background environment, then set the path to include the /bin directory:

export PATH=$PATH:$GEO2GRID_HOME/bin

The example invocations in this document assume you have added this to your PATH.

See Geo2Grid Basics for more information on running Geo2Grid.

2.2. Geo2Grid Test Data

To confirm a successful installation download the following verification test data set:

CSPP_GEO2GRID_V1.0.0_TEST_DATA.tar.gz

The test data should be unpacked in a directory separate from the Geo2Grid installation:

cd $HOME
tar xf CSPP_GEO2GRID_V1.0.0_TEST_DATA.tar.gz

This will create a geo2grid_test directory containing the test input, output, and verification scripts for the ABI instrument.

See Verifying your Geo2Grid Installation for instructions on using the verification test data.