hydromt_wflow.WflowSedimentModel.setup_lulcmaps_from_vector#

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

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

The vector lulc data is first rasterized to a raster map at the model resolution or at a higher resolution specified in lulc_res (recommended).

Lookup table lulc_mapping_fn columns are converted to lulc classes 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 optionally 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 (str, gpd.GeoDataFrame) –

    GeoDataFrame or name in data catalog / path to (vector) landuse map.

    • Required columns: ‘landuse’ [-]

  • lulc_mapping_fn (str, Path, pd.DataFrame) – Path to a mapping csv file from landuse in source name to parameter values in lulc_vars. If lulc_fn is one of {“globcover”, “vito”, “corine”, “esa_worldcover”, “glmnco”}, a default mapping is used and this argument becomes optional.

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

    GeoDataFrame source with polygons of planted forests.

    • Optional variable: [“forest_type”]

  • lulc_vars (dict) – List of landuse parameters to prepare. By default [“landuse”,”Kext”,”Sl”,”Swood”,”USLE_C”,”PathFrac”]

  • lulc_res (float, int, optional) – Resolution of the intermediate rasterized landuse map. The unit (meter or degree) depends on the CRS of lulc_fn (projected or not). By default None, which uses the model resolution.

  • all_touched (bool, optional) – If True, all pixels touched by the vector will be burned in the raster, by default False.

  • save_raster_lulc (bool, optional) – If True, the high resolution rasterized landuse map will be saved to maps/landuse_raster.tif, by default False.

  • 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.

See also

workflows.setup_lulcmaps_from_vector, workflows.add_planted_forest_to_landuse