SUEWS parameter database

curated values, linked and searchable, a citation on every one Home · Map · suews.io
browse · archetypes/surfaces/bsoil/swindon-uk--suburban-residential-ward-et-al-2016.yml

Bare soil · surfaces — Suburban residential, Ward et al. (2016)bsoil composite

Surface bundlesbsoilswindoncity

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.

albedoBare soil se-england Awaiting sign-off
alb 0.18
emissivityBare soil se-england Awaiting sign-off
emis 0.94
water_storageBare Soil swindon Awaiting sign-off
storage_drain_params.store_min 0.8 · storage_drain_params.store_max 0.8
drainageBare Soil swindon Awaiting sign-off
storage_drain_params.drain_eq 3 · storage_drain_params.drain_coef_1 10 · storage_drain_params.drain_coef_2 3
constructionCentral London [sample run] london Awaiting sign-off
roof [{'material': 'records/materials/generic--lindberg-f2020--outer-roof-sample-run-ceramic-tiles-slate-shingles-concrete', 'thickness': 0.05}, {'material': 'records/materials/generic--lindberg-f2020--concrete-sample-run', 'thickness': 0.15}, {'thickness': 0.12}] · roof_insulation_layer 2 · wall [{'material': 'records/materials/generic--lindberg-f2020--outer-wall-sample-run-stone-concrete-brick-wood-concrete-35-glazed', 'thickness': 0.087}, {'material': 'records/materials/generic--lindberg-f2020--concrete-sample-run', 'thickness': 0.0497}, {'material': 'records/materials/generic--lindberg-f2020--concrete-sample-run', 'thickness': 0.0497}]
snow_lim_patchBare Soil helsinki Curation required
snowpack_limit 190
ohm · summer_wetCode 55 x Mulitplier for summer [551] Awaiting sign-off
a1 0.379 · a2 0.335 · a3 -30.05
ohm · summer_dryCode 55 x Mulitplier for summer [551] Awaiting sign-off
a1 0.379 · a2 0.335 · a3 -30.05
ohm · winter_wetCode 55 x Mulitplier for winter [552] Awaiting sign-off
a1 0.445 · a2 0.335 · a3 11.77
ohm · winter_dryCode 55 x Mulitplier for winter [552] Awaiting sign-off
a1 0.445 · a2 0.335 · a3 11.77

Composition provenance

Curation required

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

Bare soilSelected component

Fills the albedo slot. The record declares target land_cover.bsoil, name 'Bare soil', place se-england, representativeness site, source ward2016 and method literature, and carries alb.

Bare soilSelected component

Fills the emissivity slot. The record declares target land_cover.bsoil, name 'Bare soil', place se-england, representativeness site, source ward2016 and method literature, and carries emis.

Bare SoilSelected component

Fills the water_storage slot. The record declares target land_cover.bsoil, name 'Bare Soil', place se-england, representativeness regional and source ward2018, and carries store_min and store_max under storage_drain_params.

Bare SoilSelected component

Fills the drainage slot. The record declares target land_cover.bsoil, name 'Bare Soil', place se-england, representativeness regional and source ward2018, and carries drain_eq, drain_coef_1, drain_coef_2 and wet_threshold.

Central London [sample run]Selected component

Fills the construction slot. The record declares target construction, name 'Central London [sample run]', place london, representativeness city, source unreferenced and method assumed, and carries three-layer roof and wall lists with roof_insulation_layer 2 and wall_insulation_layer 2. Roof layer three has only its proven thickness because no material record matches its historical properties. scripts/export_record.py keeps the construction slot out of the surface fragment, so this reference contributes no exported value.

Bare SoilSelected component

Fills the snow_lim_patch slot. The record declares target land_cover.bsoil, name 'Bare Soil', place helsinki, origin 'Helsinki, Finland', representativeness city and source jarvi2014, and carries snowpack_limit.

Code 55 x Mulitplier for summer [551]Selected component

Fills the ohm summer_wet and summer_dry positions. The record declares target ohm_coefficients, name 'Code 55 x Mulitplier for summer [551]', season_label Summer and source ward2016, carries a1, a2 and a3, and declares no place and no representativeness.

Code 55 x Mulitplier for winter [552]Selected component

Fills the ohm winter_wet and winter_dry positions. The record declares target ohm_coefficients, name 'Code 55 x Mulitplier for winter [552]', season_label Winter and source ward2016, carries a1, a2 and a3, and declares no place and no representativeness.

Assessment findings

Composite identitysupported
The composite's name reads 'Suburban residential, Ward et al. (2016)', its place reads swindon and its origin reads 'Swindon, UK'. The label names both the typology and the study the selection follows, and four of the eight components declare source ward2016, so the label identifies what the entry assembles.
Composite targetsupported
The composite declares target land_cover.bsoil. The albedo, emissivity, water_storage, drainage and snow_lim_patch slots each take a record declaring target land_cover.bsoil; the construction slot takes a record declaring target construction and the four ohm positions take records declaring target ohm_coefficients, which are the entry types those slots exist for. Surface records carry no attaches_to field, since attaches_to appears in this database only on the profile records under records/profiles/, so the slot check rests on the parameters each component carries: alb into albedo, emis into emissivity, store_min and store_max into water_storage, drain_eq, drain_coef_1, drain_coef_2 and wet_threshold into drainage, snowpack_limit into snow_lim_patch, and a1, a2 and a3 into each ohm position. The water_storage and drainage components both write into storage_drain_params and their keys do not overlap, so neither overrides the other. The two OHM components carry season_label: records/ohm/generic--ward2016--bare-soil declares Summer and fills summer_wet and summer_dry, and records/ohm/generic--ward2016--bare-soil--code-55-x-mulitplier-for-winter-552 declares Winter and fills winter_wet and winter_dry, so the season mapping follows each record's own label. Neither carries a wetness label, so a season's wet and dry positions taking the same record asserts nothing the records deny.
Own parameter valuesnot applicable
The composite declares no parameters of its own, so it overrides no component value; every number in its exported fragment arrives from a component.
Composition rationalenot applicable
The composite declares no source field and the repository records no published rationale for this selection. Each component's own source belongs to that component's evidence assessment, not to this review.
Place applicabilitycuration required
The composite declares place swindon. No component declares that place, and none could: the database holds no bare-soil record for Swindon. The albedo, water_storage and drainage slots take records with place se-england, which db/places.yml records as 'SE England', subnational: true, country united-kingdom, the region containing Swindon, so applying them to the town is a downscaling rather than a substitution and it is the closest the database offers. The site-scoped emissivity is documented for both London and Swindon, so its se-england place includes this application but does not establish city-wide reach. The snow_lim_patch slot takes records/surfaces/bsoil/helsinki--jarvi2014--snow-lim, place helsinki, the only bare-soil snow_lim record there is. The construction slot takes records/constructions/uk--lindberg-f2020--central-london-sample-run, whose corrected place is london and representativeness is city; neither supports the Swindon place claim, although the slot contributes no exported value because scripts/export_record.py keeps construction out of the surface fragment. Selecting another construction remains a separate curation decision. The two OHM records declare no place.
Representativenesscuration required
The composite declares representativeness city. Two se-england components declare regional, while the Ward albedo and emissivity components are site-scoped; the construction and records/surfaces/bsoil/helsinki--jarvi2014--snow-lim declare city; the two OHM records declare no representativeness. The site-scoped albedo and emissivity are narrower than the composite's city claim, so their use in this city typology needs maintainer adjudication.
Slot and season mappingsupported
An assembly of eight existing records into eleven slot positions; the composite produces no value of its own.
Completeness and uniquenesssupported
The composite fills all seven slots the land_cover.bsoil archetypes use, albedo, emissivity, water_storage, drainage, construction, snow_lim_patch and ohm, so the assembly is complete, and it is the only Swindon bare-soil typology in the database. Its uses block is byte-identical to that of archetypes/surfaces/bsoil/london-uk--central-london-ward-et-al-2016: the same eight records in the same eleven positions, and neither entry declares parameters of its own, so the two export the same fragment. They are not duplicates in the sense the other entry could be deleted, because they declare different places, swindon and london. The construction now supports London but not Swindon. Two exported SE England components are regional, while the shared Ward albedo and emissivity are site-scoped and therefore do not automatically support either city claim; that question is recorded under representativeness. Sharing still means that any correction to one component reaches both. records/surfaces/bsoil/se-england--ward2016--water-state carries state_limit and is referenced by no archetype, but no land_cover.bsoil archetype declares a water_state slot, so that is a target-wide design question rather than an omission in this entry.

Scientific note

Nothing in this assembly can be improved by re-pointing a slot. archetypes/surfaces/bsoil/swindon-uk--suburban-residential-ward-et-al-2016 declares place swindon and representativeness city, and the database holds no bare-soil record for Swindon at all, so its albedo and emissivity come from ward2016 se-england rows, while water storage and drainage come from ward2018 se-england rows. The latter two regional records cover the town and are applied down; the albedo and emissivity are site-scoped, so their use in a city typology remains a composition-level curation question. The season mapping follows the components' own season_label fields, and every slot takes a record declaring the target that slot fills. Two things are worth a reader's attention without being defects in the selection. The snow_lim_patch slot leaves the UK entirely, because records/surfaces/bsoil/helsinki--jarvi2014--snow-lim is the only bare-soil snowpack-limit record in the database. And the construction slot points at a record named 'Central London [sample run]', and its corrected London place does not cover Swindon, though the slot contributes no exported value because scripts/export_record.py keeps construction out of the surface fragment. The entry shares every component with archetypes/surfaces/bsoil/london-uk--central-london-ward-et-al-2016 and exports the same fragment, which is defensible here in a way it would not be for two entries claiming the same place: most exported surface evidence is regional and covers both towns, while the shared site-scoped albedo and emissivity have to be adjudicated for each city claim. The London construction mismatch is non-exporting but remains a composition-provenance defect. A correction to any one component reaches both.

Model-ready fragment

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

alb:
  value: 0.18
  ref:
    ID: ward2016
    DOI: 10.1016/j.uclim.2016.05.001
    desc: se-england, site
emis:
  value: 0.94
  ref:
    ID: ward2016
    DOI: 10.1016/j.uclim.2016.05.001
    desc: se-england, site
storage_drain_params:
  store_min:
    value: 0.8
    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: ward2018
      DOI: 10.1002/joc.5200
      desc: swindon, site
  drain_coef_1:
    value: 10
    ref:
      ID: ward2018
      DOI: 10.1002/joc.5200
      desc: swindon, site
  drain_coef_2:
    value: 3
    ref:
      ID: ward2018
      DOI: 10.1002/joc.5200
      desc: swindon, site
wet_threshold:
  value: 1
  ref:
    ID: ward2018
    DOI: 10.1002/joc.5200
    desc: swindon, site
snowpack_limit:
  value: 190
  ref:
    ID: jarvi2014
    DOI: 10.5194/gmd-7-1691-2014
    desc: helsinki, city
ohm_coef:
  summer_wet:
    a1:
      value: 0.379
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a2:
      value: 0.335
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a3:
      value: -30.05
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
  summer_dry:
    a1:
      value: 0.379
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a2:
      value: 0.335
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a3:
      value: -30.05
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
  winter_wet:
    a1:
      value: 0.445
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a2:
      value: 0.335
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a3:
      value: 11.77
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
  winter_dry:
    a1:
      value: 0.445
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a2:
      value: 0.335
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover
    a3:
      value: 11.77
      ref:
        ID: ward2016
        DOI: 10.1016/j.uclim.2016.05.001
        desc: land_cover

Composition review

Curation requiredReview procedure

Composite metadata

Placeswindon
Scopecity
Targetland_cover.bsoil · docs
Origin“Swindon, UK” (verbatim legacy string)
Schema2026.5 · legacy row 20240022
Report an issue