FINNv2.5 emissions are available in 2 formats: text files for each fire (as for previous versions) and in 0.1x0.1 degree gridded files from the NCAR RDA (https://rda.ucar.edu/datasets/ds312.9/) and on the NCAR computer casper (/glade/campaign/acom/acom-weather/emmons/emissions_finn/finn2.5_grid_0.1x0.1/).
The "fire_emis" fortran program described below reads the text files of each fire emissions. Note that "emis_finn" does not work for some regionally refined grids, so for these cases we recommend regridding the 0.1 gridded files with other standard mass-conserving regridding tools (such as https://ncar.github.io/CAM-chem/examples/functions/Regridding.html).
fire_emis fortran gridding program
fire_emis is a fortran program that grids FINNv1.5 or FINNv2 fire emissions (text files from Christine Wiedinmyer, available at: http://bai.acom.ucar.edu/Data/fire/) and produces netcdf files for WRF-Chem, global regular lat-lon grids, and Spectral Element unstructured grids. The same source code is used to produce any of the model formats, as specified in an input namelist. Please address any questions about this code to the WRF-Chem Fire_Emis Forum: https://groups.google.com/a/ucar.edu/forum/?hl=en#!forum/wrf-chem-fire_emiss
To run fire_emis you must provide a namelist of input variables. Several examples are provided in the /run/ directory.
The directory storing the raw FINN data files (*.txt). Note that fire_directory must end with a "/" as in: /myhome/FIRE_data/
The file name of the raw FINN data (must be .txt format). You can optionally add up to 5 files here by adding a new line fire_filename(2), etc. If you specify multiple fire filenames the times in the input files must be consecutive with no gaps.
The start date of the output emissions in YYYY-MM-DD format.
The end date of the output emissions in YYYY-MM-DD format.
The output timing: 'daily' or ‘monthly’
‘WRF’ or ‘CAMFV’ or ‘CAMSE’. Determines how other namelist variables are used and determines the output grid
Specifies the directory of the WRF input files wrfinput_d<nn>. Note that wrf_directory must end with a "/".
ONLY FOR CAMSE: The file describing the grid (must be .nc format), see examples provided.
ONLY FOR CAMSE: The directory storing the grid data files. Default is the current working directory ('./').
CAMFV: The resolution of the output grid. Possible options:
'0.5x0.5' (720x360); '1x1' (360x180); 'T42LR' (Lin-Rood, 128x64); 'T63LR' (192x96); 'T85LR' (256x128); 'T106LR' (320x160); 'T170LR' (512x256);
'1.9x2.5' (144x96); 0.9x1.25 (288x192)
CAMSE: label for output files only
WRF: not used
The emission type (only used for naming the output files): a label such as ‘bb_surface’.
The FINN Version: ‘1.5’ or ‘2.2MOD’ or ‘2.2MODVIRS’ (only used for naming the output files).
The default units (molecules/cm^2/s). This namelist value is only used for adding unit attributes to the ouput files. If you want to convert to different units, you must update this name and use the glb2fire_map namelist parameter with the appropriate scalling factors for unit conversion. All unit conversions beyond molecules/cm^2/s are done in this namelist, and not by the code itself (see examples). If you want to change units for only certain species, use the optional_non_default_unit_attribute in the glb2fire_map namelist parameter, as explained below.
CAMFV or CAMSE:
Specifies the mapping between global model variables and fire emission variables. glb2fire_map is a character array of size 500. If you enter more than 500 variables there is no error halt but only the first 500 will be mapped.
Generally the format for gases is
Generally the format for aerosols is
Specifies the mapping between WRF variables and fire emission variables, as with glb2fire_map. Each entry is limited to 164 characters. Examples:
wrf2fire_map = 'co -> CO' maps the FINN variable CO to the WRF variable co.
wrf2fire_map = 'co -> CO', 'hc3 -> alk2 + 1.11 * alk3 + 0.4 * meoh'
WRF (optional): default = 1
If you set domains = 2 then fire_emis will expect to find files wrfinput_d01 and wrfinput_d02 in the directory indicated by the wrf_directory variable.
WRF (optional): default = 2 (square kilometers)
Specifies the level of diagnostics output when running fire_emis. The default value of 100 results in the minimum diagnostic output. The diag level is set in multiples of 100. Setting diag_level to 400 produces maximal diagnostics and is appropriate when a prior fire_emis invocation has failed.
Notes for MOZART-T1 chemistry with MAM4 aerosols in CESM2
- WRF fire emissions datasets are created in a format for input into WRF-Chem simulations employing the plume rise option. When using the provided "base" fire emissions the created wrffirechemi_d<nn>_<date>_<time> files will include BOTH smoldering and flaming emissions. The resulting netcdf files are named wrffirechemi_d<nn>_<date>_<time>.
- The WRF fire emissions datasets contain species fire emissions and related fire size and vegetation cover type variables. The species emissions are denoted as ebu_in_<species_name> where <species_name> is a valid WRF species name such as co. The species emissions have units of moles/km^2/hr or ug/m^2/s for gas phase or aerosol species respectively. The fire size and vegetation cover type variables are denoted as MEAN_FCT_<type> and FIRESIZE_<type> where <type> is: AGTF = "tropical forest",
AGEF = "extra tropical forest", AGSV = "savanna", AGGR = "grassland". The MEAN_FCT_<type> variable represents the mean area fraction for each of the four vegetation cover types per WRF horizontal grid cell. The FIRESIZE_<type> variable represents the fire size in km^2 for each of the four vegetation cover types per WRF horizontal grid cell. Presently the FIRESIZE_<type> variables are limited to 2 km2. Vegetation maps used for gridding are available at: http://bai.acom.ucar.edu/Data/fire/ and must be placed in the same directory as the original FINN text files.
- For WRF, before invoking fire_emis you must have a WRF initial condition file per WRF domain. Standard WRF initial condition files are denoted wrfinput_d<nn>
where <nn> represents the domain number in two-digit, integer format. Thus, the standard initial condition file for WRF domain number 1 is ‘wrfinput_d01’.
- fire_emis outputs hourly WRF emission files by applying a diurnal factor to the daily emissions. Presently the "WRAP" diurnal factor is applied.
- WRF fire emissions datasets are created in a format for input into WRF-Chem simulations employing the plume rise option. When using the provided "base" fire emissions the created wrffirechemi_d<nn>_<date>_<time> files will include both smoldering and flaming emissions. Users need to set the scale_fire_emiss variable in namelist.input to .true. and ensure to select a chemistry option that enables this scaling.