hydromt_wflow.WflowModel.setup_lulcmaps_from_vector#
- WflowModel.setup_lulcmaps_from_vector(lulc_fn: str | GeoDataFrame, 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'}, lulc_res: float | int | None = None, all_touched: bool = False, buffer: int = 1000, save_raster_lulc: bool = False, output_names_suffix: str | None = None)[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.
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, 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.
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.
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.
buffer (int, optional) – Buffer around the bounding box of the vector data to ensure that all landuse classes are included in the rasterized map, by default 1000.
save_raster_lulc (bool, optional) – If True, the (high) resolution rasterized landuse map will be saved to maps/landuse_raster.tif, by default False.
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.
See also