sparse matrix operator kernel emissions smoke training community modeling and analysis system center...

Sparse Matrix Operator Kernel EmissionsSparse Matrix Operator Kernel Emissions

SMOKE SMOKE TrainingTraining

Community Modeling and Analysis System CenterInstitute for the Environment

University of North Carolina at Chapel Hill

©2011 Institute for the Environment 1

CMASCMASCommunity Modeling and Analysis SystemCommunity Modeling and Analysis System

http://www.cmascenter.orghttp://www.cmascenter.org

What does CMAS do?What does CMAS do?• Working to coordinate

community approach to emissions and air quality modeling

• Software distribution and support

• Training and conferences• Outreach• Development• Communication• CMAQ, MCIP, SMOKE, I/O API,

PAVE, MIMS

January 2011 SMOKE/CMAQ Training

Konkuk University Seoul, Korea 2

SMOKESMOKESparse Matrix Operator Kernel EmissionsSparse Matrix Operator Kernel Emissions

http://www.smoke-model.orghttp://www.smoke-model.org

Features:Features:• Open-source, highly optimized• Criteria and toxics pollutants• Supports CMAQ, CAMx,

MAQSIP, REMSAD, UAM• Annual, daily, hourly

inventories• MOBILE6 and BEIS3• Fire plume rise algorithms• Flexible QA/QC features• Large user community• Active training program

3

Training OverviewTraining Overview• Emissions processing

basics• SMOKE basics• Running SMOKE• Overview lab• SMOKE programs• SMOKE problem

solving

• Area sources lab• Biogenics lab• Point sources lab• Pregridded sources lab• Merge lab• Quality assurance lab


Overall GoalOverall Goal• Emissions

inventoryo Usually annual data (i.e. tons/yr)o Reported by source

(may be county or coordinate)

o By inventory pollutant (CO, NOx, VOC,,,)

• Air quality model inputo Hourlyo Griddedo By model specieso May be 3-D file (layered)


Source CategoriesSource Categories• Point source characteristics

o Country, state, and county (FIPS)o Latitude and longitudeo Plant, point, stack, segment, and source

category code (SCC)o Ex: power plants, furniture refinishers

• Area source characteristicso Country, state, and countyo Source category code (SCC)o Ex: residential heating, lawnmowers,

vehicular road dust (unpaved road),airports.


Source CategoriesSource Categories• Mobile (on-road) source characteristics

o Country, state, and countyo Road type (e.g. rural interstate, urban local)o Vehicle type (e.g. light/heavy duty gasoline

vehicles)o Optional link coordinates ( road segment within a

county)o Ex: gasoline and diesel vehicles on freeways

• Biogenic source characteristicso Gridded land useo Ex: crops, corn, soybean, conifer forests, wetlands


DefinitionsDefinitions• Inventory pollutant: A compound or

group of compounds defined for record-keeping and regulatory purposes (e.g. CO, NOx, VOC, PM10, PM2.5)

• Species: A compound or group of compounds defined as part of the estimation of air chemistry in an air quality model (AQM) (e.g. CO, NO, NO2, PAR, TOL, OLE)


DefinitionsDefinitions

• Speciation: Convert the inventory pollutant data to the species needed by the AQM (e.g. VOC gets split into PAR, OLE, XYL, TOL, ISOP, and more)

• Chemical mechanism: A parameterized representation of coupled chemical reactions (e.g. CB4, RADM2, SAPRAC99, CB05)


DefinitionsDefinitions• Map projection: The mathematical 2-d

representation of the spherical surface of the Earth (Emission and Air Quality Models shares)

• Model grid: A 2-d region based on a map projection; defined by starting coordinates, number of columns and rows, and the physical size of the grid cells


Model Grid DefinitionModel Grid Definition


Model Grid ExamplesModel Grid Examples


DefinitionsDefinitions• Spatial allocation: Convert the source

spatial extent to the grid cell resolution needed by the air quality model

• Gridding surrogates: A dataset used to spatially allocate the emissions to the grid cells; developed from data at a finer resolution than the emissions (e.g. population, housing, airports, roads)


DefinitionsDefinitions• Model layers: Vertical spatial divisions

of the atmosphere defined by an air quality model; used to model variations in the atmosphere at different vertical positions

• Plume rise: The rising of exhaust from point sources due to the velocity and temperature of the exhaust gases


DefinitionsDefinitions

• Elevated source: A point source in which emissions extend beyond the first model layer due to plume rise

• Plume-in-grid (PinG): A special treatment of elevated sources in which the plume rise is modeled with extra detail by the AQM


DefinitionsDefinitions• Temporal allocation: Convert the

annual or daily inventory data to the hourly data needed by the AQM

• Profile data: Factors used for converting inventory emissions data to AQM data

• Cross-reference: A dataset used to match sources in the inventory with profile data


Cross-reference Cross-reference ExampleExample

State

County

ID

NCDurha

m14

NCOrang

e14

NC Wake 15

SC all 17

IDFactor

1Factor

2

13 1.2 10.4

14 1.4 12.7

15 1.7 18.3

16 1.6 15.2

17 1.1 9.8

X-ref table Profiles table


Area EmissionsArea EmissionsProcessingProcessing

• Import data• Spatial allocation• Speciation• Temporal allocation• Growth (to a future or past year) and

controls• Merge


Point EmissionsPoint EmissionsProcessingProcessing

• Import, speciation, temporal allocation, growth/controls, plus…

• No surrogates needed for spatial allocation

• May have day- and hour-specific emissions

• Determine elevated and PinG sources• Special processing for elevated and

PinG sources• Merge


Biogenic EmissionsBiogenic EmissionsProcessingProcessing

• MEGAN emissions model• Global gridded land cover, emissions

factors, and plant functional types• Compute hourly biogenic photochemical

and secondary organic aerosol precursors

• Adjust estimates using simulated temperature and solar radiation


MergingMerging• Combine independent import, gridding,

speciation, temporal allocation, and other steps for a single sourcse category to create model-ready files

• Combine multiple source categories into a single data set, called model-ready output for the AQM

• Output correct units, species, time steps, grid, and file format for the AQM


Quality AssuranceQuality Assurance• Compare emission totals from

emissions processor with inventory totals (by state, county, SCC, etc.)

• Compare emission totals after each stage of processing

• Ensure that input file formats are correct

• Ensure that no errors occurred during processing

• Compare emissions between states and counties


SMOKE BasicsSMOKE Basics

• Programs• Data flow• Shared program details• Capabilities• Benefits


Emissions Processing Emissions Processing

ParadigmsParadigms


SMOKE Program

s


SMOKE Data FlowSMOKE Data Flow


CapabilitiesCapabilitiesData Import Data Import

• Formatso EMS-95: area, mobile, point, and day- and hour-

specific pointo IDA and ORL (toxics): area, mobile, and pointo CEM format : hour-specific pointo Pregridded inventories in netCDF formato Gridded land use

• User-defined inventory pollutantso Photochemical precursors, PM, air toxics defined

by default; new pollutants can be added as neededo No limit on number of pollutants


CapabilitiesCapabilitiesSpatial AllocationSpatial Allocation

• Convert inventory spatial distribution to 3-d modeling grid

• Input coordinates: Lat-Lon or Universal Transverse Mercator (UTM)

• Output projections: Lat-Lon, Lambert, equatorial mercator, polar stereographic

• No limit on number and size of grid cells• Area: use gridding surrogates or assign lat-lon

coordinates• Mobile: apply gridding surrogates• Point: assign point source locations to grid

cells


CapabilitiesCapabilitiesChemical SpeciationChemical Speciation

• Convert inventory VOC and PM pollutants to species required by air quality models

• User-defined species, unlimited number• CB05 and SAPRC-99 mechanisms are

readily available; other mechanism speciation can be developed by users

• Handles both mole-based and mass-based speciation


CapabilitiesCapabilitiesTemporal AllocationTemporal Allocation

• Convert inventory temporal coverage to hourly estimates

• Supports monthly, weekly, and hourly profileso Allows different hourly profiles for each day of the

week• Can use average-day or annual inventory data• Point sources can use day- and hour-specific

data• Biogenics based on meteorology data• Automatic accounting for holidays


CapabilitiesCapabilitiesGrowth and ControlsGrowth and Controls

• Uses year-specific growth factors to grow inventories to future or past years

• Several types of multiplicative and reactivity controls

• Location and source IDs for area and mobile

• Source-specific for Point• Pollutant-specific growth and controls


CapabilitiesCapabilitiesBiogenics ProcessingBiogenics Processing

• MEGAN can be run outside of SMOKE and configured to output SMOKE-formatted files

• Merge MEGAN data with anthropogenic emissions for input to AQMs

• Several chemical mechanisms (CB4, CB05, and SAPRC99) are readily available to convert VOC estimates from MEGAN to AQM species

• Support NO and VOC emission factors only


CapabilitiesCapabilitiesPoint Source ProcessingPoint Source Processing

• Annual, Day- and/or hour-specific data by pollutant

• Supports customized source definition based on different text inventory formats

• Selects elevated and PinG sources• Can import hourly data such as

Continuous Emissions Monitoring (CEM)


CapabilitiesCapabilitiesElevated Source OptionsElevated Source Options

• Two options for defining elevated sources1. Define characteristics of elevated sources

and allow AQMto computes plume rise2. Treat all sources as potentially elevated;

SMOKE computes plume rise

• Select PinG sources; SMOKE outputs special PinG file

• Allocate 2-d area sources to vertical layers using vertical profiles


Benefits of SMOKEBenefits of SMOKE• Faster processing than other systems (pre-

compiled Linux program)• Flexible processing paradigm for multiple grids,

control strategies, chemical mechanisms, etc.• Machine-independent binary file format (netCDF-

I/O API)• No grid or inventory size limits• No limit to number of pollutants or species• Processing for ozone, toxics, PM, wildfires,

offshore, lightening, and aircraft modeling• Open source codes for users• Output for CMAQ, MAQSIP, UAM-V, CAMx, UAM-

AERO, REMSAD, and AERMOD


SMOKE Libraries and SMOKE Libraries and UtilitiesUtilities

• Libraries: I/O API, NetCDF• Analysis/Postprocessing: I/O API

Tools• Ancillary data tools: Spatial

Allocator, Speciation Tool• Visualization: PAVE, VERDI, IDV

36©2011 Institute for the Environment

SMOKE Libraries and SMOKE Libraries and UtilitiesUtilities

• Library files provide an easy way for programs to share commonly used subroutines; three libraries used by CMAQ

• I/O API - an easy-to-learn, easy-to-use programming library for data storage and access, available for both Fortran and C

• netCDF - an interface for array-oriented data access and a library that provides an implementation of the interface


I/O API LibraryI/O API Library• The Input/Output Applications Programming

Interface contains an extensive set of utility routines for manipulating dates and times, performing coordinate conversions, storing and recalling grid definitions, sparse matrix arithmetic, etc., as well as a set of data-manipulation and statistical analysis programs

• Command line programs that are easy to script for automating analysis and post processing

• http://www.baronams.com/products/ioapi/• Examples of I/O API utilities


http://www.baronams.com/products/ioapi/

netCDF LibrarynetCDF Library• The Network Common Data Form is an interface

to a library of data access functions for storing and retrieving data in the form of arrays

• An abstraction that supports a view of data as a collection of self-describing, network-transparent objects that can be accessed through a simple interface

• By using direct file access, netCDF achieves the goal of supporting efficient access to small subsets of large datasets

• www.unidata.ucar.edu/packages/netcdf/


http://www.unidata.ucar.edu/packages/netcdf/

I/O API ToolsI/O API Tools• m3diff: for computing statistics for pairs of

variables and for applying various comparison ("differencing") operations to those variables in a pair of files

• m3edhdr: edit header attributes/file descriptive parameters

• m3merge: merges selected variables from a set of input files for a specified time period, and writes them to a single output file, with optional variable-renaming in the process

• vertot: compute vertical-column totals of variables in a file


The Surrogate ToolThe Surrogate Tool• Creates spatial surrogates from GIS Shapefile

attributes or functions of the attributes • Merges surrogates

o 0.75*Total Road Miles + 0.25*Population• Gapfills surrogates

• prevents dropping of emissions with up to four levels of coverage


Speciation ToolSpeciation Tool

• Generates chemical speciation profiles for emission models, including SMOKE

• Converts VOC and PM mass fractions to photochemical mechanism species

• Supports any defined chemical mechanism• Supports both VOC and PM species• Supports integrated and non-integrated

HAPS• Supports both active and tracer toxics


PAVEPAVE• Package for Analysis and Visualization of

Environmental data is a UNIX/Linux graphics tool for netCDF and UAM formatted data

• PAVE is a flexible and distributed application to visualize multivariate gridded environmental datasets

• Easily scriptable to automate plot generation• Creates 2-d tile plots, time series, 3-d mesh

plots, bar charts, scatter plots, and integrates observations into graphics

• http://www.cmascenter.org/html/models.html


http://www.cmascenter.org/html/models.html

44

VERDIVERDI

• Visualization Environment for Rich Data Interpretation is Java graphics tool for I/O API-netCDF formatted data

• VERDI was developed as a replacement for PAVE

• Easily scriptable to automate plot generation• Creates 2-d tile plots, time series, 3-d mesh

plots, bar charts, scatter plots, and integrates observations into graphics

• http://www.verdi-tool.org

©2011 Institute for the Environment

45

IDVIDV• Integrated Data Viewer is a Java graphics tool

that supports multiple data formats• IDV is a 3-d visualization tool• Scriptable to automate plot generation• In addition to standard output formats (gif, mpeg,

etc), also can output kmz files.• http://www.unidata.ucar.edu/software/idv/• Current version is IDV 2.7 update 1

©2011 Institute for the Environment

http://www.unidata.ucar.edu/software/idv/

Running SMOKERunning SMOKE• Assigns file• Files and directory names• Default directory structure• Case and episode settings• Script structure


Assigns FileAssigns File• Sets directory names and file names for

input and output files• Sets case-specific (global) settings like

grid, chemical mechanism, and episode dates

• Used when running scripts and when working directly with files

• Always “source your Assigns file”> cd $SMK_HOME/subsys/smoke/assigns> source ASSIGNS.nei96.cmaq.cb4p25.us36


Main DirectoriesMain DirectoriesSMKROOT: Main SMOKE system directory

– Assigns file– Run scripts– Program source code– Executables

($SMK_HOME)


Main DirectoriesMain DirectoriesSMKDAT: Main SMOKE data directory

– Inventories– Cross-reference and profile data– Intermediate and output files


Inventory DirectoriesInventory DirectoriesINVDIR: Main inventory directory

– ARDAT: Area source inventory data– BGDAT: Biogenics land use data– MBDAT: Mobile source inventory data– PTDAT: Point source inventory data ©2011 Institute for the Environment 50

Other Input Other Input DirectoriesDirectories

GE_DAT: General data directory

– Grid descriptions– Cross-reference and profile data– Other inputs (holidays, country/state/county names, stack parameters, SCC/SIC description names, etc.)


Other Input Other Input DirectoriesDirectories

MET_DAT: Meteorology data directory– Hourly, gridded meteorology data from MCIP


Intermediate Output Intermediate Output DirectoriesDirectories

INVOPD: Intermediate inventory directory– Output from Smkinven and Grwinven



SCENARIO: Time-dependent output directory– Output from Temporal and Laypoint



STATIC: Time-independent output directory– Output from Grdmat, Spcmat, Cntlmat, Elevpoint, Mbsetup, Premobl, and Emisfac


Model-Ready Output Model-Ready Output DirectoriesDirectories

A_OUT: Merged area output directoryB_OUT: Merged biogenic output directoryM_OUT: Merged mobile output directoryP_OUT: Merged point output directoryOUTPUT: Final merged output directory


Report DirectoriesReport DirectoriesREPSTAT: Time-independent reports directory

- Reports containing emissions that are not temporalized

REPSCEN: Time-dependent reports directory

- Reports containing temporalized emissions©2011 Institute for the Environment 57

OverallOverall Settings SettingsGRID: Grid name used in naming filesIOAPI_GRIDNAME_1: Grid name used in grid description fileSPC: Chemical speciation name

- cmaq.cb4p25- cmaq.saprc99pm- remsad7.cb4mpm


Episode SettingsEpisode SettingsEPI_STDATE: Episode start date (YYYYDDD)EPI_STTIME: Episode start time (HHMMSS)EPI_RUNLEN: Episode run length (HHHMMSS)EPI_NDAY: Number of days in the episode

G_STDATE: Start date for each output fileG_STTIME: Start time for each output fileG_RUNLEN: Length of each output fileESDATE: Start date used in file names


Basic SMOKE Script Basic SMOKE Script StructureStructure

• Set Assigns file name• Set source category• Select which programs to run• Program-specific settings• Multiple-program settings• Script settings• Assigns file override settings• Source the Assigns file• Run main SMOKE programs (smk_run.csh)• Run Smkreport (qa_run.csh)• Loop through days for time-dependent steps


Training DetailsTraining Details• Inventory

o 2005 West Asia and Europe inventory • Pollutants

o CO, NOx, VOC, SO2, NH3, PM10, PM2.5

• Domainso Arabian Gulf 36km and UAE 12km

• Periodo July 7, 2009


Training DomainsTraining DomainsWest Asia 36 and 12-km domains


SMOKE ProgramsSMOKE Programs• Smkinven• Grdmat• Spcmat• Cntlmat• Grwinven• Temporal• Layalloc

• Elevpoint• Laypoint• MEGAN• Smkmerge• Mrggrid• Mrgelev• Smk2emis• Smkreport


SMOKE Program

s


Area Source Processing


Smkinven Smkinven (1)(1)• Imports area, mobile, or point source

inventories• Inputs

Inventory file ARINV|MBINV|PTINV

Country/state/county codes COSTCY

Inventory table INVTABLE

Day-specific files(s) PTDAY

Hour-specific files(s) PTHOUR

Replacement stack parameters

PSTK

Area-to-point assignments ARTOPNT©2011 Institute for the Environment 67

Smkinven Smkinven (2)(2)

• Outputs

SMOKE inventory fileText file listing several files: area.ncf, asrc.txt, area_dat/<pollutant>.ncf

AREA|MOBL|PNTS

SMOKE day-specific file PDAY

SMOKE hour-specific file PHOUR

Inventory SCC list [A|M|P]SCC

Import report REPINVEN


Smkinven Smkinven (3)(3)

• 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

SMK_ARTOPNT_YN Y = assign coordinates to specified sources

SMKINVEN_FORMULA

“PMC=PM10-PM2_5” to compute coarse PM from PM10 and PM2.5

WEST_HSPHERE Y = convert stack coordinates to Western hemisphere


Grdmat Grdmat (1)(1)

• Creates area, mobile, or point source gridding matrix to assign inventory emissions to model grid cells.

• Inputs

SMOKE inventory file AREA|MOBL|PNTS

Gridding cross-reference [A|M]GREF

Gridding surrogates description file

SRGDESC

Grid description file GRIDDESC

Mobile codes MCODES


Grdmat Grdmat (2)(2)• Outputs

Gridding matrix [A|M|P]GMAT

Ungridding matrix MUMAT

Surrogate codes by source [A|M]GSUP

• Major settings


REPORT_DEFAULTS Y = reports when default profile is used

SMK_DEFAULT_SRGID

Default surrogate code to use when primary surrogate would cause zero emissions©2011 Institute for the Environment 71

Spcmat Spcmat (1)(1)

• Creates area, mobile, or point source speciation matrices for mass- and mole-based factors

• Inputs


Speciation profiles GSPRO

Speciation cross-reference GSREF

Pollutant conversion file GSCNV

Mobile codes MCODES

Mobile emission processes MEPROC

Inventory table INVTABLE©2011 Institute for the Environment 72

Spcmat Spcmat (2)(2)• Outputs

Mole speciation matrix [A|M|P]SMAT_L

Mass speciation matrix [A|M|P]SMAT_S

Speciation codes by source [A|M|P]SUP

• Major settings


REPORT_DEFAULTS Y = reports when default profile is used

POLLUTANT_CONVERSION

Y = use GSCNV file


Temporal Temporal (1)(1)

• Computes hourly area, mobile, or point source emissions

• Inputs


SMOKE day-specific file PDAY

SMOKE hour-specific file PHOUR

Temporal profiles [A|M|P]TPRO

Temporal cross-reference file [A|M|P]TREF



Temporal Temporal (2)(2)• Inputs (continued)


Holiday identification file HOLIDAYS

• Outputs

Hourly emissions file [A|M|P]TMP

Temporal profile codes by source

[A|M|P]TSUP


Temporal Temporal (3)(3)

• Major settings


G_STDATE Output file start date (YYYYDDD)

G_STTIME Output file start time (HHMMSS)

G_RUNLEN Output file duration (HHMMSS)

OUTZONE Output time zone

DAY_SPECIFIC_YN Y = use day-specific data

HOUR_SPECIFIC_YN

Y = use hour-specific data

REPORT_DEFAULTS

Y = report when default profile is used

SMK_AVEDAY_YN Y = use average-day emissions


Cntlmat Cntlmat (1)(1)

• Creates area, mobile, or point source growth and/or control matrices

• Inputs


Control packets file GCNTL

Speciation profiles (reactivity controls only)

GSPRO



• Outputs

Growth matrix [A|M|P]PMAT

Mole reactivity matrix [A|M|P]RMAT_L

Mass reactivity matrix [A|M|P]RMAT_S

Reactivity supplemental file

[A|M|P]RSUP

Multiplicative control matrix

[A|M|P]CMAT

/CONTROL/ packet report [A|M|P]CREP

/REACTIVITY/ packet report [A|M|P]REACREP

/PROJECTION/ packet report

[A|M|P]PROJREP

Summary report [A|M|P]CSUMREP©2011 Institute for the Environment 78


• Major settings


REPORT_DEFAULTS Y = report when default control is used


GrwinvenGrwinven• Grows an inventory using the growth and

control matrices from Cntlmat• Inputs


Growth and control matrices [A|M|P]CMAT[##]

• OutputsSMOKE inventory file

AREA_O|MOBL_O|PNTS_O

Text inventory file ARINV_O|MBINV_O|PTINV_O

• Major settingsSMK_NUM_CNTLMAT Number of matrices

SMK_OUTPUTIDA_YN Y = output raw IDA inventory


Smkmerge Smkmerge (1)(1)

• Merges any set of intermediate SMOKE files to create model-ready output files and/or state/county emission total reports

• Inputs

SMOKE inventory files AREA

Gridding matrices AGMAT

Hourly emissions ATMP

Speciation matrices ASMAT



• Inputs (continued)


Multiplicative control matrices ACMAT

Reactivity control matrices ARMAT





• Outputs

Emissions data [A]G[T][S][_S|_L]

State/county report REP[A]G[T][S][_S|_L]



• Major settings

MRG_SOURCE [A][B][M][P] indicates which source categories to merge

MRG_SPCMAT_YN Y = merge speciation matrices

MRG_TEMPORAL_YN

Y = merge hourly emissions

MRG_CTLMAT_MULT

[A][M][P] merge mult. controls

MRG_CTLMAT_REAC

[A][M][P] merge reac. controls

MRG_GRDOUT_YN Y = output gridded file

MRG_REPSTA_YN Y = output state total report

MRG_REPCNY_YN Y = output county total report


Smkmerge Smkmerge (5)(5)• Major settings (continued)

MRG_GRDOUT_UNIT Units for gridded output (_S/_L)

MRG_TOTOUT_UNIT Units for state/county totals

MRG_METCHK_YN Y = check the consistency of meteorology scenario name across multiple input files (mobile/biogenic/point)


Point Source Processing


Elevpoint Elevpoint (1)(1)

• Identifies elevated point sources by setting criteria of stack parameters

• Inputs

SMOKE inventory file PNTS


Elevated source selection file(Stack height, Diameter, Top 10 NOx emitter)

PELVCONFIG


Elevpoint Elevpoint (2)(2)• Outputs

Elevated sources identification file

PELV

PinG stack parameters file (CMAQ)

STACK_GROUPS• Major settings

SMK_PING_METHOD

0 = no PinG sources1 = use PELVCONFIG to select PinG sources

SMK_ELEV_METHOD

0 = treat all sources as elevated1 = use PELVCONFIG to select elevated sources2 = create INLN input file for CMAQ in-line plume rise


Laypoint Laypoint (1)(1)

• Calculates plume rise layer fractions for elevated point sources to distribute into modeling layers

• Inputs

SMOKE inventory file PNTS

SMOKE hour-specific file (stack parameters or plume rise) : fires only

PHOUR

Elevated source identification file PELV

Meteorology data files from MCIP GRID_CRO_2DMET_CRO_2DMET_CRO_3DMET_DOT_3D©2011 Institute for the Environment 89

Laypoint Laypoint (2)(2)

• OutputsLayer fractions file PLAY

Explicit layer fractions file (hourly specific non-traditional point only)

PLAY_EX

• Major settings

REP_LAYER_MAX Max Layer number to report higher plumes than the layer

SMK_EMLAYS Number of modeling emission layers interested in.

SMK_SPECELEV_YN Y = use PELV file

HOUR_PLUMEDATA_YN

Y = import plume rise data©2011 Institute for the Environment 90


• Merges any set of intermediate SMOKE files to create model-ready output files and/or state/county emission total reports

• Inputs

SMOKE inventory files PNTS

Gridding matrices PGMAT

Hourly emissions PTMP

Speciation matrices PSMAT

Layer fractions file PLAY|PLAY_EX





Multiplicative control matrices PCMAT

Reactivity control matrices PRMAT



Elevated source identification file

PELV



• Outputs

Emissions data [P]G[T][S][3D][_S|_L]

PinG emissions (CMAQ)

PING[T][S][_S|_L]

State/county report REP[P]G[T][S][_S|_L]

UAM-style elevated file

ELEV[T][S][_S|_L]



• Major settings

MRG_LAYERS_YN Y = merge layer fractions

SMK_ASCIIELEV_YN

Y = create UAM-style elevated point source file (UAM style)

SMK_PING_METHOD

0 = no PinG1 = create output PinG file


Biogenic Source Processing


MEGANMEGAN• TXT2NCF

o Converts gridded text (CSV) file of plant functional types (PFTs) and plant-based emissions factors to netCDF format

• MEGANo Computes hourly biogenic emissions by apply

meteorology (temp/pressure) into gridded normalized emissions

• MG2IOAPIo Applies speciation factors to convert MEGAN output

species to AQM pollutants.


MrggridMrggrid• Final step in preparation of air quality model emissions• Merges 2-d and 3-d model-ready emissions files (ex: Point + Area + Biogenic)• Inputs

List of logical file names to merge

FILELIST• Outputs

Output emissions file OUTFILE




Speciation matrix [A|M|P]SMAT

Speciation profile codes by source

[A|M|P]SSUP

Layer fractions file PLAY


Elevated source identification file

PELV



• Outputs

Any number of report files

REPORT1REPORT2REPORT3, etc.

• Major settings– Most options are controlled by the report

configuration file– More details are in the REPCONFIG

documentation in Chapter 7 of the user’s manual


SMOKE Problem SMOKE Problem SolvingSolving

• Examining log files• Common problems• Smkreport program• SMOKE support


Examining Log FilesExamining Log Files

• Every program outputs a log file• Check for normal completion of program• Fix any errors

o Check file formatso Confirm locations of fileso Internal errors are not usually fixable by the

user

• Check any warningso May not be a problem, but need to confirm


Common Problems Common Problems (1)(1)

• Problem: Program is reporting that an output file cannot be opened

• Solution:o Check that the directory listed in the log file

is valid and existso Delete the existing output file listed in the

log file and rerun; the I/O API library will not overwrite files with different header information than the new file



• Problem: Output file is not in the expected location after the program finishes

• Solution:o Check that the program completed

successfullyo Check the log file to find out the logical file

name of the output fileo Ensure that the logical file name is defined

in the Assigns file or scripts



• Problem: Program is ending because an input file is not available

• Solution:o Check the log file to find the name and

location of the input fileo Ensure that the logical file name is defined

in the Assigns file or scriptso Check that the directory and file name of

the input file is correcto If the input file is generated by another

program, make sure that program completed successfully


SmkreportSmkreport

• Can compare emissions at each stage of processing and with inventory totals

• Output files can be imported into spreadsheet programs for further analysis

• Supports the selection and grouping of inventory sourceso Report by source, inventory sector ID, source

characteristics, etc.


SMOKE SupportSMOKE Support

• User’s Manual• EPA CHIEF

(www.epa.gov/ttn/chief/index.html)• CMAS Help Desk (www.cmascenter.org) • Emissions modeling email list

([email protected])


sparse matrix operator kernel emissions smoke training community modeling and analysis system center...

Documents

tonsyr o

county o ex

model species o

county o road type

longitude o plant

county fips o latitude

environment4 slide

environment9 slide