hydromt_wflow.WflowModel.setup_lulcmaps#

WflowModel.setup_lulcmaps(lulc_fn: str | DataArray, lulc_mapping_fn: str | Path | DataFrame | None = None, lulc_vars: Dict = {'land_manning_n': 'land_surface_water_flow__manning_n_parameter', 'land_water_fraction': 'land~water-covered__area_fraction', 'landuse': None, 'soil_compacted_fraction': 'soil~compacted__area_fraction', 'vegetation_crop_factor': 'vegetation__crop_factor', 'vegetation_feddes_alpha_h1': 'vegetation_root__feddes_critial_pressure_head_h~1_reduction_coefficient', 'vegetation_feddes_h1': 'vegetation_root__feddes_critial_pressure_head_h~1', 'vegetation_feddes_h2': 'vegetation_root__feddes_critial_pressure_head_h~2', 'vegetation_feddes_h3_high': 'vegetation_root__feddes_critial_pressure_head_h~3~high', 'vegetation_feddes_h3_low': 'vegetation_root__feddes_critial_pressure_head_h~3~low', 'vegetation_feddes_h4': 'vegetation_root__feddes_critial_pressure_head_h~4', 'vegetation_kext': 'vegetation_canopy__light-extinction_coefficient', 'vegetation_leaf_storage': 'vegetation__specific-leaf_storage', 'vegetation_root_depth': 'vegetation_root__depth', 'vegetation_wood_storage': 'vegetation_wood_water__storage_capacity'}, output_names_suffix: str | None = None)[source]#

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

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.

Currently, if lulc_fn is set to the “vito”, “globcover”, “esa_worldcover” “corine” or “glmnco”, default lookup tables are available and will be used if lulc_mapping_fn is not provided.

Adds model layers:

  • landuse map:

    Landuse class [-]

  • vegetation_kext map:

    Extinction coefficient in the canopy gap fraction equation [-]

  • vegetation_leaf_storage map:

    Specific leaf storage [mm]

  • vegetation_wood_storage map:

    Fraction of wood in the vegetation/plant [-]

  • vegetation_root_depth map:

    Length of vegetation roots [mm]

  • soil_compacted_fraction map:

    The fraction of compacted or urban area per grid cell [-]

  • land_water_fraction map:

    The fraction of open water per grid cell [-]

  • land_manning_n map:

    Manning Roughness [-]

  • vegetation_crop_factor map:

    Crop coefficient [-]

  • vegetation_feddes_alpha_h1 map:

    Root water uptake reduction at soil water pressure head h1 (0 or 1) [-]

  • vegetation_feddes_h1 map:

    Soil water pressure head h1 at which root water uptake is reduced (Feddes) [cm]

  • vegetation_feddes_h2 map:

    Soil water pressure head h2 at which root water uptake is reduced (Feddes) [cm]

  • vegetation_feddes_h3_high map:

    Soil water pressure head h3 (high) at which root water uptake is reduced (Feddes) [cm]

  • vegetation_feddes_h3_low map:

    Soil water pressure head h3 (low) at which root water uptake is reduced (Feddes) [cm]

  • vegetation_feddes_h4 map:

    Soil water pressure head h4 at which root water uptake is reduced (Feddes) [cm]

Parameters:

  • lulc_fn (str, xarray.DataArray) – Name of RasterDataset source in data_sources.yml file.

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

  • lulc_vars (Dict) – Dictionnary of landuse parameters to prepare. The names are the the columns of the mapping file and the values are the corresponding Wflow.jl variables if any.

  • output_names_suffix (str, optional) – Suffix to be added to the output names to avoid having to rename all the columns of the mapping tables. For example if the suffix is “vito”, all variables in lulc_vars will be renamed to “landuse_vito”, “Kext_vito”, etc.