Roughness Instructions - rosepearson/GeoFabrics GitHub Wiki

These options control behaviour of the roughness length estimation stage and are all grouped under the roughness key-value.

The roughness sub-section can be used to specify advanced settings for the roughness length estimation stage.

• parameters [Optional, dict] - The parameters applied to the roughness length equation of max(parameter['mean'] * mean, parameter['std'] * std).

• default_values [Optional, dict] - Default values are: {"land": 0.014, "ocean": 0.004, "waterways": 0.004, "rivers": 0.004, "minimum": 0.00001, "maximum": 0.5, "paved": 0.001, "unpaved": 0.011}. If waterways, minimum or maximum are set to null/NaN then the relevant roughness values are left unchanged. This is applied as the final step so it will overwrite any LiDAR, road or landuse derived values. Set to null if you do not want to overwrite.

• roads [Optional, dict] - Default values are: {"source": "osm", "ignore": ["pedestrian", "footway", "footpath", "track", "path", "cycleway"], "widths": {"default": 8, "residential": 8, "tertiary": 12, "secondary": 12, "motorway": 12}}. Currently "osm" is the only supported source. The specification of an empty roads dictionary {} will lead no roads to be added.

• landuse [Optional dict] - Default values are: {"drop_offshore": True}. Currently only supported if the "source" is specified and is "lris". This must also be specified either in the file paths or as a vector dataset (preferred). Land used mapping is applied after any LiDAR derived values are extracted. The "landcover" values in the dictionary gives the name of the landcover column in the landcover file. The "classes_to_roughness" dictionary gives the mapping from landcovers to roughness values. If a landcover is not included in this dictionary then it is ignored.