| albedo | Deciduous Forest generic Awaiting sign-off alb_min 0.16 · alb_max 0.16 |
|---|---|
| emissivity | Deciduous trees generic Awaiting sign-off emis 0.98 |
| water_storage | Deciduous Tree swindon Awaiting sign-off storage_drain_params.store_min 0.3 · storage_drain_params.store_max 0.8 |
| leaf_area_index | Deciduous Tree (SE England) se-england Curation required lai.lai_type 1 · lai.lai_min 1 · lai.lai_max 5.5 |
| leaf_growth_power | Deciduous Tree, LaiEq = 1 helsinki Awaiting sign-off lai.lai_power.growth_lai 0.04 · lai.lai_power.growth_gdd 0.002 · lai.lai_power.senescence_lai -1.5 |
| drainage | Deciduous Tree generic Awaiting sign-off storage_drain_params.drain_eq 3 · storage_drain_params.drain_coef_1 0.013 · storage_drain_params.drain_coef_2 1.71 |
| max_vegetation_conductance | Dec Tree helsinki Awaiting sign-off max_conductance 3.1 |
| porosity | Deciduous Tree generic Awaiting sign-off porosity_min_deciduous 0.2 · porosity_max_deciduous 0.6 |
| biogen_co2 | Deciduous trees + grass helsinki Awaiting sign-off alpha_bio_co2 0.031 · beta_bio_co2 11.5 · theta_bio_co2 0.723 |
| snow_lim_patch | Deciduous Tree generic Awaiting sign-off snowpack_limit 190 |
| vegetation_growth | Deciduous Tree helsinki Curation required lai.base_temperature 5 · lai.base_temperature_senescence 10 · lai.gdd_full 300 |
| ohm · summer_wet | Mixed Forest [20] McCaughey (1985) Verified a1 0.11 · a2 0.11 · a3 -12.3 |
| ohm · summer_dry | Mixed Forest [20] McCaughey (1985) Verified a1 0.11 · a2 0.11 · a3 -12.3 |
| ohm · winter_wet | Mixed Forest [20] McCaughey (1985) Verified a1 0.11 · a2 0.11 · a3 -12.3 |
| ohm · winter_dry | Mixed Forest [20] McCaughey (1985) Verified a1 0.11 · a2 0.11 · a3 -12.3 |
Fills the four OHM positions summer_wet, summer_dry, winter_wet and winter_dry. The record declares target ohm_coefficients, source grimmond1991b, no place and no representativeness, and is named "Mixed Forest [20] McCaughey (1985)". It declares no season_label, so nothing in it distinguishes the four positions it fills.
Fills biogen_co2. The record declares target land_cover.dectr, place helsinki and representativeness city. It is named "Deciduous trees + grass" and carries source havu-m2024, so it describes a mixed tree and grass canopy rather than the street trees the composite is named for.
Fills leaf_growth_power. The record declares target land_cover.dectr, place helsinki and representativeness city. It is named "Deciduous Tree, LaiEq = 1", carries source havu-m2024 and declares lai.lai_type 1, matching the leaf_area_index component.
Fills max_vegetation_conductance. The record declares target land_cover.dectr, place helsinki and representativeness city. It is named "Dec Tree" and carries source havu-m2024.
Fills vegetation_growth. The record declares target land_cover.dectr, place helsinki and representativeness city. It carries source jarvi2014 and supplies base_temperature, base_temperature_senescence, gdd_full and sdd_full as one set; its place is the composite's own.
Fills snow_lim_patch. The stable path and origin retain Helsinki migration lineage, while the record declares target land_cover.dectr, place generic, representativeness generic, applicable_scale land_cover, source jarvi2014 and method literature. It supplies the published 190 mm land-cover default.
Fills albedo. The record declares target land_cover.dectr, place generic and representativeness generic. It is named "Deciduous Forest", carries source vargo2013 and declares method literature.
Fills drainage. The record is the generic, land-cover-scale Deciduous Tree literature tuple compiled by Järvi et al.; Havu's archive is retained as later Helsinki application evidence.
Fills porosity. The record declares target land_cover.dectr, place generic, representativeness generic, applicable_scale land_cover, source unreferenced and method assumed. It supplies porosity_min_deciduous and porosity_max_deciduous to all eight deciduous-tree composites.
Fills emissivity. The record declares target land_cover.dectr, place generic and representativeness generic. It is named "Deciduous trees", carries source oke1987 and declares method literature.
Fills leaf_area_index. The record declares target land_cover.dectr, place se-england and representativeness regional. It is named "Deciduous Tree (SE England)", carries source jarvi2011, declares method literature and has lai.lai_type 1.
Fills water_storage. The record declares target land_cover.dectr, place se-england and representativeness regional. It carries source jarvi2011 and is the store_min and store_max entry of every deciduous-tree composite.
| Composite identity | curation required Two things in the label do not match what the composite assembles. First, the label reads "Deciduous Street trees, Havu et al. 2022", but db/sources.yml carries no Havu key other than havu-m2024, registered as Havu M., Kulmala L., Lee H.S., Saranko O., Soininen J., Ahongshangbam J. and Järvi L, 2024, "CO2 uptake of urban vegetation in a warming Nordic city", Urban Forestry and Urban Greening, doi 10.1016/j.ufug.2024.128261, and all three Havu components here declare that key. Whether a 2022 Havu publication exists and should be registered and cited, or whether the label should read 2024, cannot be settled from the entries. Second, the biogen_co2 slot takes records/surfaces/dectr/helsinki--havu-m2024--biogen-co2--deciduous-trees-grass, named "Deciduous trees + grass", while records/surfaces/dectr/helsinki--havu-m2024--biogen-co2--deciduous-trees-street, named "Deciduous trees - street", exists under the same source and the same place and is selected instead by archetypes/surfaces/dectr/helsinki-finland--mixed-dec-jarvi-et-al-2014. A street-tree typology not taking the street-tree record, while a mixed-deciduous typology does, reads as a swap, and a maintainer should confirm or correct it. |
|---|---|
| Composite target | supported The composite's own target is land_cover.dectr. Eleven of its twelve components declare target land_cover.dectr, and the four OHM positions take a record declaring ohm_coefficients, the type that slot carries. The leaf_area_index and leaf_growth_power components both declare lai.lai_type 1, so the pair belongs to one LAI equation, which is the coupling schema/parameter_groups.yml makes a rule for that slot pair. |
| Own parameter values | not applicable The composite declares no parameter overrides of its own. |
| Composition rationale | not applicable The composite claims no composition source, and the repository records no published rationale for this typology. The components' own sources belong to their evidence assessments, not to this review. |
| Place applicability | curation required The composite claims place helsinki, and four of its twelve components carry that place. The degree-day thresholds are a Helsinki record, while snowpack limit is a generic Järvi land-cover default. One component carries place swindon (water storage), one carries place se-england (leaf area index), five are generic and the OHM record carries no place. The site-scoped Swindon water-storage import needs an explicit composition rationale. The leaf_area_index import is forced, since db/records/surfaces/dectr holds leaf-area-index records placed at beijing, se-england, shanghai and zurich and none placed at helsinki. |
| Representativeness | curation required The composite claims representativeness city. Four components are city, one is regional, five are generic, the Swindon water-storage record is site-scoped and the OHM record declares no class. The site result is narrower than the city archetype and needs composition-level adjudication. |
| Slot and season mapping | supported The composite assembles existing records into slots and produces no value of its own. All four OHM positions take records/ohm/generic--unreferenced--all-vegetation--mixed-forest-20-mccaughey-1985, which declares no season_label, and no OHM record in the database declares a wet or dry label, so one season-agnostic coefficient set in all four positions is the only mapping the entries support. |
| Completeness and uniqueness | supported Twelve distinct records fill the fifteen slot positions the deciduous-tree composites use, and every one of those slots is filled. The composite shares eleven of its twelve component paths with the park-trees composite, differing only in the leaf_area_index slot, and differs from the forest-trees composite in two components. It is therefore distinct, but the street and park typologies are separated by one record. scripts/export_record.py also recognises a water_state slot and db/records/surfaces/dectr holds records/surfaces/dectr/se-england--ward2016--water-state, which no deciduous-tree composite references. |
The assembly itself is sound: a Helsinki phenology record and a generic Järvi snowpack default for the climate-conditioned slots, a consistent LAI equation across the two LAI slots, explicit site-scoped Swindon water storage, regional and generic imports for the other hydrological and canopy-structure slots, a generic Vargo albedo, and a generic mixed-forest storage-heat set in all four OHM positions. The label is what does not hold up. It cites Havu et al. 2022, and no such key exists in db/sources.yml, which carries havu-m2024 alone; all three Havu components here declare that 2024 key. Nothing in the repository establishes that a 2022 Havu publication is the source of anything in this composite, and this review will not supply a citation it has not read. Separately, the slot that should carry what makes street trees different, the biogenic CO2 set, takes the record named for deciduous trees plus grass, while the record named for street deciduous trees sits in the Järvi 2014 mixed-deciduous composite instead. Both records share a source and a place, so this is a selection question rather than a value question, and it is cheap for a maintainer to settle by reading the two typologies against the publication. The components' values remain subject to their own evidence assessments; this review does not revisit them.
Paste under land_cover.dectr in a SUEWS YAML configuration; every value carries its citation.
alb_min:
value: 0.16
ref:
ID: vargo2013
DOI: 10.1016/j.jenvman.2012.10.007
desc: generic, generic
alb_max:
value: 0.16
ref:
ID: vargo2013
DOI: 10.1016/j.jenvman.2012.10.007
desc: generic, generic
emis:
value: 0.98
ref:
ID: oke1987
DOI: null
desc: generic, generic
storage_drain_params:
store_min:
value: 0.3
ref:
ID: ward2018
DOI: 10.1002/joc.5200
desc: swindon, site
store_max:
value: 0.8
ref:
ID: ward2018
DOI: 10.1002/joc.5200
desc: swindon, site
drain_eq:
value: 3
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
drain_coef_1:
value: 0.013
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
drain_coef_2:
value: 1.71
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
lai:
lai_type:
value: 1
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
lai_min:
value: 1
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
lai_max:
value: 5.5
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
lai_power:
growth_lai:
value: 0.04
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
growth_gdd:
value: 0.002
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
senescence_lai:
value: -1.5
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
senescence_sdd:
value: 0.0005
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
base_temperature:
value: 5
ref:
ID: jarvi2014
DOI: 10.5194/gmd-7-1691-2014
desc: helsinki, city
base_temperature_senescence:
value: 10
ref:
ID: jarvi2014
DOI: 10.5194/gmd-7-1691-2014
desc: helsinki, city
gdd_full:
value: 300
ref:
ID: jarvi2014
DOI: 10.5194/gmd-7-1691-2014
desc: helsinki, city
sdd_full:
value: -450
ref:
ID: jarvi2014
DOI: 10.5194/gmd-7-1691-2014
desc: helsinki, city
wet_threshold:
value: 0.8
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
max_conductance:
value: 3.1
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
porosity_min_deciduous:
value: 0.2
ref:
ID: unreferenced
DOI: null
desc: generic, generic, land_cover
porosity_max_deciduous:
value: 0.6
ref:
ID: unreferenced
DOI: null
desc: generic, generic, land_cover
alpha_bio_co2:
value: 0.031
ref:
ID: bellucco2017
DOI: 10.1016/j.agrformet.2016.12.011
desc: helsinki, site
beta_bio_co2:
value: 11.5
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
theta_bio_co2:
value: 0.723
ref:
ID: bellucco2017
DOI: 10.1016/j.agrformet.2016.12.011
desc: helsinki, site
resp_a:
value: 2.3
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
resp_b:
value: 0.046
ref:
ID: havu-m2024
DOI: 10.1016/j.ufug.2024.128261
desc: helsinki, city
min_res_bioco2:
value: 0.6
ref:
ID: jarvi2019
DOI: 10.1029/2018JD029576
desc: finland, site
snowpack_limit:
value: 190
ref:
ID: jarvi2014
DOI: 10.5194/gmd-7-1691-2014
desc: generic, generic, land_cover
ohm_coef:
summer_wet:
a1:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -12.3
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
summer_dry:
a1:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -12.3
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
winter_wet:
a1:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -12.3
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
winter_dry:
a1:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.11
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -12.3
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
land_cover.dectr · docs