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 CentOS-7.9 compatible systems, but has also been tested on Rocky Linux 8.5 and may work on other compatible Linux 64-bit operating 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.1.tar.gz

This will create a Geo2Grid software bundle directory, geo2grid_v_1_1. 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_1

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.

Note

A one-time initialization process is performed the first time any of the bash scripts are run. The extracted directory can NOT be moved after this is performed. In a shared user installation (multiple users running the same installation), the user that extracted the tarball should run a script to perform this initialization before any other users (ex. -h to geo2grid.sh).

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.1_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.1_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.