Community Modeling and Analysis System



SMOKE version 4.0 Release Notes

Supports EDGAR Gridded Inventories

  • Processes the global gridded inventories, such as the Emissions Database for Global Atmospheric Research (EDGAR) inventories
  • GRIDMASK input file that contains an assigned 5-digit country codes and time zones for each grid cell. This is required to process the NetCDF formatted inventory files. With this GRIDMASK approach, user will be able to apply a different time zone as well as control factors by country level. The pre-generated GRIDMASK input file for the EDGAR inventory (for an example year) will be provided as a part of the SMOKE v4.0 package.
  • Added the sample case of EDGAR gridded inventory processing in the SMOKE v4.0 release package.
  • Check out the SMOKE user's guide (Chapter Pre-Gridded Inventory Processing) for the detail information.

New Geographical Code (GEOCODE_LEVEL) Approach

  • It is the new alternative method to replace COSTCY (traditional 6-digit FIPS code). As of SMOKE v4.0, traditional 6-digit integer FIPS will be treated as 12-characters.

Supports California Air Resource Board (CARB) expanded 20-characters SCC and SIC

  • As of SMOKE v4.0, SCC and SIC are internally treated as 20-characters.

Processes CARB's gridded daily/hourly MEDS (Modeling Emissions Data System) inventories

  • Download the Smoke2meds package - User can create MEDS formatted inventory files using the (python script) that allows users to convert Smkreport summary reports into MEDS inventory files. The smoke2meds package including sample input/output files, and script.

Smkreport update to generate CARB's Quality Assurance Data Extraction Format (QADEF) summary reports

  • Added a new command called "CARB_QADEF" to generate CARB's QADEF summary report in Smkreport

New postprocessing script for NONROAD model

Various updates to MOVES-SMOKE postprocessing scripts

Introducing the SMOKE wiki page

Please check out the latest information of NEI emissions modeling platform packages.

Latest IOAPI version 3.2 or later is required to compile the SMOKE version 4.0

Other minor updates and bug fixes

  • Temporal: Incorrect time zones shift bug fix for Eastern Hemispheric
  • Gentpro: Updated to support new csv-formatted temporal profiles (TPRO) and cross-reference input file (TREF)
  • Restructured the entire SMOKE source code directory: Merged EDSS_TOOl and FileSetAPI libraries into SMOKE main libraries.
  • Retired most of fixed formatted input files in SMOKE system (i.e., IDA, EMS-95, and so on)

This is the official SMOKE website hosted by the Center for Environmental Modeling for Policy Development (CEMPD) at the University of North Carolina at Chapel Hill. SMOKE is an active open-source development project supported and distributed by the CEMPD through the Community Modeling and Analysis System Center.

Upcoming Webinar

February 23, 2017. 2:00 PM (Eastern):

Latest SMOKE updates and more Join!

Presenter: B.H. Baek, UNC Institute for the Environment

In cooperation with the U.S. EPA and the California Air Resource Board (CARB), the UNC Institute for the Environment developed the Sparse Matrix Operator Kernel Emissions (SMOKE) system version 4.0. Major new features in SMOKE include: 1) Capabilities to process gridded global emission inventories to support global and hemispheric air quality modeling; 2) Support for CARB inventory data formats; and 3) various updates to support recent versions of the U.S. EPA's National Emission Inventory (NEI).

Dr. Baek is the chief software developer for SMOKE. He will present the new features in SMOKEv4.0, describe future directions for the software, and answer questions from the community about SMOKE.

SMOKE Training

Online SMOKE Training


Previous Documentation

System Requirements

O/S Linux
Processor 64-bit x86
Memory >2 Gb RAM
Disk Space > 40 Gb
Software I/O API, netCDF, Fortran ( Portland Group | Intel )

Online Resources


About the Developer

B.H. Baek

Dr. B.H. Baek took over lead SMOKE development in 2005. Prior to joining CEMPD he held positions at Colorado State and Texas A&M, where he conducted field monitoring compaigns studying livestock emissions. He earned is PhD from North Carolina State University in 2002 where he studied gas to particle conversions between ammonia, acid gases, and fine particles.

SMOKE-ready Data

SMOKE input data consist of emissions inventories, temporal and chemical speciation profiles, spatial surrogates, gridded meteorology and land use data, and other ancillary files for specifying the timing, location, and chemical nature of emissions. SMOKE is distributed with example data for getting started with the model. The example files distributed with SMOKE are for demonstration purposes only, they are not meant for real-world modeling applications.

The primary source for non-meteorology SMOKE input data is the U.S. EPA Clearinghouse for Inventories and Emissions Factors (CHIEF). The U.S. EPA Office of Air Quality Planning and Standards (OAQPS) Emissions Inventory and Analysis Group (EIAG) provides SMOKE inputs for different rule-making modeling platforms. These platforms include not only the NEI for both criteria air pollutants (CAPs) and hazardous air pollutants (HAPs), but also all of the SMOKE ancillary data files created by EPA for use in SMOKE. EPA uses CHIEF to provide these data.

Meteorology data must be generated for specific SMOKE applications using either MM5, WRF, or a similar model. The output data from meteorology models must be formatted for SMOKE using a program like MCIP.

Additional useful links for SMOKE input data are provide below.

SMOKE Data Type SMOKE Data Sources
North America
Ancillary Data
Temporal - CHIEF Temporal Data
Spatial - CHIEF Spatial Surrogates (US and Canada), BELD3 Land Use
Chemical - CHIEF Speciation Profiles
Projection - CHIEF Projection Data

History of SMOKE

The Sparse Matrix Operator Kernel Emissions (SMOKE) Modeling System was originally developed at MCNC to integrate emissions data processing with high-performance computing (HPC) sparse-matrix algorithms. SMOKE is now under active development at the Institute for the Environment and is partially supported by the Community Modeling and Analysis System (CMAS).

SMOKE is primarily an emissions processing system designed to create gridded, speciated, hourly emissions for input into a variety of air quality models such as CMAQ, REMSAD, CAMX and UAM. SMOKE supports area, biogenic, mobile (both onroad and nonroad), and point source emissions processing for criteria, particulate, and toxic pollutants. For biogenic emissions modeling, SMOKE uses the Biogenic Emission Inventory System, version 2.5 (BEIS2) and version 3.09 and 3.14 (BEIS3). SMOKE is also integrated with the on-road emissions model MOBILE6 and MOVES.

The sparse matrix approach used throughout SMOKE permits rapid and flexible processing of emissions data. Rapid processing is possible because SMOKE uses a series of matrix calculations rather than a less-efficient sequential approach used by previous systems. Flexible processing comes from splitting the processing steps of inventory growth, controls, chemical speciation, temporal allocation, and spatial allocation into independent steps whenever possible. The results from these steps are merged together in the final stage of processing using vector-matrix multiplication. This means that individual steps (such as adding a new control strategy, or processing for a different grid) can be performed and merged without having to redo all of the other processing steps.

SMOKE is written in Fortran 90 and is designed to run on a variety of UNIX platforms. We currently provide executables for Linux and the source code is available for download and can easily be compiled for your particular system. We do not support running SMOKE on Windows, due to the inherent limitations of that system. The current version of SMOKE is version 2.5, although versions 1.5 - 2.4 are still available for download.

The original SMOKE concept was envisioned in the early 1990's at MCNC by Dr. Carlie Coats, now of Baron Advanced Meteorology Services. Marc Houyoux managed the development of SMOKE until his departure to the U.S. EPA Office of Air Quality Planning and Standards in 2002. With active-development continuing at the CEMPD, lead SMOKE development was passed from Catherine Seppanen to Dr. B.H. Baek in 2005. While some SMOKE development is occurring outside of CEMPD, the primary line of development is managed by Dr. Baek under funding from the U.S. EPA.