SUEWS parameter database

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

Evergreen trees · leaf area indexevetr evidence record

lai.lai_type0
lai.lai_min4
lai.lai_max5.1
laievetrshanghaisiteCentral business districtAo 2018

Parameters

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

lai.lai_type0
lai.lai_min4
lai.lai_max5.1

Provenance evidence

Awaiting sign-off

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

Evaluation of the Surface Urban Energy and Water balance Scheme (SUEWS) at a dense urban site in Shanghai: Sensitivity to anthropogenic heat and irrigationParameter source

Where: Table 1, SUEWS model parameter values at XJH, p. 1987

Publishes Evergreen Tree maximum LAI 5.1 and minimum LAI 4 for the Xujiahui study run.

Where: Section 2d, SUEWS model setup and LAI equations, p. 1988

States that SUEWS v2017a is used, defines thermal-only senescence Eq. (5b) and the alternative day-length Eq. (5c), rejects Eq. (5c) as unsuitable at Xujiahui, and explicitly adopts Eq. (5b).

SUEWS v2017a source codeInput observations

Applies to: parameters.lai.lai_type

Where: suews_phys_dailystate.f95, v2017a LAIType branches

LAIType below 0.5 uses the thermal-only senescence branch; LAIType at or above 0.5 adds the 12-hour day-length condition. Therefore stored integer 0 represents Ao Eq. (5b), while 1 represents the Eq. (5c) branch the paper rejects.

The Surface Urban Energy and Water Balance Scheme (SUEWS): Evaluation in Los Angeles and Vancouver.Input observations

Applies to: parameters.lai.lai_min, parameters.lai.lai_max

Where: Table 2, model parameter values by surface type, p. 223

Publishes coniferous-tree LAI minimum 4 and maximum 5.1; the maximum carries a Breuer et al. footnote.

Plant parameter values for models in Temperate climatesInput observations

Applies to: parameters.lai.lai_max

Where: Table 7, parameter values for global temperate land covers, p. 286

Publishes median LAI 5.1 for coniferous forest. It supplies the older maximum lineage but not the minimum 4 or the Shanghai equation choice.

Development of the Surface Urban Energy and Water Balance Scheme (SUEWS) for cold climate citiesLater compilation

Applies to: parameters.lai.lai_min, parameters.lai.lai_max

Where: Table 4, SUEWS parameters by surface, p. 1701

Repeats evergreen maximum 5.1 and minimum 4.0 before their use in the Shanghai application.

SUEWS database pre-migration workbook: database.xlsxLater compilation

Applies to: parameters.lai.lai_type, parameters.lai.lai_min, parameters.lai.lai_max

Where: Pre-migration Leaf Area Index row 31240018

Preserves the migrated 1/4/5.1 tuple and Ao reference. It establishes lineage but not scientific support for selector 1, which contradicts Ao's adopted equation under v2017a semantics.

Assessment findings

Namesupported
Ao et al. use the SUEWS Evergreen Tree class for the Xujiahui application.
Targetsupported
Ao et al. publish the LAI bounds and phenology choice for the SUEWS evergreen-tree land-cover class.
Valuessupported
Ao et al. publish minimum 4 and maximum 5.1 and explicitly adopt thermal-only senescence Eq. (5b). SUEWS v2017a maps that branch to LAIType 0; the migrated value 1 instead selects the rejected day-length branch and is corrected to 0.
Sourcesupported
Ao et al. directly publish the complete Xujiahui model-input assertion represented by this record. Järvi and Breuer preserve the older bound lineage, while the v2017a source code supplies the numeric selector semantics.
Placesupported
The tuple is published as an input to the Xujiahui study-site run in Shanghai; older input lineage does not change the application identity of the published tuple.
Representativenesssupported
Ao et al. apply the tuple to the Xujiahui source area and do not establish city-wide reach.
Urban Settingsupported
Ao et al. describe Xujiahui as a dense central business district.
Methodsupported
The database adopts a published SUEWS input tuple and its source-established equation choice without performing a new measurement, fit, or calculation.
Identitysupported
The stable path and legacy ID preserve the Shanghai evergreen-LAI record while correcting the selector value that contradicted the named publication and model version.

Scientific note

Ao et al. (2018) use SUEWS v2017a, publish evergreen LAI bounds 4 and 5.1, and explicitly adopt the thermal-only leaf-off Eq. (5b) after rejecting the alternative Eq. (5c) because its day-length trigger is unsuitable at Xujiahui. The v2017a source code maps LAIType 0 to that thermal-only branch and LAIType 1 to the day-length branch. The migrated selector 1 therefore contradicts both the paper and the cited model version; changing it to 0 restores the published configuration. Older Järvi and Breuer tables document the inherited bound lineage without replacing Ao as the publication of the complete Shanghai input tuple.

Model-ready fragment

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

lai:
  lai_type:
    value: 0
    ref:
      ID: ao2018
      DOI: 10.1175/JHM-D-18-0057.1
      desc: shanghai, central_business_district, site
  lai_min:
    value: 4
    ref:
      ID: ao2018
      DOI: 10.1175/JHM-D-18-0057.1
      desc: shanghai, central_business_district, site
  lai_max:
    value: 5.1
    ref:
      ID: ao2018
      DOI: 10.1175/JHM-D-18-0057.1
      desc: shanghai, central_business_district, site

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.evetr · docs
Origin“Shanghai” (verbatim legacy string)
Schema2026.5 · legacy row 31240018

Same study, same place

all 4 sets from ao2018 at shanghai →
Report an issue