5.14.3. Files and Environment Variables

5.14.3.1. Input Files
5.14.3.2. Input Environment Variables
5.14.3.3. Output Files

5.14.3.1. Input Files

File Name Format Description
GRIDDESC ASCII Grid descriptions file that defines the output grid for the output surrogates file created by the program. It must include the name of the grid set by the IOAPI_GRIDNAME_1 environment variable setting.
INFILE ASCII Area and Mobile spatial surrogate file format (see Section 8.4.2, “Area and Mobile Spatial Surrogates Files”) and Biogenic spatial surrogate file format (see Section 8.4.5, “BGPRO: Biogenic spatial surrogate file”). File can be for Lambert Conformal, UTM, or lat-lon projection.

5.14.3.2. Input Environment Variables

  • IOAPI_GRIDNAME_1: [default: blank]

    This variable sets the name of the output grid definition to be read from the GRIDDESC input file. The name can be a maximum of 16 characters (the limitation of I/O API grid names).

5.14.3.3. Output Files

File Name Format Description
LOGFILE ASCII Log generated from executing Surgtool
OUTFILE ASCII Estimated surrogates file for the grid defined in GRIDDESC and selected by the IOAPI_GRIDNAME_1 setting. This surrogates file is not as accurate as creating a spatial surrogates file from the MIMS spatial allocator. However, the finer the Surgtool input grid is relative to the output grid, the more accurate the estimated surrogates are.