| albedo | Grass se-england Awaiting sign-off alb_min 0.18 · alb_max 0.21 |
|---|---|
| emissivity | Grass generic Awaiting sign-off emis 0.93 |
| water_storage | Grass swindon Awaiting sign-off storage_drain_params.store_min 1.9 · storage_drain_params.store_max 1.9 |
| leaf_area_index | Grass helsinki Awaiting sign-off lai.lai_type 1 · lai.lai_min 1.6 · lai.lai_max 5.9 |
| leaf_growth_power | Grass, LaiEq = 0 generic Awaiting sign-off lai.lai_power.growth_lai 0.03 · lai.lai_power.growth_gdd 0.0005 · lai.lai_power.senescence_lai 0.03 |
| drainage | Grass generic Awaiting sign-off storage_drain_params.drain_eq 2 · storage_drain_params.drain_coef_1 0.013 · storage_drain_params.drain_coef_2 1.71 |
| max_vegetation_conductance | Irrigated Grass generic Awaiting sign-off max_conductance 40 |
| porosity | Dummy value generic Agent assessed |
| biogen_co2 | Temperate grassland lethbridge Awaiting sign-off alpha_bio_co2 0.0205 · beta_bio_co2 16.3 · resp_a 1.08 |
| snow_lim_patch | Grass generic Awaiting sign-off snowpack_limit 190 |
| vegetation_growth | Grass helsinki Curation required lai.base_temperature 5 · lai.base_temperature_senescence 10 · lai.gdd_full 300 |
| ohm · summer_wet | Short grass [30] Awaiting sign-off a1 0.32 · a2 0.54 · a3 -27.4 |
| ohm · summer_dry | Short grass [30] Awaiting sign-off a1 0.32 · a2 0.54 · a3 -27.4 |
| ohm · winter_wet | Short grass [30] Awaiting sign-off a1 0.32 · a2 0.54 · a3 -27.4 |
| ohm · winter_dry | Short grass [30] Awaiting sign-off a1 0.32 · a2 0.54 · a3 -27.4 |
Fills all four ohm positions, summer_wet, summer_dry, winter_wet and winter_dry. The record declares target ohm_coefficients, name "Short grass [30]" and source grimmond1991b; it carries no place or representativeness field. It declares no season_label, so one set fills all four positions.
Fills the porosity slot structurally. The assumed, unreferenced "Dummy value" adapter has an empty parameters mapping and only preserved legacy -999 sentinels, so it contributes no active parameter and makes no literature-value claim.
Fills the vegetation_growth slot. The record declares target land_cover.grass, name "Grass", place helsinki, representativeness city and source jarvi2014.
Fills the snow_lim_patch slot. The stable path and origin retain Helsinki migration lineage, while the record declares target land_cover.grass, name "Grass", place generic, representativeness generic, applicable_scale land_cover, source jarvi2014 and method literature.
Fills the biogen_co2 slot. The record declares target land_cover.grass, name "Temperate grassland", place lethbridge, representativeness site, source unreferenced and method calculated. Flanagan supplies the light-response input data rather than the calculated tuple's source. It, the Ward grass albedo and the Ward 2018 water-storage record are the three site-classed components in this composite.
Fills the drainage slot. The record declares target land_cover.grass, name "Grass", place generic, representativeness generic and applicable_scale land_cover. It carries source jarvi2011 and declares method literature. Its stable London path and origin retain release-application lineage without presenting the values as London evidence.
Fills the leaf_area_index slot. The record declares target land_cover.grass, name "Grass (SE England)", place helsinki, representativeness city and source havu-m2024. Its stable path, name and origin retain the legacy SE England migration text.
Fills the albedo slot. The record declares target land_cover.grass, name "Grass", place se-england, representativeness site, applicable_scale land_cover, source ward2016 and method fitted. Its alb_max leaf overrides those defaults with source jarvi2011, method literature and generic reach.
Fills the emissivity slot. The record declares target land_cover.grass, name "Grass", place generic and representativeness generic; it carries source jarvi2011 and declares method literature.
Fills the water_storage slot. The stable path retains its SE England/Ward 2016 migration lineage, while the record declares target land_cover.grass, name "Grass", place swindon, representativeness site, source ward2018 and method literature.
Fills the leaf_growth_power slot. The record declares target land_cover.grass, name "Grass, LaiEq = 0", place generic, representativeness generic and source jarvi2011, with method literature.
Fills the max_vegetation_conductance slot. The record declares target land_cover.grass, name "Irrigated Grass", place generic, representativeness generic and source jarvi2011, with method literature.
| Composite identity | supported The composite's name reads "Irrigated [sample run]", its place reads vancouver and its origin reads Vancouver. The irrigated qualifier is carried by records/surfaces/grass/vancouver--jarvi2011--max-conductance, named "Irrigated Grass", so the label matches the assembly. The bracketed marker says the configuration comes from a demonstration run rather than from a description of a site. scripts/check_db.py lists "sample run" among its SUSPECT_MARKERS, so make check already reports the composite name as reading like a test fixture rather than data. The label is honest about what the entry is; whether an entry of that kind belongs in the published archetype set is taken under identity. |
|---|---|
| Composite target | supported The composite declares target land_cover.grass. Eleven of the twelve components declare target land_cover.grass and the twelfth, records/ohm/generic--unreferenced--grass, declares target ohm_coefficients, which is what the ohm slot takes: docs/FORMAT.md puts the four season and wetness positions of supy's ohm_coef on the archetype rather than on the coefficient records. Surface records carry no attaches_to field, which in this database appears only on the profile records under records/profiles/, so the slot check rests on the parameter names each component carries, and every slot receives a component holding the fields that slot names. The ohm component is named "Short grass [30]", the grass-specific coefficient set rather than a vegetation average, and it fills all four positions because it declares no season_label and no wet or dry distinction. |
| Own parameter values | not applicable The composite declares no parameters of its own, so it overrides no component value; the exported fragment is its components merged into their slots. |
| Composition rationale | not applicable The composite declares no source field and asserts no parameters of its own, so there is no published composition rationale to review. The archetype format does allow a composite to carry a source, as the snow archetypes do for the scalars they assert themselves, and this entry carries none. Each component's own source belongs to that component's evidence assessment. |
| Place applicability | curation required The composite declares place vancouver, but no component carries that place. One component carries place se-england, one carries swindon, two carry helsinki, one carries lethbridge, six are generic and the OHM record carries no place. Snowpack limit is one of the generic Järvi inputs. Three site-scoped slots need settling: albedo imports SE England evidence, water_storage imports Swindon evidence, and biogen_co2 takes records/surfaces/grass/lethbridge--flanagan2002--biogen-co2, which declares place lethbridge, given in db/places.yml as lat 49.69, lon -112.83, koppen BSk, origin "Lethbridge, Alberta, Canada", name "Temperate grassland" and representativeness site: a semi-arid prairie grassland standing in for irrigated urban grass in a marine west-coast city, where the country is the only thing the two places share. The database holds a surface-agnostic alternative, records/surfaces/common/se-england--ruimy1995--biogen-co2, named "Plant canopies", which the London and Swindon grass composites take; it is no more Vancouver-local than the Lethbridge record, so this is a choice between two transplants rather than a correction, and exchanging them would change a model input. A maintainer should decide which transplant this entry should carry. |
| Representativeness | curation required The composite declares representativeness city. Two components declare city; drainage, porosity, emissivity, snow limit, leaf_growth_power and max_vegetation_conductance declare generic; and three declare site. The OHM component carries no representativeness field. The site-classed components are records/surfaces/grass/lethbridge--flanagan2002--biogen-co2, the Ward grass albedo record and the Ward 2018 water-storage record. Single-site evidence inside a city typology is exactly what the representativeness field exists to make visible, and the composition layer cannot reconcile it: either the slot should take a component classed at or above the composite's scale, or a maintainer should accept the site value knowingly and say so. |
| Slot and season mapping | supported An assembly of twelve existing records into the twelve slots the vegetation archetypes use, and assembled is the method a composition sidecar takes. The composite produces no value of its own. |
| Completeness and uniqueness | curation required The uses block fills all twelve slots the vegetation archetypes use, namely albedo, emissivity, water_storage, leaf_area_index, leaf_growth_power, drainage, max_vegetation_conductance, porosity, biogen_co2, snow_lim_patch, vegetation_growth and ohm, which is the slot vocabulary every land_cover.grass, land_cover.dectr and land_cover.evetr archetype in the database uses, so no slot is missing. The ohm slot names one record in all four positions, and no other archetype in the database repeats this uses block, so the entry is complete and unique. What is unsettled is whether it should be in the set at all. Its own name reads "Irrigated [sample run]", which scripts/check_db.py reports as a suspect name, and it is published beside entries that describe real sites with nothing but that name to distinguish it. Whether a demonstration configuration should stand in the published archetype set, and if it should whether it needs marking beyond its name, is a curation decision this review cannot take. |
The entry is a demonstration configuration and says so: its name reads "Irrigated [sample run]". The mapping itself is sound, every slot receiving a component declared for it and the ohm slot taking the grass-specific "Short grass [30]" set. None of the twelve components declares place vancouver; drainage, leaf_growth_power and max_vegetation_conductance are generic Järvi literature parameters whose stable paths retain application lineage. Albedo comes from SE England, water storage from Swindon, two components from Helsinki and one from Lethbridge; drainage, porosity, emissivity, snow limit, leaf-growth power and maximum conductance are generic, and the unreferenced coefficient set carries no place. Three things need a maintainer. The biogen_co2 slot takes records/surfaces/grass/lethbridge--flanagan2002--biogen-co2, a site-classed temperate grassland record from a semi-arid prairie location (koppen BSk) filling a slot in a marine west-coast city composite (koppen Cfb). The Ward grass albedo and Ward 2018 water storage are also site-scoped, so all three are narrower than the composite. The alternative the London and Swindon composites take, records/surfaces/common/se-england--ruimy1995--biogen-co2, is no more local, so the choice between two transplants is a maintainer's and not a correction. The Swindon site water-storage import needs a Vancouver composition rationale. And whether a sample-run configuration belongs in the published archetype set beside descriptions of real sites is a curation decision of the same kind.
Paste under land_cover.grass in a SUEWS YAML configuration; every value carries its citation.
alb_min:
value: 0.18
ref:
ID: ward2016
DOI: 10.1016/j.uclim.2016.05.001
desc: se-england, site, land_cover
alb_max:
value: 0.21
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
emis:
value: 0.93
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
storage_drain_params:
store_min:
value: 1.9
ref:
ID: ward2018
DOI: 10.1002/joc.5200
desc: swindon, site
store_max:
value: 1.9
ref:
ID: ward2018
DOI: 10.1002/joc.5200
desc: swindon, site
drain_eq:
value: 2
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: 0
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
lai_min:
value: 1.6
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
lai_max:
value: 5.9
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
lai_power:
growth_lai:
value: 0.03
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
growth_gdd:
value: 0.0005
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
senescence_lai:
value: 0.03
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
senescence_sdd:
value: 0.0005
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
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: 1.9
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic, land_cover
max_conductance:
value: 40
ref:
ID: jarvi2011
DOI: 10.1016/j.jhydrol.2011.10.001
desc: generic, generic
alpha_bio_co2:
value: 0.0205
ref:
ID: unreferenced
DOI: null
desc: lethbridge, site
beta_bio_co2:
value: 16.3
ref:
ID: unreferenced
DOI: null
desc: lethbridge, site
resp_a:
value: 1.08
ref:
ID: schmid2000
DOI: 10.1016/S0168-1923(00)00140-4
desc: morgan-monroe-state-forest, site
resp_b:
value: 0.064
ref:
ID: schmid2000
DOI: 10.1016/S0168-1923(00)00140-4
desc: morgan-monroe-state-forest, site
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.32
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.54
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -27.4
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
summer_dry:
a1:
value: 0.32
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.54
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -27.4
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
winter_wet:
a1:
value: 0.32
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.54
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -27.4
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
winter_dry:
a1:
value: 0.32
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a2:
value: 0.54
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover
a3:
value: -27.4
ref:
ID: grimmond1991b
DOI: 10.1016/0957-1272(91)90003-W
desc: land_cover