SUEWS parameter database

curated values, linked and searchable, a citation on every one Home · Map · suews.io
browse · archetypes/surfaces/grass/beijing-china--grass.yml

Grass · surfacesgrass composite

Surface bundlesgrassbeijingcity

Composition

This composite is assembled from the entries below. Each evidence record keeps its own scientific review; a separate composition review assesses why these components were selected and how they are mapped.

albedoGrassland/herbaceous generic Awaiting sign-off
alb_min 0.19 · alb_max 0.19
emissivityGrass generic Awaiting sign-off
emis 0.93
water_storageGrass swindon Awaiting sign-off
storage_drain_params.store_min 1.9 · storage_drain_params.store_max 1.9
leaf_area_indexGrass generic Awaiting sign-off
lai.lai_type 1 · lai.lai_min 1.6 · lai.lai_max 5.9
leaf_growth_powerGrass, LaiEq = 0 beijing Awaiting sign-off
lai.lai_power.growth_lai -1.42 · lai.lai_power.growth_gdd 0.00258 · lai.lai_power.senescence_lai 2
drainageGrass 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_conductanceGrass beijing Awaiting sign-off
max_conductance 3.7
porosityDummy value generic Agent assessed
biogen_co2Grass espoo Awaiting sign-off
alpha_bio_co2 0.031 · beta_bio_co2 5.4973 · resp_a 2.1
snow_lim_patchGrass generic Awaiting sign-off
snowpack_limit 190
vegetation_growthGrass helsinki Curation required
lai.base_temperature 5 · lai.base_temperature_senescence 10 · lai.gdd_full 300
ohm · summer_wetShort grass [30] Awaiting sign-off
a1 0.32 · a2 0.54 · a3 -27.4
ohm · summer_dryShort grass [30] Awaiting sign-off
a1 0.32 · a2 0.54 · a3 -27.4
ohm · winter_wetShort grass [30] Awaiting sign-off
a1 0.32 · a2 0.54 · a3 -27.4
ohm · winter_dryShort grass [30] Awaiting sign-off
a1 0.32 · a2 0.54 · a3 -27.4

Composition provenance

Curation required

Assembled · assessed by provenance-audit · 2026-08-24. Agent assessment is composition review preparation, not human verification.

Short grass [30]Selected component

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.

GrassSelected component

Fills the biogen_co2 slot. The stable Beijing-path record declares target land_cover.grass, name "Grass", place espoo, representativeness site and source zheng-y2023; Zheng fitted beta to the Espoo lawn and compiled the mixed tuple for the Beijing application.

Grass, LaiEq = 0Selected component

Fills the leaf_growth_power slot. The record declares target land_cover.grass, name "Grass, LaiEq = 0", place beijing, representativeness site and source zheng-y2023.

GrassSelected component

Fills the max_vegetation_conductance slot. The record declares target land_cover.grass, name "Grass", place beijing, representativeness city and source zheng-y2023.

Dummy valueSelected component

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.

GrassSelected component

Fills the vegetation_growth slot. The record declares target land_cover.grass, name "Grass", place helsinki, representativeness city and source jarvi2014.

GrassSelected component

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.

Grassland/herbaceousSelected component

Fills the albedo slot. The record declares target land_cover.grass, name "Grassland/herbaceous", place generic, representativeness generic, source vargo2013 and method literature.

GrassSelected component

Fills the drainage slot. The record is the generic, land-cover-scale Grass tuple published by Järvi et al.; Havu's archive is retained as later compilation evidence.

GrassSelected component

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.

GrassSelected component

Fills the leaf_area_index slot. The stable migration path retains SE England, while the record declares target land_cover.grass, name "Grass", place generic, representativeness generic, applicable_scale land_cover, source jarvi2011 and method literature.

GrassSelected component

Fills the water_storage slot. The stable path retains SE England migration lineage, while the record declares target land_cover.grass, name "Grass", place swindon, representativeness site, source ward2018 and method literature.

Assessment findings

Composite identitysupported
The composite's name reads Grass, its place reads beijing and its origin reads Beijing, China, so the label together with the entry path identifies a grass surface for Beijing. The label on its own is the barest of the nine grass composites, the other eight naming a study or a qualifier, so the place field and the path carry the distinction. Two components declare place beijing and source zheng-y2023; the third Zheng-sourced component is now correctly scoped to its Espoo evidence site while retaining its stable Beijing path.
Composite targetsupported
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 valuesnot 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 rationalenot 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 applicabilitycuration required
The composite declares place beijing. Two of twelve components carry that place; one site-scoped biogenic record carries place espoo, one site-scoped water-storage record carries place swindon, the phenology record carries place helsinki, six components are generic and the OHM record carries no place. Snowpack limit and drainage are generic literature inputs. The Espoo, Swindon and Helsinki selections need an explicit composition rationale rather than being presented as Beijing evidence.
Representativenesscuration required
The composite declares representativeness city. Six components are generic, two are city, three are site-scoped—the Beijing leaf-growth fit, Espoo biogenic evidence and Swindon water-storage input—and the OHM record declares no class. The site results are narrower than the city archetype and require composition-level adjudication.
Slot and season mappingsupported
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 uniquenesssupported
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. This is the only Beijing grass composite in the database, and its uses block is not repeated anywhere: the three nearest entries, archetypes/surfaces/grass/helsinki-finland--grass-havu-et-al-2024, archetypes/surfaces/grass/helsinki-finland--low-vegetation-havu-et-al-2024 and archetypes/surfaces/grass/zurich-switzerland--grass-stagakis-et-al-2024, each differ from it in the leaf_area_index, leaf_growth_power, max_vegetation_conductance and biogen_co2 slots.

Scientific note

The mapping is sound and the selection is defensible, but the entry is only in part a Beijing set. Two of its twelve components declare place beijing, filling leaf_growth_power and max_vegetation_conductance from zheng-y2023. The Zheng-sourced biogen_co2 component retains its stable Beijing path but is now correctly scoped to the Espoo lawn where beta was fitted, so the other ten slots have no Beijing evidence. The radiative and hydrological slots are mostly generic literature inputs, with site-scoped water storage from Swindon; phenology comes from Helsinki while snowpack limit is generic, and the ohm slot takes an unreferenced generic set named "Short grass [30]". A reader should treat the composite as the phenology and conductance parameters zheng-y2023 fitted for Beijing, carried on borrowed values elsewhere, rather than as a set observed in Beijing; every component's own place is declared on its record, so the transfer is visible rather than hidden. The leaf_growth_power component is a one-park site fit, the biogenic CO2 component is one-lawn site evidence and the water-storage component is site-scoped to Swindon inside this city-classed composite, which requires explicit composition curation rather than being treated as city-wide evidence. The drainage component is openly generic literature evidence rather than a Beijing observation.

Model-ready fragment

Paste under land_cover.grass in a SUEWS YAML configuration; every value carries its citation.

alb_min:
  value: 0.19
  ref:
    ID: vargo2013
    DOI: 10.1016/j.jenvman.2012.10.007
    desc: generic, generic
alb_max:
  value: 0.19
  ref:
    ID: vargo2013
    DOI: 10.1016/j.jenvman.2012.10.007
    desc: generic, generic
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: 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: 0
    ref:
      ID: zheng-y2023
      DOI: 10.5194/gmd-16-4551-2023
      desc: beijing, site
  lai_min:
    value: 1.6
    ref:
      ID: zheng-y2023
      DOI: 10.5194/gmd-16-4551-2023
      desc: beijing, site
  lai_max:
    value: 5.9
    ref:
      ID: zheng-y2023
      DOI: 10.5194/gmd-16-4551-2023
      desc: beijing, site
  lai_power:
    growth_lai:
      value: -1.42
      ref:
        ID: zheng-y2023
        DOI: 10.5194/gmd-16-4551-2023
        desc: beijing, site
    growth_gdd:
      value: 0.00258
      ref:
        ID: zheng-y2023
        DOI: 10.5194/gmd-16-4551-2023
        desc: beijing, site
    senescence_lai:
      value: 2
      ref:
        ID: zheng-y2023
        DOI: 10.5194/gmd-16-4551-2023
        desc: beijing, site
    senescence_sdd:
      value: 0.0001
      ref:
        ID: zheng-y2023
        DOI: 10.5194/gmd-16-4551-2023
        desc: beijing, site
  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: 3.7
  ref:
    ID: zheng-y2023
    DOI: 10.5194/gmd-16-4551-2023
    desc: beijing, city
alpha_bio_co2:
  value: 0.031
  ref:
    ID: zheng-y2023
    DOI: 10.5194/gmd-16-4551-2023
    desc: espoo, site
beta_bio_co2:
  value: 5.4973
  ref:
    ID: zheng-y2023
    DOI: 10.5194/gmd-16-4551-2023
    desc: espoo, site
resp_a:
  value: 2.1
  ref:
    ID: jarvi2019
    DOI: 10.1029/2018JD029576
    desc: helsinki, site
resp_b:
  value: 0.06
  ref:
    ID: jarvi2019
    DOI: 10.1029/2018JD029576
    desc: helsinki, 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

Composition review

Curation requiredReview procedure

Composite metadata

Placebeijing
Scopecity
Targetland_cover.grass · docs
Origin“Beijing, China” (verbatim legacy string)
Schema2026.5 · legacy row 24240011

Used by 4 entries

Report an issue