hydromt_wflow.WflowSedimentModel.setup_lulcmaps#

WflowSedimentModel.setup_lulcmaps(lulc_fn: str | Path | DataArray, lulc_mapping_fn: str | Path | DataFrame = None, planted_forest_fn: str | Path | GeoDataFrame = None, lulc_vars: List = ['landuse', 'Kext', 'PathFrac', 'Sl', 'Swood', 'USLE_C'], planted_forest_c: float = 0.0881, orchard_name: str = 'Orchard', orchard_c: float = 0.2188)[source]#

Derive several wflow maps based on landuse-landcover (LULC) data.

Currently, lulc_fn can be set to the “vito”, “globcover”, “corine” or “glmnco”, of which lookup tables are constructed to convert lulc classses to model parameters based on literature. The data is remapped at its original resolution and then resampled to the model resolution using the average value, unless noted differently.

The USLE C factor map can be refined for planted forests using the planted forest data source. The planted forest data source is a polygon layer with planted forest polygons and optionnally a column with the forest type to identify orchards. The default value for orchards is 0.2188, the default value for other planted forests is 0.0881.

Adds model layers:

  • landuse map: Landuse class [-]

    Original source dependent LULC class, resampled using nearest neighbour.

  • Kext map: Extinction coefficient in the canopy gap fraction equation [-]

  • Sl map: Specific leaf storage [mm]

  • Swood map: Fraction of wood in the vegetation/plant [-]

  • USLE_C map: Cover management factor from the USLE equation [-]

  • PathFrac map: The fraction of compacted or urban area per grid cell [-]

Parameters:

  • lulc_fn ({"globcover", "vito", "corine"}) – Name of data source in data_sources.yml file.

  • lulc_mapping_fn (str) – Path to a mapping csv file from landuse in source name to parameter values in lulc_vars.

  • planted_forest_fn (str, Path, gpd.GeoDataFrame) –

    GeoDataFrame source with polygons of planted forests.

    • Optional variable: [“forest_type”]

  • lulc_vars (dict) – Dictionary of landuse parameters in lulc_mapping_fn columns to prepare and their internal wflow name (or None to skip adding to the toml). By default: {“landuse”: None, “Kext”: “input.vertical.kext”, “PathFrac”: “input.vertical.pathfrac”, “Sl”: “input.vertical.specific_leaf”, “Swood”: “input.vertical.storage_wood”, “USLE_C”: “input.vertical.usleC”}

  • planted_forest_c (float, optional) – Value of USLE C factor for planted forest, by default 0.0881.

  • orchard_name (str, optional) – Name of orchard landuse class in the “forest_type” column of planted_forest_fn, by default “Orchard”.

  • orchard_c (float, optional) – Value of USLE C factor for orchards, by default 0.2188.