Community Modeling and Analysis System

Surrogate Tools DB

Create spatial surrogates for mapping emissions sources to modeling domains

Surrogate Tools DB is a set of tools for creating spatial surrogates used in emissions modeling. The tools include functions for merging and gapfilling of surrogates, and managing the entire process. Surrogate Tools DB is written in Java and uses a database (Postgres) for spatial data handling.

Updates in v1.3

  • Fixed incorrect surrogate fractions in edge grid cells when the grid doesn't fully cover all the counties in the modeling domain
  • Updated oil and gas surrogates in the 2017/2016v2 configuration files

Updates in v1.2

  • Updated 2017/2016v2 configuration files to generate public schools surrogate

Updates in v1.1

  • Fixed issues with precision in the output surrogate files that caused problems reading the files in SMOKE
  • Added configuration files for EPA's 2017/2016v2 emissions modeling platform
  • Renamed configuration files for EPA's 2016v1 modeling platform

History of Surrogate Tools DB

  • Surrogate Tools DB v1.0 (11/30/2020) - Initial standalone release
  • Surrogate Tools DB v1.1 (11/10/2021)
  • Surrogate Tools DB v1.2 (11/17/2021)
  • Surrogate Tools DB v1.3 (05/05/2022)

Surrogate Tools DB began as a modification of the surrogate tools included in the Spatial Allocator. Spatial processing originally handled in C code was transitioned to use a spatially-aware database. The standalone Surrogate Tools DB package does not rely on the Spatial Allocator.

Latest Version: Surrogate Tools DB v1.3



System Requirements

O/S Linux
Software Java, Postgres + PostGIS