3.1. Download and Installation

  1. Reorganized directory structure:
    2. Directory Content
    /bin all executable files
    /data input data used by the example run scripts
    /doc user manuals and release notes for the current version of the SA
    /output output data generated by the example run scripts
    /raster_scripts example run scripts for the SA Raster Tools
    /scripts example run scripts for the SA Vector Tools
    /src SA source code
    /srgtools files for the SA Surrogate Tools
  2. To download and install the Spatial Allocator, perform the following steps:
    1. The Spatial Allocator (set of Vector, Raster and Surrogate Tools) is available for download from the CMAS Center website
    2. On the left-hand side of the website, in the Download Center panel, click on MODEL
    3. Log in using an existing CMAS account, or create a new CMAS account.
    4. Use the pull-down list to select Spatial Allocator as the model you wish to download, then click submit.
    5. Specify the type of computer you are planning to run the Spatial Allocator as Linux.
    6. In the table that appears, follow the links to the gzipped tar archive for Linux, download this file into a directory with at least 40 MB of available disk space.
    7. Binary executables are provided for users who are running on Red Hat Linux computer using 32 bit compilers
    8. Alternatively, if you are running on a different Unix platform, you may build your own executables from the source code (see the README files in the src directory).
    9. After you have downloaded the sa_03_2009.tar.gz download file from the CMAS website do the following:
      tar -xzvf sa_03_2009.tar.gz
      The directory sa_03_2009 (referred to as the SA_HOME variable in the scripts) will contain the following subdirectories: bin, doc, output, raster_scripts, scripts, src, srgtools .
    10. The following input data files are available for download from the CMAS website, and you have the option to download them at the same time that you download the sa_03_2009.tar.gz file. In case you did not download the input data from the CMAS site, links to the data are also provided here.
      1. Download the input data files (51 MB unzipped)
        at the same directory level as you untarred the sa_03_2009.tar.gz, please do the following:
        tar -xzvf sa_03_2009_data.tar.gz
        This will create the sa_03_2009/data directory containing the input data files.
      2. Download the Sample Beld3 data at the same directory level. This tar file contains BELD3 inputs to SMOKE, a sample E-Grid file, and a county boundaries file for surf zone computation, and other data files required by the Spatial Allocator.
        tar -xzvf sample_beld3_data.tar.gz
        This will create the sa_03_2009/data/beld directory containing the beld3 input data.
      3. Download Sample Shapefiles (1.7 GB unzipped)
        at the same directory level as you untarred the sa_03_2009.tar.gz, please do the following:
        tar -xzvf sample_srgtools_data.tar.gz
        This will create the sa_03_2009/data/emiss_shp2003 directory containing the sample emission shapefiles.
    11. 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 User Guide.
    12. If you are interested in the Raster Tools, see Raster Tools User's Guide
    13. 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: Setting Up User Environment for Vector Tools