SUEWS parameter database

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

Grass · leaf area indexgrass evidence record

lai.lai_type0
lai.lai_min3.2
lai.lai_max5.9
laigrassshanghaisiteCentral business districtAo 2018

Parameters

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

lai.lai_type0
lai.lai_min3.2
lai.lai_max5.9

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 Grass maximum LAI 5.9 and minimum LAI 3.2 for the Xujiahui study run.

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

States that winter and spring photographs show green grass, so the minimum was increased from 1.6 to 3.2; also states that SUEWS v2017a is used, rejects the day-length senescence Eq. (5c), and explicitly adopts the thermal-only 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.

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

Applies to: parameters.lai.lai_min

Where: Table 4, Grass LAI minimum, p. 1701

Publishes the earlier Grass minimum 1.6 that Ao et al. explicitly adjusted for Xujiahui.

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

Applies to: parameters.lai.lai_max

Where: Table 2, Grass LAI maximum, p. 223

Directly publishes LAImax,grass as 5.9 with a Breuer et al. (2003) source footnote.

Plant parameter values for models in Temperate climatesInput observations

Applies to: parameters.lai.lai_max

Where: Table 7, Herbs, forbs, grasses LAI distribution, p. 286

Publishes median LAI 5.9 for herbs, forbs and grasses, with maximum 16.2 and N 77. The later SUEWS table repurposes the median as its LAI maximum.

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 31240020

Preserves the migrated 1/3.2/5.9 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 Grass class for the Xujiahui application.
Targetsupported
Ao et al. publish the LAI bounds and phenology choice for the SUEWS grass land-cover class.
Valuessupported
Ao et al. publish the stored 3.2/5.9 bounds 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. The evidence also records the distinct upstream lineages of both bounds.
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 the complete tuple published by Ao et al.; its sidecar separately records that the minimum was locally adjusted and the maximum inherited from earlier literature.
Identitysupported
The stable path and legacy ID preserve the Shanghai grass-LAI record while correcting the selector value that contradicted the named publication and model version.

Scientific note

Ao et al. (2018) publish the complete Xujiahui grass LAI tuple: they locally adjust the minimum from 1.6 to 3.2 using site photographs, retain the inherited 5.9 maximum, and explicitly adopt thermal-only senescence Eq. (5b). SUEWS v2017a maps that equation to LAIType 0 and maps the migrated selector 1 to the day-length branch that Ao rejects. Changing the selector to 0 restores the published configuration. Järvi and Breuer document the distinct upstream lineages of the bounds without replacing Ao as the publication of the complete Shanghai application tuple.

Model-ready fragment

Paste under land_cover.grass 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: 3.2
    ref:
      ID: ao2018
      DOI: 10.1175/JHM-D-18-0057.1
      desc: shanghai, central_business_district, site
  lai_max:
    value: 5.9
    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.grass · docs
Origin“Shanghai” (verbatim legacy string)
Schema2026.5 · legacy row 31240020

Same study, same place

all 4 sets from ao2018 at shanghai →
Report an issue