Building a model#

This plugin allows to build a complete D-Emissions model from available data. Once the configuration and data libraries are set, you can build a model by using:

activate hydromt-delwaq
hydromt build demission path/to/built_model -i delmission_build.yml -d data_sources.yml -vv

The recommended region options for a proper implementation of this model are:

  • model

Alternatively, to start from a complete new region, you can start by first using HydroMT to build the linked hydrological/hydraulic model for your case and then build your D-Emissions model.

Warning

As of now, DELWAQ and D-Emissions models can only be built on top of existing Wflow models.

Configuration file#

Settings to build or update a D-Emissions model are managed in a configuration file. In this file, every option from each model methods can be changed by the user in its corresponding section.

Below is an example of build configuration yml file that can be used to build a EM model for modelling Total Nitrogen (TN) released by households.

global:
  data_libs:
    - local_sources.yml

steps:
  - setup_basemaps:
      region:
        wflow_sbm: wflow_piave
      maps:
        - rivmsk
        - lndslp
        - strord
        - soil_thickness
        - soil_theta_s

  - setup_monitoring:
      mon_areas: riverland

  - setup_hydrology_forcing:
      hydro_forcing_fn: wflow_output_em
      starttime: "2010-02-03 00:00:00"
      endtime: "2010-02-10 00:00:00"
      timestepsecs: 86400
      include_transport: true

  - setup_emission_raster:
      emission_fn: ghs_pop_2015
      scale_method: average
      fillna_method: zero
      area_division: True

Selecting data#

Data sources in HydroMT are provided in one of several yaml libraries. These libraries contain required information on the different data sources so that HydroMT can process them for the different models. There are three ways for the user to select which data libraries to use:

  • If no yaml file is selected, HydroMT will use the data stored in the hydromt-artifacts which contains an extract of global data for a small region around the Piave river in Northern Italy.

  • Another options for Deltares users is to select the deltares-data library (requires access to the Deltares P-drive). In the command lines examples below, this is done by adding –deltares-data to the build / update command line.

  • Finally, the user can prepare its own data catalog (or libraries) (see HydroMT documentation to check the guidelines). These user libraries can be added either in the command line using the -d option and path/to/yaml or in the ini file with the data_libs option in the [global] sections.