The emission mapper (E-MAP) is an emission preprocessor for different Air Quality Models (OPS, BelEUROS, Chimere and AURORA).

Run these commands in the project root. Requires: a C++20 compliant compiler Build all the required dependencies:
just bootstrap
Build emap:
just build

The binary can now be found in project_root/build/emap-release-x64-linux-dist/

The emap model is a command line tool that supports the following arguments

emapcli [-?|-h|--help] [-l|--log] [--log-level <number>] [--no-progress] [--concurrency <number>] [-d|--debug] -c|--config <path>

OPTIONS, ARGUMENTS:
  -?, -h, --help
  -l, --log               Print logging on the console
  --log-level <number>    Log level when logging is enabled [1 (debug) - 5 (critical)] (default=2)
  --no-progress           Suppress progress info on the console
  --concurrency <number>  Number of cores to use
  -d, --debug             Dumps internal grid usages
  -c, --config <path>     The e-map run configuration

The model run details are configured in the specfied config file

The config file is expected to be in the toml format (https://github.com/toml-lang/toml)

Example

[model]
grid = "vlops1km"
datapath = "./_input"
year = 2020
report_year = 2022
spatial_pattern_exceptions = "./_input/03_spatial_disaggregation/exceptions.xlsx"
included_pollutants = ["PM2.5", "PM10"]


[output]
path = "./_output_gnfr"
filename_suffix = "_test"
sector_level = "GNFR"
create_country_rasters = false
create_grid_rasters = true

[options]
validation = true

This section configures the model run

• grid the output grid of the model

  possible values:

  • "vlops1km"
  • "vlops250m"
  • "chimere_05deg"
  • "chimere_01deg"
  • "chimere_005deg_large"
  • "chimere_005deg_small"
  • "chimere_0025deg"
  • "chimere_emep_01deg"
  • "chimere_cams_01-005deg"
  • "chimere_rio1"
  • "chimere_rio4"
  • "chimere_rio32"

• datapath the directory path to the model input data

• year the year to run the model for

• report_year the report year of the emission data of the model run

• spatial_pattern_exceptions path to an xlsx file in which exceptions for spatial patterns are configured. These exceptions overrule the standard rules for spatial patterns.

• emission_scaling_factors path to an xslx file in which scaling factors are configured for the emissions

• included_pollutants List of pollutants to include in the model run, this setting is optional, if it is not present all the configured pollutants will be included in the run.

• scenario First search for emission input files with the _scenario suffix before using the default emission input files, allows easy creation of scenarios with modified input files.
  For point sources emap_{scenario}_{pollutant}_{year}_*.csv is checked before emap_{pollutant}_{year}_*.csv
  For totals nfr_allyears_{reportYear}_extra_{scenario}.txt is checked before nfr_allyears_{reportYear}_extra.txt and nfr_{year}_{reportYear}_{scenario}.txt is checked before nfr_{year}_{reportYear}.txt

• point_source_rescale_threshold The threshold for allowing automatic rescaling of point sources when they exceed the reported total emissions [0 - 100]

• combine_identical_point_sources combine the emission of the point sources with the same location and properties. The emissions will be summed and only one entry will be present in the output file. (default=true)

• spatial_boundaries_filename The filename of the spatial boundaries vector to use in the 03_spatial_disaggregation/boundaries input directory (default = "boundaries.gpkg")

• spatial_boundaries_eez_filename The filename of the spatial boundaries vector including eez zones to use in the 03_spatial_disaggregation/boundaries input directory (default = "boundaries_incl_EEZ.gpkg")

This section configures the output of the model

• path directory path where the created output files will be stored

• filename_suffix suffix to add to filename of the created files in the output directory

• sector_level the level in which the output will be aggregated

  possible values:

  • "NFR"
  • "GNFR"
  • "SNAP"

• create_country_rasters set this option to true to generate geotiffs containing the emissions for the individual countries for each pollutant and each sector

• create_grid_rasters set this option to true to generate geotiffs for the configured grid for each pollutant and each sector

• separate_point_sources configure wheter point sources should be output separately for chimere grids (default = true)

Additional options

• validation when this option is true an additional verification step is done when the model has completed that will compare the input emissions against the output emissions after they have been spread over the grid. The run summary will contain an additional tab with the details.