AN IMPORTANT NOTE ABOUT THIS PACKAGE ------------------------------------ The packages in this directory contain scripts, inventories, and ancillary files related to the 2007ee_v5_07c, 2007re_v5_07c, and 2020re_v5_07c cases that were used for the 2012 PM NAAQS RIA. Most emissions for the 2007re_v5_07c case are taken from the 2007ee_v5_05b case, with only the EGU (ptipm sector) and fire emissions changing. Therefore, you must successfully process all sectors for the 2007ee_v5_05b case prior to creating the final merged AQ model-ready emissions for the 2007re_v5_07c case. The 2020re_v5_07c case contains new inventories with the exception of the biogenic and fire emissions which can be taken from the 2007ee_v5_07c case. Scripts for the 2020re_v5_07c case are set up to run all sectors including fire and biogenic emissions so the case can be run independently of the 2007ee_v5_07c case. CMAQ model-ready emissions generated with SMOKE v3.1 and these packages will be identical to those used for the PM NAAQS RIA air quality modeling with the following exceptions: 1. There may be emissions differences resulting from differences in the Linux operating system, hardware platform, and other system specific differences. 2. The 2007 agricultural ammonia emissions will be slightly different due to changes in the final SMOKE 3.1 version which were implemented after the 2007ea case. Documentation on the PM NAAQS emissions cases is available at: http://www.epa.gov/ttn/chief/emch/index.html A. Introduction --------------- This readme file covers the installation of the SMOKE inventories, scripts, and ancillary files used for the PM NAAQS base cases. The SMOKE package executables can be downloaded at http://www.smoke-model.org. Emissions processing is split into "sectors" each with their own scripts for processing. These include: Afdust - Particulate emissions from fugitive dust sources. This sector is processed in two steps. The first processes the annual inventory and the second applied adjustments to the emissions. Ag - Agricultural ammonia emissions. Beis - Biogenic emissions generated using the beis3 model. C1c2rail - Emissions from c1 and c2 commercial marine sources including ports and navigable waterways. Railway emissions are also included. C3marine - Ocean going class 3 marine port and underway emissions. This sector is run as a two part point source. All emissions are considered elevated. Nonpt - US area source emissions not included in other sectors. Nonroad - Off highway mobile source emissions. Onroad - On highway mobile source emissions. This sector is processed using SMOKE MOVES with multiple scripts as described below. Onroad_rfl - The refueling component on the onroad mobile source emissions. This sector is also processed using SMOKE MOVES with multiple scripts as described below. Ptipm - Electric generating unit emissions based on annual emissions inventories. The 2007ee case supplements the annual emissions with CEM (Continuous Emissions Monitoring) hourly emissions for certain sources. Ptnonipm - Point source emissions from industrial activities. Ptfire - Point source Emissions from year specific controlled burning and wild fires. This is only used for the 2007ee case. Avefire - Area source controlled burning and wild fire emissions. These emissions were generated based on a three year average of point source emissions. This is used for the 2007re and 2020re cases. Othar - Area source emissions from Canada and Mexico sources. Othon - Mobile source emissions from Canada and Mexico sources. Othpt - Point source emissions including Canada, Mexico, and US offshore gas and oil extraction sources in the Gulf of Mexico. SMOKE v3.1 and the IOAPI package are required in order to successfully process the emissions using these scripts. The scripts assume that the SMOKE executables are located in: $SMK_HOME/smoke3.1/$SMOKE_EXE. The default $SMK_HOME is the package root ($INSTALL_DIR) plus the "smoke" directory. For example: $SMK_HOME = /home/user/packages/smoke This path is set in each individual script file and can be modified if necessary. B. Emissions used from other cases ---------------------------------- All inputs and SMOKE scripts to create CMAQ ready input emissions for the three cases are contained in the 2007ee_v5_07c, 2007re_v5_07c, and 2020re_v5_07c packages. However, some of the sector emissions for the 2007re case will be included in the final sector merge process. The 2007ee case uses inputs developed for the 2007ea and 2007ed cases and those scripts and inputs are also included in the 2007ee scripts directory. All scripts will need to be run to create the full set of emissions for the 2007ee case. C. Extraction of inventory files -------------------------------- The provided inventory zips need to be extracted in the proper directory for the run scripts to access the inventories. If the user is just running the 2020re case, inputs and scripts from the 2007ee and 2007re cases also must be extracted. The 2020re case uses avefire from the 2007re case and beis emissions from the 2007ee case. If the user is just running the 2007 cases, then the 2020re case inputs and scripts are not necessary. For each of the three cases, all inventory data zips should be extracted under the "project root" path. The project root is the package root (i.e., the base directory containing the subsys, smoke, ge_dat, and project directories) followed by the project name, e.g., "pm_naaqs_ria". For example, if the package root is /home/user/package, then the project root is /home/user/package/pm_naaqs_ria. The inventory files will be extracted under the project root to each respective case input directory. Because this package contains only one sector, all emissions will fall under a path similar to: /home/user/package/pm_naaqs_ria/2020re_v5_07c/inputs/sector All relevant subdirectories will be created during extraction to the project root. The inventory zip files are: 2007ee_v5_07c_inputs.tar.gz 2007re_v5_07c_inputs.tar.gz 2020re_v5_07c_inputs.tar.gz D. Extraction of onroad MOVES emission factor files --------------------------------------------------- The onroad MOVES emission factor files are large (13 GB per scenario zipped) and care was taken to ensure each compressed tar file did not exceed 2GB. The compressed emission factors should be placed in the 2007ee and 2020re case directories (project_root/case). For example, the compressed tar files named 2007ee_*_eftables will be placed in the install_dir/2007ee_v5_07c/2007ee_v5_07c directory if the case is 2007ee_v5_07c. The 2020re_v5_07c emission factor files will be placed in a similar path. Note that the RPD compressed tar files have multiple parts because of the file size limit. E. Extraction of ancillary files -------------------------------- Ancillary files for SMOKE include spatial, temporal, and speciation profile and cross-reference files, grid description (GRIDDESC) files and many other non-inventory files that are required to run SMOKE. The files in this package are compatible with the 2008 NEI in terms of SCCs contained. The provided ancillary zips need to be extracted in the proper directory for the run scripts to access the inputs. For the 2007ee, 2007re, and 2020re cases, all ancillary input zips should be extracted under the "package root/2007ee_v5_07c" path. For example, if the package root is /home/user/package, then the ancillary input will be extracted to: /home/user/package/2007ee_v5_07c/ge_dat All three cases will use ancillary files in this directory. The ge_dat directory contents can be placed in another path but the script "ge_dat" environment variable will need to be changed. Note that two sets of Canadian surrogates are included but the case scripts use only the 4-digit newer surrogates. The ancillary inputs are contained in the zip file: ge_dat_2007v5.tar.gz F. Extraction of scripts ------------------------ The scripts zip needs to be extracted in the proper directory for successful completion. For each of the cases, the scripts zip should be extracted under the "project root" path. For example, if the package root is /home/user/package, then the project root is /home/user/package/2007ee_v5_07c if the project is 2007ee_v5_07c. The script files will be extracted under the project root to the scripts directory. For example, using the above project root, the scripts will be in: /home/user/package/2007ee_v5_07c/scripts The script files are 2007ee_07c_scripts.tar, for example. All relevant subdirectories will be created during extraction to the project root. The correct script paths should be as follows: $INSTALL_DIR/2007ee_v5_07c/scripts $INSTALL_DIR/2007re_v5_07c/scripts $INSTALL_DIR/2020re_v5_07c/scripts G. Extraction of SMOKE Helper Scripts ------------------------------------- SMOKE helper scripts are contained in the smoke_helper_scripts.tar.gz archive. This file should be copied to the smoke directory ($SMOKE_HOME as defined in the sector run scripts). Extract files from this archive at this directory location. Files will be extracted to smoke3.1/scripts and smoke3.1/assigns paths. H. Configuring the scripts --------------------------- All scripts must be edited in order to specify the package root and meteorological data root. These environment variables can be set near the top of each script file. The package root uses the "INSTALL_DIR" environment variable. Set this to the path where your smoke and project root paths are located. For example: /home/user/package The meteorological data root uses the "MET_ROOT" environment variable. MCIP meteorology is used for processing of the afdust, onroad, onroad_rfl sectors and the biogenics (BEIS) sector. The specified path should contain 12US1 2007 year data. The scripts should be setup by the user to run for the entire 2007 year and should require no other edits. Default locations of input and output directories are defined in the scripts. Once the scripts are installed, they can be edited to modify the location of other directories if necessary. I. Running the scripts ------------------------ Once the SMOKE scripts are configured as described above, each sector can be run as described below. Running afdust (2007ee, 2020re) ------------------------------- The script beginning with "Annual_afdust" will be run to generate unadjusted afdust emissions for representative days. The script beginning with "Afdust_adjustment" will then be run to adjust emissions for the transportable portion of fugitive dust and for meteorological conditions that impact dust. Final sector emissions intermediate files will be in the intermediate/afdust_adj subdirectory. Running ptipm (2007ee, 2007re, 2020re): --------------------------------------- In order to run the ptipm sector, the script beginning with "Annual_ptipm_onetime" must be executed so that annual intermediate files can be created. On successful completion of the "Onetime" script, the associated script that starts with "Daily_ptipm" should be run to process the daily inventories and emissions. In order to successfully process the PTDAY files for the daily emissions, the variable "NAMEBREAK_DAILY" may need to be edited in the ptipm scripts. The NAMEBREAK_DAILY should be set to the number of underscores (_) in the path to the PTDAY files plus the number of underscores in the section of the name of the PTDAY files that comes before the month name. Similar edits will need to be made to the "NAMEBREAK_HOURLY" variable in the 2007ee case run. For example, the NAMEBREAK_DAILY will be "9" for the following file. /system/user/packages/2007re_v5_07c/2007re_v5_07c/inputs/ptipm/ptday/work/ptd ay_ptipm_capcl_cem_2007ee_jan_ida.txt Running beis (2007ee) --------------------- Biogenic emissions will be created once using the script beginning with Annual_beis. MCIP meteorology files will be required to run beis. Running onroad(2007ee, 2020re) and onroad_rfl(2007ee, 2020re): -------------------------------------------------------------- SMOKE MOVES is run to generate onroad emissions. Three combinations of activity and emission factor data (RPD, RPP, and RPV) are run using SMOKE scripts. The scripts "Monthly_onroad_RPD", "Monthly_onroad_RPP", and "Monthly_onroad_RPV" are run first. Some consideration should be given to running RPD in quarter or month scripts in parallel due to the extremely long run time. The script "Monthly_onroad_merge" can be run to merge all three components. Run the "Monthly_onroad_rfl" scripts similar to the scripts above. Run the "Onroad_calif_adj" script to adjust the onroad emissions to match emissions totals provided by California ( CARB). Running ag(2007ee, 2020re), nonpt(2007ee, 2020re), and nonroad(2007ee, 2020re) ------------------------------------------------------------------------------ Run the Monthly sector scripts. For the 2007ee case these are: Monthly_ag_12US1_2007ed_v5_07c.csh Monthly_nonpt_12US1_2007ee_v5_07c.csh Monthly_nonroad_12US1_2007ee_v5_07c.csh Running ptipm (2007ee, 2020re), ptnonipm (2007ee, 2020re), c3marine(2007ee, 2020re), othpt(2007ee, 2020re) and ptfire(2007ee) ----------------------------------------------------- Run Annual_sector_onetime scripts first and then the Daily_sector scripts. For the 2007ee case these are: Annual_ptipm_onetime_12US1_2007ee_v5_07c.csh Daily_ptipm_12US1_2007ee_v5_07c.csh Annual_ptnonipm_onetime_12US1_2007ee_v5_07c.csh Daily_ptnonipm_12US1_2007ee_v5_07c.csh Annual_c3marine_onetime_12US1_2007ea_v5_07c.csh Daily_c3marine_12US1_2007ea_v5_07c.csh Annual_othpt_onetime_12US1_2007ea_v5_07c.csh Daily_othpt_12US1_2007ea_v5_07c.csh Annual_ptfire_onetime_12US1_2007ea_v5_07c.csh Daily_ptfire_12US1_2007ea_v5_07c.csh Running c1c2rail(2007ee, 2020re), othar(2007ee, 2020re), avefire(2007re, 2020re) othon(2007ee and 2020re) ------------------------------------------------------------------------- Run the Annual_sector scripts. For the 2007ee case these are: Annual_c1c2rail_12US1_2007ee_v5_07c.csh Annual_othar_12US1_2007ed_v5_07c.csh Annual_othon_12US1_2007ea_v5_07c.csh And 2007re case: Annual_avefire_12US1_2007re_v5_07c.csh Run scripts to window beis and avefire (2020re). -------------------------------------------------- Because the beis and avefire sector emissions were generated for the 12US1 domain that is larger than 12US2, run the Window_avefire.csh and Window_beis.csh scripts to window the emissions to the 12US2 domain to be consistent with the other 2020re sectors. J. Generating the model-ready files (i.e., merging emissions from different sectors) ------------------------------------------------------------------------- The "Sector_mrggrid" script is used to generate the merged CMAQ low level model-ready netCDF files. This script will use the sectorlist file provided in the scripts path and all of the sector level emissions. All model-ready low level files and inline files, will be directed to the output directory (smoke_out) under the project root path. The 2007ee inline files for the ptipm, ptnonipm, othpt, c3marine, and ptfire sectors will be contained in subdirectories of the output directory for the 12US1 domain. Ptipm inline files for the 2007re case are located in the output directory for that case while the ptnonipm inline files will use those produced for the 2007ee case. C3marine and othpt inline files are located in the 2007ea output directory. Ptfire inline files are only used with the 2007ee case. Both the 2007ee and 2007re cases were initially run through SMOKE to generate sector emissions for the 12US1 domain. An additional script must be run to window the low level model-ready merged emissions to the 12US2 domain used for CMAQ modeling. The script is called Window_emis_12US2.csh.