3.1. Download and Installation

The suite of programs and utilities that comprise the Spatial Allocator are written in C, with the exception of srgmerge which is written in C++. To date the software suite has been tested on linux and Windows XP systems. Identical results have been obtained in every case.

To download and install the program, perform the following steps:

  1. Download the executables for your computer's operating system (e.g.,Red Hat Linux, Windows) and unzip this into the installation folder. Alternatively, you may build your own executables from the source code (see the README files in the src directory).
     
  2. Download the source code, scripts, and documentation. Unzip this file into a new installation folder with at least 40 MB of available disk space.
     
  3. Download the input data files (60 MB) and unzip them into the installation folder. The coordinates for these data files are in a Lambert Conformal conic map projection, with standard parallels 33 and 45 degrees, a central meridian of -97 degrees, and the latitude of the projection origin is 40 degrees. The ellipsoid used for the Earth is a spheroid. Note: This is a different map projection than is used for the output grid in the example case. The README.txt file in the data directory has additional information on these input shapefiles. If you wish to view these in a GIS with other files, it is recommended that you convert these to a latitude-longitude projection using the convert_shape script provided with this program (but be sure to set the projection parameters by adjusting the INPUT_FILE_MAP_PRJN and OUTPUT_FILE_MAP_PRJN variables in the script before you run it). Alternatively, you may download data files that have already been converted to latitude-longitude and visualize those.
     
  4. If you are interested in the E-Grid, you can download an example E-Grid file

    5.  
  5. If you are interested in the surf zone computation, you can download this country boundaries file

    6.  
  6. If you are interested in preparing beld3 inputs to SMOKE, you can download this beld tile data. Note: this data is about 1GB unzipped.

    7.  
  7. If you are interested in the Surrogate Tools, which help manage the process of creating surrogate files that are inputs to SMOKE and to quality assure surrogate data, see the Surrogate Tools web page.

    8.  
  8. After you have unzipped the above files, you should see the following directories in your installation folder: data, doc, scripts, src, and testsuite. The executables named allocator, srgcreate, beld3smk, srgmerge, diffsurr, diffioapi, and dbf2asc should be visible directly in the installation folder. NOTE: the beld3smk and diffioapi programs are not currently available for Windows.
     
  9. For additional input data, check the EPA site http://www.epa.gov/ttn/chief/emch/. The Spatial section has data used to create surrogates, and the Biogenic section (http://www.epa.gov/ttn/chief/emch/biogenic/) has data used to create SMOKE biogenic-related input files.'

To Section 3.2: Runing the Test Cases Using Scripts