4.18.3. Files and Environment Variables

4.18.3.1. Input Files
4.18.3.2. Input Environment Variables
4.18.3.3. Output Files
4.18.3.4. Processing Multiple Days with BEIS3

Figure 4.30. Tmpbeis3 input and output files

Tmpbeis3 input and output files

Figure 4.30, “Tmpbeis3 input and output files” shows the input and output files for the Tmpbeis3 program. The input files include the gridded, normalized biogenic emissions from Normbeis3 (B3GRD) and, if BIOSW_YN = Y, then a gridded, seasonal switch file output from Metscan is required (BIOSEASON). The biogenic speciation profiles are read from the GSPRO file and the GRID_CRO_2D contains the latitude and longitute for each grid cell. Tmpbeis3 reads surface pressure and radiation/cloud data from MET_FILE1 and optionally from MET_FILE2 if BIOMET_SAME = N.

Tmpbeis3 outputs gridded, speciated, hourly biogenic emissions files in moles/hour (B3GTS_L) and tons/hour (B3GTS_S). The program also outputs an execution log file (LOGFILE).

4.18.3.1. Input Files

File Name Format Description
B3GRD I/O API NetCDF Gridded, normalized biogenic emissions, output from Normbeis3
BIOSEASON (optional) I/O API NetCDF Gridded seasonal switch file containing daily data, with “0” meaning use winter normalized emissions and “1” meaning use the summer normalized emissions, produced by Metscan
GSPRO ASCII Speciation profiles file (use “BV309” for CB04 speciation profile or “B10C5” for CB05 speciation profile.)
GRID_CRO_2D I/O API NetCDF Meteorology file containing latitude and longitude coordinates for each grid cell
MET_FILE1 I/O API NetCDF Meteorology file containing temperature and surface pressure data and possibly radiation/cloud data as well (see BIOMET_SAME environment variable)
MET_FILE2 (optional) I/O API NetCDF Meteorology file containing radiation/cloud data if not in MET_FILE1
SOILINP (optional) I/O API NetCDF Gridded soil restart file ( use if INITIAL_RUN = N)

4.18.3.2. Input Environment Variables

  • BEIS_VERSION: [default: 3.60]

    Specifies which version of BEIS3 to use.

    • 3.60: Use BEIS version 3.60.

    • 3.14: Use BEIS version 3.14.

  • BG_CLOUD_TYPE: [default: 1]

    Specifies which meteorological data to use.

    • 1: Use RGND or RSD (solar radiation reaching the ground) from MM5 to calculate PAR. No other options are supported at this time.

  • BIOG_SPRO: [default: BV310]

    Specifies the speciation profile for biogenic emissions from GSPRO.

    • B3V10: Use BEIS version 3.60.

    • BV313: Use BEIS version 3.14.

  • BIOMET_SAME: [default: N]

    Defines whether the radiation/cloud data are in the same file as the temperature data (MET_FILE1) or in a different file (MET_FILE2).

  • BIOSW_YN: [default: Y]

    Indicates whether to use a gridded seasonal switch file.

    • Y: Use gridded seasonal switch file BIOSEASON

    • N: Use environment variable SUMMER_YN to determine season

  • INITIAL_RUN: [default: N]

    Indicates whether a particular day is the first day in a sequence of simulations.

    • Y: Use for the first day in a sequence of simulations. Use if the SOILINP file does not yet exist (i.e., the soil NO calculations will not depend on the previous day’s rainfall).

    • N: Use for subsequent days in a sequence of simulations. Use if the SOILINP file exists.

    Note that BEIS3 will create a SOILINP file for days subsequent to the first day in a sequence of simulations.

  • ISLTYP_VAR: [default: SLTYP]

    Specifies the soil type variable name used if PX_VERSION = Y.

  • LAI_VAR: [default: LAI]

    Specifies the variable name for the leaf area index from the me model (e.g. WRF) used for the leaf temperature algorithm (Only for BEIS version 3.60)

  • OUTZONE: See description in Section 4.17.3.2, “Input Environment Variables”

  • OUT_UNITS: [default: 1]

    Specifies units for the output variables.

    • 1: moles per hour.

    • 2: moles per second.

  • PRES_VAR: [default: PRSFC]

    Specifies the variable name for surface pressure data to extract from MET_FILE1.

  • PX_VERSION: [default: N]

    Indicates whether the Pleim-Xiu land surface model was used in the MM5 simulations.

    • Y: Use if the Pleim-Xiu land surface model was used in the MM5 simulations. Indicates that MET_FILE1 contains soil temperature, soil moisture and soil type fields that can be used, along with rainfall data, for NO soil emission calculations in Tmpbeis3.

    • N: Use if the Pleim-Xiu land surface model was not used in the MM5 simulations. Indicates that Tmpbeis3 will calculate NO soil emissions using only rainfall data.

  • Q2_VAR: [default: Q2]

    Specifies the variable name for the two meter water vapor mixing ratio (kg/kg) used for the leaf temperature algorithm (Only for BEIS version 3.60).

  • RAD_VAR: [default: RGRND]

    Specifies the variable name for radiation/cloud data to extract from either MET_FILE1 or optional MET_FILE2.

  • RADYNI_VAR: [default: RADYNI]

    Specifies the variable name for the aerodynamic resistance variable (s/m) used for the leaf temperature algorithm (Only for BEIS version 3.60).

  • RGRND_VAR: [default: RGRND]

    Specifies the variable name for the solar radiation reaching the ground used for the leaf temperature algorithm (Only for BEIS version 3.60).

  • RSTOMI_VAR: [default: RSTOMI]

    Specifies the variable name for the inverse of the stomatal resistance variable (m/s) used for the leaf temperature algorithm (Only for BEIS version 3.60).

  • RC_VAR: [default: RC]

    Specifies the convective rainfall variable name used in MET_FILE1.

  • RN_VAR: [default: RN]

    Specifies the non-convective rainfall variable name used in MET_FILE1.

  • SOILM_VAR: [default: SOIM1]

    Specifies the soil moisture variable name used if PX_VERSION = Y.

  • SOILT_VAR: [default: SOIT1]

    Specifies the soil temperature variable name used if PX_VERSION = Y.

  • SUMMER_YN: [default: Y]

    Indicates whether summer or winter normalized emissions should be used; only used when BIOSW_YN is N.

    • Y: Use summer normalized emissions

    • N: Use winter normalized emissions

  • TEMPG_VAR: [default: TEMPG]

    Specifies the skin temperature at the ground level (K) used for the leaf temperature algorithm (Only for BEIS version 3.60).

  • TMPR_VAR: [default: TA]

    Specifies the variable name for temperature to extract from MET_FILE1.

  • USTAR_VAR: [default: USTAR]

    Specifies the variable name for the surface friction velocity (m/s) used for the leaf temperature algorithm (Only for BEIS version 3.60).

4.18.3.3. Output Files

File Name Format Description
B3GTS_L I/O API NetCDF Gridded, speciated, hourly biogenic emissions, in moles/hour
B3GTS_S I/O API NetCDF Gridded, speciated, hourly biogenic emissions, in tons/hour
SOILOUT I/O API NetCDF Gridded soil restart file
LOGFILE ASCII Log generated from executing Tmpbeis3

4.18.3.4. Processing Multiple Days with BEIS3

The user must point to the SOILOUT file from one day’s simulation as the SOILINP file for the next day. The user must also decide whether to write over SOILOUT files from previous days or create a uniquely named SOILOUT file for each day. The latter approach is recommended if the user wishes to retain the capability to restart simulations in the middle of a sequence of simulations.