4.5.3. Files and Environment Variables

4.5.3.1. Input Files
4.5.3.2. Input Environment Variables
4.5.3.3. Output Files

Figure 4.5. Grwinven input and output files

Grwinven input and output files

Figure 4.5, “Grwinven input and output files” shows the input and output files for the Grwinven program. The input files include at least one growth or control matrix output from Cntlmat (ACMAT01, MCMAT01, or PCMAT01). If you are applying more than one growth or control matrix (i.e. SMK_NUM_CNTLMAT is greater than one), Cntlmat will open additional matrices as needed (ACMAT[xx], MCMAT[xx], or PCMAT[xx]). Cntlmat also uses the inventory file output from Smkinven (AREA, MOBL, or PNTS) and the country, state and county file (COSTCY).

Grwinven outputs new SMOKE intermediate inventory files (AREA_O, MOBL_O, or PNTS_O) that have been controlled and/or grown into the past or future. Note that the suffix _O is used to distinguish the Grwinven output files from the input files. You can also choose to output ASCII inventory files in ORL format (ARINV_O, MBINV_O, or PTINV_O). Grwinven also writes a log file (LOGFILE) and can create an ASCII inventory file for activity data (MBINV_AO).

4.5.3.1. Input Files

File Name Format Description
[A|M|P]CMAT_01 I/O API NetCDF Control or growth matrix output from Cntlmat; total number of files is determined by SMK_NUM_CTLMAT setting
[A|M|P]CMAT_02, [A|M|P]CMAT_03, ... I/O API NetCDF Additional control or growth matrices; total number of files is determined by SMK_NUM_CTLMAT setting
[AREA|MOBL|PNTS] SMOKE map Intermediate inventory file produced by Smkinven
COSTCY ASCII Country, state, and county file
GEOCODE_LEVEL[1-4] ASCII Geographical level codes and descriptions for gridded inventories, only when USE_EXP_GEO_CODES is set to Y, (COSTCY is ignored when GEOCODE_LEVEL[1-4] files are used)

4.5.3.2. Input Environment Variables

  • USE_EXP_GEO_CODES: [default: N]

    If set to Y then use GEOCODE_LEVEL[1-4] files instead of the COSTCY file to define expanded geographical detail such as country-level(GEOCODE_LEVEL1), country/state-level (GEOCODE_LEVEL2), country/state/county-level (GEOCODE_LEVEL3) or country/state/county/tribal-level (GEOCODE_LEVEL4).

  • ORL_NONROAD_OUT: [default: N]

    • Y: Output NONROAD inventory in ORL format

    • N: Do not output NONROAD inventory in ORL format

  • SMK_GRWORLOUT_YN: [default: N]

    Indicates if an ORL-formatted grown and/or controlled inventory should be output. Currently only ORL nonpoint ond point inventory formats are supported. SMK_GRWORLOUT_YN and SMK_GRWIDAOUT_YN cannot be both set to Y in the same run. In SMOKE version 2.3, the Grwinven ORL output format was changed to use a more compact structure (eliminated spaces), uses commas, and includes semi-colons around all text fields. These changes make these files much smaller and easier to import to other software, but unfortunately harder to read in a text editor.

    • Y: Output inventory in ORL format

    • N: Do not output inventory in ORL format

  • SMK_GRWSMKOUT_YN: [default: Y]

    • Y: Output inventory in SMOKE I/O API format

    • N: Do not output inventory in SMOKE I/O API format

  • SMK_NUM_CTLMAT: [default: 1]

    Number of control and/or growth matrices to import and apply to the inventory.

  • SMK_TMPDIR: [default: .]

    Defines the path to use for temporary files that are written out when supplying the inventory.

4.5.3.3. Output Files

File Name Format Description
[AREA_O|MOBL_O|PNTS_O] SMOKE map Annual and average-day inventory emissions and source characteristics
[ARINV_O|MBINV_O|PTINV_O] ASCII Annual and average-day inventory emissions and source characteristics
LOGFILE ASCII Log generated from executing Grwinven
MBINV_AO ASCII Annual activity inventory and source characteristics