SUEWS parameter database

curated values, linked and searchable, a citation on every one Home · Map · suews.io
browse · records/surfaces/paved/shanghai--ao2016--albedo.yml

Paved · albedopaved evidence record

alb0.12
albedopavedshanghaisiteCentral business districtAo 2016

Parameters

Names follow the SUEWS YAML specification; click one for its definition in the configuration reference.

Labelled fields override the record-level citation or scope; unlabelled fields use the record metadata.

alb0.12 Ao 2016 source bounds 0.12–0.14 · active minimum

Provenance evidence

Awaiting sign-off

Published value · assessed by provenance-audit · 2026-08-25. Agent assessment is evidence preparation, not human verification.

Radiation fluxes in a business district of Shanghai, ChinaParameter source

Applies to: parameters.alb

Where: Table 2, Paved column, alpha_i minimum and maximum (accepted manuscript), p. 13

Publishes Paved albedo minimum 0.12 and maximum 0.14. Neither cell carries the source superscripts used elsewhere in the table. parameters.alb stores the minimum and its canonical source_bounds preserve the complete pair.

Where: Section 3.4, evaluation of a radiation parameterization scheme (accepted manuscript), p. 12

Describes the Table 2 values as inputs to the XJH SUEWS and NARP runs evaluated over the radiometer field of view and eddy-covariance source area.

SUEWS database pre-migration workbook: database.xlsxLater compilation

Where: Pre-migration Albedo row 41240030

Preserves Paved, Shanghai, Alb_min 0.12, Alb_max 0.14 and Ref 90240065, which resolves to Ao et al. This establishes migration fidelity, not a policy for collapsing the pair to one scalar.

Assessment findings

Namesupported
Ao et al. Table 2 and the pre-migration row both identify the surface as Paved.
Targetsupported
Table 2 presents the values as SUEWS Paved-surface albedo inputs, matching land_cover.paved.
Valuessupported
Ao et al. publish a Paved minimum of 0.12 and maximum of 0.14. The active alb value preserves the lower endpoint exactly, and canonical source_bounds now preserve the upper endpoint and explicitly identify the active scalar as the published minimum without changing model behaviour.
issue #339
Sourcesupported
Ao et al. directly print both Paved cells without a source superscript. The legacy row preserves the migration link to that publication, while parameter_provenance.source_bounds now carries both endpoints as canonical field-level metadata.
Placesupported
The values are model inputs for the Xujiahui Shanghai study site.
Representativenesssupported
The paper applies the inputs at the Xujiahui site and evaluates the radiometer field of view and eddy-covariance source area, supporting site rather than city reach.
Urban Settingsupported
The study identifies Xujiahui as a central business district.
Methodsupported
Literature records the database action of adopting Ao et al.'s directly published SUEWS input bounds. It does not claim that the underlying albedos were measured or fitted by Ao et al.
Identitysupported
The publication and pre-migration row preserve the Paved, Shanghai and legacy-ID identity. The former legacy-only maximum now also has a canonical home under the active albedo leaf's source_bounds; legacy.Alb_max remains as verbatim migration lineage.

Scientific note

Ao et al. publish the Paved albedo bounds as 0.12 and 0.14, while SUEWS accepts one alb scalar. Canonical source_bounds now preserve the pair, state that the active 0.12 is the source minimum, render the pair on the record page and carry it in the exported RefValue description. This removes the silent migration loss without averaging the bounds, replacing the active value or changing the SUEWS data model. The maximum is no longer legacy-only: field-level provenance carries its canonical meaning while legacy.Alb_max retains the original column for migration fidelity.

Legacy values (verbatim original columns; not SUEWS model inputs)

Alb_max0.14

Model-ready fragment

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

alb:
  value: 0.12
  ref:
    ID: ao2016
    DOI: 10.1175/JAMC-D-16-0082.1
    desc: 'shanghai, central_business_district, site, source bounds 0.12–0.14 (active:
      minimum)'

Evidence review

Awaiting sign-offSign off evidence on GitHub

Raises a prefilled sign-off issue. CI accepts it only when the issue author is in the verifier registry and the evidence revision is still current.

Review procedure

Record metadata

Scopesite
Urban settingCentral business district
Targetland_cover.paved · docs
Origin“Shanghai” (verbatim legacy string)
Schema2026.5 · legacy row 41240030

Used by 1 typology

Same study, same place

all 3 sets from ao2016 at shanghai →
Report an issue