_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 1 SMOKE Programs and Options l Smkinven l Rawbio l Grdmat l Spcmat l Cntlmat l Premobl l Emisfac l Elevpoint l Temporal l Tmpbio l Laypoint l Smkmerge l Grwinven l Mrggrid

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 2 Smkinven (1) l Imports area, mobile, or point source inventories l Inputs – Inventory file(s) ARINV | MBINV | PTINV – Day-specific file(s) PTDAY – Hour-specific file(s) PTHOUR – Gridded inventory file AG – VMT Mix file for EMS-95 intputs VMTMIX – Time zones COSTCY – Mobile codes MCODES – Replacement stack parameters PSTK – Valid activities ACTVNAMS – Valid pollutants SIPOLS

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 3 Smkinven (2) l Outputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – SMOKE day-specific file PDAY – SMOKE hour-specific file PHOUR – Inventory SCCs list ASCC | MSCC | PSCC – Point source temporal x-ref (EMS-95 input) PTREF_ALT

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 4 Smkinven (3) l Major settings – SMK_SOURCE:[A | M | P] sets source category – DAY_SPECIFIC_YN: Y = import day-specific data – HOUR_SPECIFIC_YN: Y = import hour-specific data – IMPORT_AVEINV_YN: Y = import inventory – RAW_DUP_CHECK:Y = error for duplicate records – VELOC_RECALC:Y = recalculate stack velocity from flow – WEST_HSPHERE:N = do not convert coordinates – WKDAY_NORMALIZE: Y = use weekday to normalize weekly profile

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 5 Rawbio l Imports county or gridded land use data l Inputs – County land use data BCUSE – Gridded land use data BGUSE – BEIS2 emission factors BFAC – Gridding surrogates BGPRO – Grid description file G_GRIDPATH l Outputs – Gridded, normalized emissions BGRD l Major settings – Environment variables for the gridding surrogate to use for each major landuse type (e.g., PINE_SURG, DECD_SURG)

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 6 Grdmat (1) l Creates area, mobile, or point source gridding matrix and mobile ungridding matrix l Inputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – Gridding cross-reference AGREF | MGREF – Gridding surrogates AGPRO | MGPRO – Grid description file G_GRIDPATH – Mobile codes MCODES

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 7 Grdmat (2) l Outputs – Gridding matrix AGMAT | MGMAT | PGMAT – Ungridding matrix MUMAT – Supplemental information AGSUP | MGSUP | PGSUP l Major settings – REPORT_DEFAULTS:N = does not report when default surrogates are used – SMK_SOURCE:[A | M | P] sets source category – SMK_DEFAULT_SRGID:Number sets fallback surrogate for case of zero emissions because of surrogate setting

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 8 Spcmat (1) l Creates area, mobile, or point source speciation matrix for mass-based and/or mole-based factors l Inputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – Speciation profiles GSPRO – Speciation cross-reference GSREF – Pollutant conversion file GSCNV – Mobile codes MCODES – Mobile emission processes MEPROC

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 9 Spcmat (2) l Outputs – Mole speciation matrix ASMAT_L | MSMAT_L | PSMAT_L – Mass speciation matrixASMAT_S | MSMAT_S | PSMAT_S – Speciation supplemental [A | M | P] SSUP l Major settings – SMK_SOURCE:[A | M | P] sets source category – POLLUTANT_CONVERSION: Y = use GSCNV file – REPORT_DEFAULTS:N = does not report when default profile is used – SMK_GSREF_FIXED:Y = use fixed-format speciation cross-reference file

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 10 Cntlmat (1) l Creates area, mobile, or point source projection, multiplicative control, additive control, or reactivity control matrices l Inputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – Control packets file GCNTL – Speciation profiles GSPRO

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 11 Cntlmat (2) l Outputs – Projection matrix APMAT | MPMAT | PPMAT – Mole reactivity matrix ARMAT_L | MRMAT_L | PRMAT_L – Mass reactivity matrix ARMAT_S | MRMAT_S | PRMAT_S – Reactivty supplemental ARSUP | MRSUP | PRSUP – Multiplicative control matrix ACMAT | MCMAT | PCMAT – Additive control matrix (future) AAMAT | MAMAT | PAMAT – Report ACREP | MCREP | PCREP

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 12 Cntlmat (3) l Major settings – SMK_SOURCE:[ A | M | P ] sets source category – REACTIVITY_POL:[ VOC ] sets pollutant name for reactivity controls – REPORT_DEFAULTS:N = does not report when default profile is used

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 13 Premobl (1) l Determines minimum/maximum temperatures per day for mobile sources and emission factors l Inputs – SMOKE I/O API inventory file MOBL – SMOKE ASCII inventory file MSRC – Emission factor cross-reference MPLIST – Ungridding matrix MUMAT – Temperature data MET_CRO_2D | MET_CRO_3D – Mobile codes MCODES – Country/state/county (daylight time exemptions) COSTCY

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 14 Premobl (2) l Outputs – Min/max temperature per PSI MEFTEMP – Min/max temperature per source and day MINMAXT l Major settings – SMK_SOURCE:[ A | M | P ] sets source category – SMK_MAXT_MAX:max allowed max daily temperature – SMK_MAXT_MIN:min allowed max daily temperature – SMK_MINT_MAX:max allowed min daily temperature – SMK_MINT_MIN:min allowed min daily temperature – TVARNAME:name of the temperature variable

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 15 Emisfac (1) l Creates the mobile emission factors by running MOBILE5b for the scenario of interest l Inputs – Emission factor cross-reference MPLIST – Emission factor model inputs MPREF – Min/max temperature per PSI MEFTEMP – PSI list to force update MEFUPD – Mobile codes MCODES – Input diurnal emission factors MEFSD_IN – Input non-diurnal emission factors MEFSND_IN

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 16 Emisfac (2) l Outputs – Diurnal emission factors table MEFSD – Non-diurnal emission factors table MEFSND l Major settings – EF_FORCE_UPDATE:Y = use MEFUPD file – EF_YEAR:year for computing emission factors – MB_HC_TYPE:hydrocarbon type to output from MOBILE5b – REUSE_DIURNAL:Input MEFSD_IN file for updating – REUSE_NONDIURNAL:Input MEFSND_IN file for updating

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 17 Elevpoint (1) l Identifies elevated point sources for special processing l Inputs – SMOKE I/O API inventory file PNTS – SMOKE ASCII inventory file PSRC – Grid description file G_GRIDPATH – Stack split group file PGROUP – Stack splits file PSPLIT l Outputs – Elevated point source identification file PELV – PinG CMAQ/MAQSIP stack parameters file STACK_GROUPS

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 18 Elevpoint (2) l Major settings – SMK_CUTOFF_HT:cutoff height for UAM-style processing – SMK_ENG2METRIC_YN: Y = convert units in PGROUP file from English to metric units – SMK_PING_YN:Y = creates STACK_GROUPS file – SMK_SPECELEV_YN:Y = use the major/minor indicator in the PSPLIT file – WEST_HSPHERE:N = do not convert coordinates

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 19 Temporal (1) l Temporally allocates area, mobile, or point source emissions, or compute hourly mobile emissions. l Inputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – SMOKE day-specific file PDAY – SMOKE hour-specific file PHOUR – Temporal profiles [A|M|P]TPRO – Temporal cross-reference [A|M|P]TREF – Diurnal emission factors table MEFSD – Non-diurnal emission factors table MEFSND – Temperature data MET_CRO_2D | MET_CRO_3D

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 20 Temporal (2) l Inputs (continued) – Min/max temperature per source and day MINMAXT – Emission factor cross-reference MPLIST – Ungridding matrix MUMAT – Mobile codes MCODES – Mobile emission processes MEPROC – Country/state/county (daylight time exemptions) COSTCY – Holiday reassignmentHOLIDAYS l Outputs – Hourly emissions file [A|M|P]TMP

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 21 Temporal (3) l Major settings – SMK_SOURCE:[A | M | P] sets source category – G_STDATE:Julian start date (YYYYDDD) – G_STTIME:start time output time zone (HHMMSS) – G_RUNLEN:episode duration (HHMMSS) – OUTZONE:output time zone – DAY_SPECIFIC_YN: Y = import day-specific data – HOUR_SPECIFIC_YN:Y = import hour-specific data – RENORM_TPROF:N = do not renormalize temporal profiles – REPORT_DEFAULTS:N = does not report when default profile is used

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 22 Temporal (4) l Major settings (continued) – SMK_O3SEASON_YN:Y = use ozone season emissions instead of annual average – ZONE4WM:N = do not use time zone for applying weekly and monthly profiles

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 23 Tmpbio (1) l Computes the hourly, gridded, speciated biogenic emissions for a given speciation mechanism based on BEIS2 computations l Inputs – Gridded, normalized emissions BGRD – Speciation profiles GSPRO – 2-d grid information file GRID_CRO_2D – Temperature and solar radiation data MET_FILE1 – Solar radiation file (if not MET_FILE1) MET_FILE2

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 24 Tmpbio (2) l Outputs – Gridded, speciated, hourly molar emissions BGTS_L – Gridded, speciated, hourly mass emissions BGTS_S l Major settings – BG_CLOUD_TYPE:specifies method for computing photosynthetically active radiation (PAR) – TMPR_VAR:name of the temperature variable – BIOMET_SAME:Y = take temperature and solar radiation data from the same file – RAD_VAR:name of radiation or cloud data variable – BIOG_SPRO:speciation profile number to use – OUTZONE:output time zone

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 25 Laypoint (1) l Computes the plume rise fractions for point sources l Inputs – SMOKE I/O API inventory file PNTS – SMOKE ASCII inventory file PSRC – Elevated point source identification file PELV – 2-d cross-point grid information GRID_CRO_2D – 2-d cross-point meteorology data MET_CRO_2D – 3-d cross-point meteorology data MET_CRO_3D – 3-d dot-point meteorology data (winds) MET_DOT_3D

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 26 Laypoint (2) l Outputs – Layer fractions file PLAY l Major settings – REP_LAYER_MAX:layer number for reporting high plumes – SMK_EMLAYS:number of emission layers – SMK_SPECELEV_YN:Y = use PELV file to determine which sources get plume rise

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 27 Smkmerge (1) l Merges SMOKE files in many combinations to produce gridded emission files and state/county emission total reports l Inputs – SMOKE I/O API inventory file AREA, MOBL, PNTS – SMOKE ASCII inventory file ASRC, MSRC, PSRC – Hourly emissions file [A,M,P]TMP – Hourly, gridded, speciated, biogenic BGTS_L | BGTS_S – Gridding matrix [A,M,P]GMAT – Speciation matrix [A,M,P]SMAT – Layer fractions file PLAY – Grid description file G_GRIDPATH

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 28 Smkmerge (2) l Inputs (continued) – Multiplicative control matrix [A,M,P]XMAT – Additive control matrix [A,M,P]AMAT – Reactivity control matrix [A,M,P]RMAT – Country, state, and county names COSTCY – Valid activities ACTVNAMS – Valid pollutants SIPOLS – Elevated point source identification file PELV – Area gridding surrogate file AGPRO

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 29 Smkmerge (3) l Outputs – Gridded emissions data [A|M|P|E] [G] [T] [S] [3D] [ _S| _L] – Plume-in-grid emissions PINGT [S_S|S_L] – State/county report REP[A|B|M|P|E] [G] [T] [S_S|S_L] l Major settings – MRG_SOURCE:[A] [B] [M] [P] indicates which source categories to include in merge – MRG_SPCMAT_YN:Y = merge speciation matrices – MRG_TEMPORAL_YN:Y = use hourly emissions – MRG_LAYERS_YN:Y = merge with layer fractions and output 3-d file – SMK_O3SEASON_YN:Y = use ozone season emissions instead of annual average

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 30 Smkmerge (4) l Major settings (continued) – MRG_GRDOUT_YN:Y = output gridded file – MRG_REPSTA_YN:Y = output state reports – MRG_REPCNY_YN:Y = output county reports – MRG_GRDOUT_UNIT:units for gridded output – MRG_TOTOUT_UNIT: units for report emission totals – AREA_SURROGATE_NUM:surrogate code for area surrogate – SMK_ELEVPT_YN: Y = create UAM-style elevated point source file – SMK_PING_YN:Y = creates PinG output file – MRG_METCHK_YN:Y = compare meteorology scenario name across all input files

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 31 Smkmerge (5) l Major settings (continued) – MRG_CTLMAT_ADD:[A] [M] [P] merge additive controls – MRG_CTLMAT_MULT:[A] [P] merge mult. controls – MRG_CTLMAT_REAC:[A] [M] [P] merge reactivity controls – SMK_REPORT_TIME:daily simulation time for output of daily total emissions (HHMMSS)

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 32 Grwinven l Grows an inventory file using projection and control matrices l Inputs – SMOKE I/O API inventory file AREA | MOBL | PNTS – SMOKE ASCII inventory file ASRC | MSRC | PSRC – Projection matrix [A|M|P]PMAT l Outputs – SMOKE I/O API inventory file AREA_O | MOBL_O | PNTS_O – IDA ASCII inventory file ARINV_O | MBINV_O | PTINV_O l Major settings – SMK_NUM_CTLMAT: number of control and/or projection matrices – SMK_OUTPUTIDA_YN:Y = also output IDA format

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 33 Mrggrid l Merges gridded emission files together l Inputs – List of logical names of 2-d files NLST2D – 3-d inputs emissions file LGTS l Outputs – 3-d output emissions file EMIS3D

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 34 SMOKE Scripts l Script structure l Main scripts – Area – Biogenic – Mobile – Point – All merge script

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 35 Script Structure l Define Assigns file name l Settings for which source categories to process l Program on/off switches l Program-specific settings l Multiple-program settings l Invoke Assigns file l Redefine environment variables from default l Call “smk_run.scr” script

_____________________________________________________________SMOKE Programs and Options North Carolina Supercomputing Center__________________________Environmental Programs 36 Main Scripts (See Attached) l Smkinven (SMOKE inventory A, B, P) l Monthly (SMOKE inventtory M, and temporalizeation A) l Daily (SMOKE temporalization B, M, P and merging A, B, M, P, and all) l SMOKE run (smk_run_scr)