SMOKE v2.1 User’s Manual


Table of Contents

1. Introduction
2. SMOKE Concepts
3. SMOKE Directories and Default Data
4. Using SMOKE Scripts
5. SMOKE Utility Programs
6. SMOKE Core Programs
7. SMOKE Quality Assurance
8. SMOKE Input Files
9. SMOKE Intermediate Files
10. SMOKE Output Files
11. Source Code and Include Files
12. Downloading, Installing, and Compiling SMOKE
Appendix A. Glossary
Appendix B. Abbreviations

List of Figures

2.1. Generic example of how cross-reference files and profiles work together
2.2. Example model grid
2.3. Serial approach to emissions processing
2.4. Parallel approach to emissions processing
2.5. Processing steps for running an additional grid in SMOKE
2.6. Processing steps for running an additional chemical mechanism in SMOKE
2.7. Processing steps for running a control scenario in SMOKE
2.8. Base case area-source processing steps
2.9. Future- or past-year growth and optional control area-processing steps
2.10. Alternative future- or past-year growth and control area-processing steps
2.11. Biogenic-source processing steps and intermediate files
2.12. Biogenic-source processing steps and intermediate files using both winter and summer emission factors
2.13. Base case mobile VMT approach processing steps
2.14. Future- or past-year growth and control mobile-source processing steps
2.15. Base case point-source processing steps for the CMAQ-based approach
2.16. Base case point-source processing steps for the UAM-based approach
2.17. Future- or past-year growth and control point-source processing steps for the CMAQ-based approach
2.18. Future- or past-year growth and control point-source processing steps for the UAM-based approach
2.19. Combining and sorting ASCII inputs to created sorted I/O API outputs
2.20. Transformation of inventory data to hourly data
2.21. Relationship of inventory sources to speciation matrix
2.22. Relationship between inventory and gridding matrix
2.23. Spatial allocation of county-total emissions
2.24. Spatial allocation of on-road mobile link sources
2.25. Representation of ungridding
2.26. Relationship between inventory sources and growth matrix
3.1. Basic SMOKE directories: the first three levels of the directory structure
3.2. Subdirectories of the main SMOKE directory
3.3. SMOKE input files directory structure
3.4. Locations of intermediate and output files for SMOKE base case, basic configuration
3.5. Locations of intermediate and output files for SMOKE base case, advanced configuration
3.6. Locations of intermediate and output files for SMOKE future-/past-year case
4.1. nctox domain
6.1. SMOKE core programs
6.2. Cntlmat input and output files
6.3. Elevpoint input and output files
6.4. Emisfac input and output files
6.5. Grdmat input and output files
6.6. Grwinven input and output files
6.7. Laypoint input and output files
6.8. Mbsetup input and output files
6.9. Mrggrid input and output files
6.10. Normbeis3 input and output files
6.11. Premobl input and output files
6.12. Rawbio input and output files
6.13. Smkinven input and output files for area sources
6.14. Smkinven input and output files for mobile sources
6.15. Smkinven input and output files for point sources
6.16. Smkmerge input and output files for area sources
6.17. Smkmerge input and output files for biogenic sources
6.18. Smkmerge input and output files for mobile sources
6.19. Smkmerge input and output files for point sources
6.20. Smkmerge input and output files for all source categories
6.21. Spcmat input and output files
6.22. Temporal input and output files for area sources
6.23. Temporal input and output files for mobile sources
6.24. Temporal input and output files for point sources
6.25. Tmpbeis3 input and output files
6.26. Tmpbio input and output files
7.1. Flow diagram for examining log files

List of Tables

2.1. Inventory source categories and SMOKE processing capabilities and categories
2.2. AMS road class and corresponding area and facility type
2.3. Road class and corresponding MOBILE6 road type
2.4. Vehicle type codes and descriptions
2.5. MOBILE6 vehicle type and corresponding SMOKE vehicle type
2.6. Example OUTZONE settings and their associated time zones
3.1. Default SMOKE ancillary files associated with inventories
3.2. Default SMOKE ancillary files except inventory and speciation files
3.3. Default SMOKE ancillary files for speciation in $SMKDAT/ge_dat ($GE_DAT)
4.1. Variable in Assigns file for naming files and directories
4.2. Variables in Assigns file for controlling time period and grid of processing
4.3. List of RUN_<Program> settings and situations to set to Y
4.4. Valid SPC settings
4.5. QA_TYPE settings with associated source categories and default REPCONFIG files
8.1. Inventory Files
8.2. Temporal Allocation Input Files
8.3. Spatial Allocation Input Files
8.4. Chemical Speciation Input Files
8.5. Growth and Controls Input Files
8.6. Special Merging Input Files
8.7. Meteorology Input Files
8.8. Biogenic-Specific Input Files
8.9. Mobile-Specific Input Files
8.10. Point-Specific Input Files
8.11. Other Support Input Files
8.12. Cntlmat input files for nctox case
8.13. Elevpoint input files for nctox case
8.14. Emisfac input files for nctox case
8.15. Grdmat input files for nctox case
8.16. Grwinven input files for nctox case
8.17. Laypoint input files for nctox case
8.18. Mbsetup input files for nctox case
8.19. Mrggrid input files for nctox case
8.20. Normbeis3 input files for nctox case
8.21. Premobl input files for nctox case
8.22. Rawbio input files for nctox case
8.23. Smkinven input files for nctox case
8.24. Smkmerge input files for nctox case
8.25. Spcmat input files for nctox case
8.26. Temporal input files for nctox case
8.27. Tmpbeis3 input files for nctox case
8.28. Tmpbio input files for nctox case
8.29. Inventory header commands for IDA and ORL formats
8.30. IDA Format for ARINV
8.31. EMS-95 Format for ARINV
8.32. ORL Nonpoint Format for ARINV
8.33. ORL Nonroad Format for ARINV
8.34. Format for BCUSE
8.35. Format for BGUSE
8.36. IDA Activity Data Format for MBINV
8.37. IDA Emissions Data Format for MBINV
8.38. EMS-95 Nonlink Column-specific Format for MBINV
8.39. EMS-95 Nonlink List-directed Format for MBINV
8.40. EMS-95 Link Format for MBINV
8.41. ORL Format for MBINV
8.42. Format for individual day-specific data files
8.43. EMS-95 Format for individual hour-specific files
8.44. CEM Format for individual hour-specific data files
8.45. IDA Format for PTINV
8.46. EMS-95 Format for device.pt
8.47. EMS-95 Format for emission.pt
8.48. EMS-95 Format for facility.pt
8.49. EMS-95 Format for process.pt
8.50. EMS-95 Format for stack.pt
8.51. ORL Format for PTINV
8.52. EMS-95 Column-specific Format for VMTMIX
8.53. EMS-95 List-directed Format for VMTMIX
8.54. Format for ATPRO, MTPRO, and PTPRO
8.55. Format for ATREF
8.56. Format for MTREF
8.57. Format for PTREF
8.58. Format for HOLIDAYS
8.59. Format for AGPRO and MGPRO
8.60. Format for AGREF and MGREF
8.61. Format for GSCNV
8.62. Format for GSPRO
8.63. Format for area- and mobile-source GSREF
8.64. Format for point-source GSREF
8.65. Format for /ALLOWABLE/ packet in GCNTL
8.66. Format for /CONTROL/ packet in GCNTL
8.67. Format for /CTG/ packet in GCNTL
8.68. Format for /EMS_CONTROL/ packet in GCNTL
8.69. Format for /MACT/ packet in GCNTL
8.70. Format for /PROJECTION/ packet in GCTNL
8.71. Format for /REACTIVITY/ packet in GCNTL
8.72. Format for FILELIST
8.73. Format for METLIST
8.74. Format for RADLIST
8.75. Format for B3FAC
8.76. Format for B3XRF
8.77. Format for BFAC
8.78. Format for M6LIST
8.79. Format for MCODES
8.80. Format for MCREF
8.81. Format for MEFLIST
8.82. Format for MEPROC
8.83. Format for MVREF
8.84. Format for SPDPRO
8.85. Format for SPDREF
8.86. Format for PSTK
8.87. Format for PTMPLIST
8.88. Format for ARTOPNT
8.89. Format for COSTCY
8.90. Valid COSTCY time zones
8.91. Format for INVTABLE
8.92. Format for NHAPEXCLUDE
8.93. Format for ORISDESC
8.94. Format for SCCDESC
8.95. Format for VNAMMAP
9.1. I/O API Header for ACMAT, MCMAT, and PCMAT
9.2. Variables in ACMAT, MCMAT, and PCMAT
9.3. I/O API Header for APMAT, MPMAT, and PPMAT
9.4. Variables in APMAT, MPMAT, and PPMAT
9.5. I/O API Header for ARMAT, MRMAT, and PRMAT
9.6. Variables in ARMAT, MRMAT, and PRMAT
9.7. File columns in PELV
9.8. I/O API Header for STACK_GROUPS
9.9. Variables in STACK_GROUPS
9.10. I/O API Header for emission factor files
9.11. Variables in STACK_GROUPS
9.12. I/O API Header for AGMAT, MGMAT, and PGMAT
9.13. Variables in AGMAT, MGMAT, and PGMAT
9.14. I/O API Header for AREA_O, MOBL_O, and PNTS_O
9.15. Variables in AREA_O, MOBL_O, and PNTS_O
9.16. I/O API Header for PLAY and PLAY_EX
9.17. Variables in PLAY and PLAY_EX
9.18. File columns in SPDSUM
9.19. File columns in DAILYGROUP, WEEKLYGROUP, MONTHLYGROUP, and EPISODEGROUP
9.20. I/O API Header for B3GRD
9.21. Variables in B3GRD
9.22. I/O API Header for hourly temperature files
9.23. Variables in hourly meteorology files
9.24. I/O API Header for BGRD and BGRDW
9.25. Variables in BGRD and BGRDW
9.26. I/O API Header for AREA, MOBL, and PNTS
9.27. Variables in AREA, MOBL, and PNTS
9.28. File columns in ASRC, MSRC, and PSRC
9.29. I/O API Header for PDAY and PHOUR
9.30. Variables in PDAY and PHOUR
9.31. I/O API Header for ASMAT_S, MSMAT_S, and PSMAT_S
9.32. Variables in ASMAT_S, MSMAT_S, and PSMAT_S
9.33. I/O API Header for ASMAT_L, MSMAT_L, and PSMAT_L
9.34. Variables in ASMAT_L, MSMAT_L, and PSMAT_L
9.35. I/O API Header for ATMP, MTMP, and PTMP
9.36. Variables in ATMP, MTMP, and PTMP
10.1. I/O API Header for [A|B|M|P|E]G[T][S][3D][_S][_L]
10.2. Variables in [A|B|M|P|E]G[T][S][3D][_S][_L]
10.3. I/O API Header for B3GTS_L and B3GTS_S
10.4. Variables in B3GTS_L and B3GTS_S
11.1. SMOKE programs and source code directories

List of Examples

8.1. [A|M|P]TPRO file
8.2. M6LIST file
8.3. MOBILE6 scenario file
8.4. MCODES file
8.5. MCREF file
8.6. MEPROC file
8.7. MVREF file