|
9 | 9 | #' @format ## `rabimo_inputs_2025` |
10 | 10 | #' A list containing two elements: |
11 | 11 | #' \describe{ |
12 | | -#' \item{data}{a data frame with the input data in r-abimo format ...(number of vars)} |
13 | | -#' \item{config}{a list object with configuration data} |
| 12 | +#' \item{data}{a data frame with the input data in R-Abimo format (see below)} |
| 13 | +#' \item{config}{a list object with configuration data (see below)} |
14 | 14 | #' } |
15 | 15 | #' @format ## `rabimo_inputs_2025$data` |
16 | | -#' A data.frame with 58531 observations of 25 variables: |
| 16 | +#' A data.frame with 58531 observations of 26 variables: |
17 | 17 | #' \describe{ |
18 | 18 | #' \item{`code`}{Unique block area identifier (character)} |
19 | 19 | #' \item{`prec_yr`}{Long-term average of annual precipitation in mm (integer)} |
20 | 20 | #' \item{`prec_s`}{Long-term average of annual precipitation within summer months (May to October) in mm (integer)} |
21 | 21 | #' \item{`epot_yr`}{Long-term average of annual potential evapotranspiration in mm (integer)} |
22 | 22 | #' \item{`epot_s`}{Long-term average of annual potential evapotranspiration within summer months (May to October) in mm (integer)} |
23 | | -#' \item{`district`}{Number of Berlin "Bezirk" (district) in which the block area is located (character)} |
| 23 | +#' \item{`district`}{Number of Berlin "Bezirk" (district) in which the block area is located (character). This column is Berlin-specific and optional, i.e. not required by the model.} |
24 | 24 | #' \item{`total_area`}{Total block area in square metres (numeric)} |
25 | 25 | #' \item{`roof`}{Fraction of the total area that is considered as "roof" area (numeric value between 0.0 and 1.0)} |
26 | 26 | #' \item{`green_roof`}{Fraction of the roof area that belongs to green roofs (numeric value between 0.0 and 1.0). A value of 1.0 means that all roofs in the block area are green roofs.} |
|
32 | 32 | #' \item{`srf3_pvd`}{Fraction of the paved area that belongs to surface class 3 (numeric value between 0.0 and 1.0, see note 1 below)} |
33 | 33 | #' \item{`srf4_pvd`}{Fraction of the paved area that belongs to surface class 4 (numeric value between 0.0 and 1.0, see note 1 below)} |
34 | 34 | #' \item{`srf5_pvd`}{Fraction of the paved area that belongs to surface class 5 (numeric value between 0.0 and 1.0, see note 1 below)} |
35 | | -#' \item{`to_swale`}{Fraction of sealed area (roof area + paved area) that is connected to an infiltration swale (numeric)} |
| 35 | +#' \item{`to_swale`}{Fraction of sealed area (roof area + paved area) that is connected to an infiltration swale (numeric value between 0.0 and 1.0)} |
36 | 36 | #' \item{`gw_dist`}{Distance between groundwater table and surface in metres (numeric)} |
37 | 37 | #' \item{`ufc30`}{field capacity in 30 cm depth (numeric)} |
38 | 38 | #' \item{`ufc150`}{field capacity in 150 cm depth (numeric)} |
39 | 39 | #' \item{`land_type`}{land type, one of `forested`, `horticultural`, `urban`, `vegetationless`, `waterbody` (character)} |
40 | | -#' \item{`veg_class`}{vegetation class index (numeric), derived from an analysis tree volumes} |
| 40 | +#' \item{`veg_class`}{vegetation class index (numeric), derived from an analysis of tree volumes} |
41 | 41 | #' \item{`irrigation`}{irrigation in mm per year (integer)} |
42 | | -#' \item{`block_type`}{Block type identifier of the form "usage-type-id_block-type-id_usage-type-description_block-type-description" (character)} |
| 42 | +#' \item{`block_type`}{Block type identifier of the form "usage-type-id_block-type-id_usage-type-description_block-type-description" (character). This column is Berlin-specific and optional, i.e. not required by the model.} |
| 43 | +#' \item{`Shape`}{List structure containing geometry information on the different block areas. This column is optional. If provided, it will be appended to the model output so that model results can be plotted in the form of maps.} |
43 | 44 | #' } |
| 45 | +#' |
| 46 | +#' Note 1: The sum of surface class fractions `srf1_pvd`, `srf2_pvd`, `srf3_pvd`, `srf4_pvd`, `srf5_pvd` should be 1.0 within each block area. |
| 47 | +#' |
44 | 48 | #' @format ## `rabimo_inputs_2025$config` |
45 | 49 | #' A list with 3 named elements: |
46 | 50 | #' \describe{ |
47 | | -#' \item{runoff_factors}{Runoff factors, vector of numeric with names `roof`, `surface1`, `surface2`, `surface3`, `surface4`, `surface5`} |
48 | | -#' \item{bagrov_values}{Bagrov values for sealed surfaces, vector of numeric with names `roof`, `green_roof`, `surface1`, `surface2`, `surface3`, `surface4`, `surface5`} |
49 | | -#' \item{swale}{Model parameter(s) related to the 'swale' measure, vector of numeric with currently one value, named `swale_evaporation_factor`} |
| 51 | +#' \item{runoff_factors}{Runoff factors for roofs and five different surface |
| 52 | +#' types, given as a vector of numeric with element names `roof`, `surface1`, |
| 53 | +#' `surface2`, `surface3`, `surface4`, `surface5`. A runoff factor determines |
| 54 | +#' the proportion of precipitation that, after subtraction of |
| 55 | +#' evapotranspiration, becomes surface runoff from a paved area. The higher |
| 56 | +#' the factor, the less permeable is the surface.} |
| 57 | +#' \item{bagrov_values}{Bagrov values to calculate evapotranspiration from |
| 58 | +#' paved surfaces, given as a vector of numeric with element names `roof`, |
| 59 | +#' `green_roof`, `surface1`, `surface2`, `surface3`, `surface4`, `surface5`. |
| 60 | +#' The higher the Bagrov value, the more evapotranspiration is generated by |
| 61 | +#' the model. For a description of the evapotranspiration model and for a |
| 62 | +#' figure that shows the influence of the Bagrov values (n) on the |
| 63 | +#' evapotranspiration (in German), see \url{https://www.berlin.de/umweltatlas/wasser/wasserhaushalt/2001/methode/}} |
| 64 | +#' \item{swale}{Model parameter(s) related to the 'swale' measure, given as a |
| 65 | +#' vector of numeric with currently one value, named |
| 66 | +#' `swale_evaporation_factor`. The swale evaporation factor determines which |
| 67 | +#' fraction of the water going into a swale becomes evapotranspiration (the |
| 68 | +#' rest becomes infiltration).} |
50 | 69 | #' } |
51 | 70 | #' @source <https://www.berlin.de/umweltatlas/en/general/contact/> |
52 | 71 | #' @source <https://gdi.berlin.de/services/wfs/ua_gruendaecher_2020?REQUEST=GetCapabilities&SERVICE=wfs> |
|
0 commit comments