Skip to content

Conversation

@sunt05
Copy link

@sunt05 sunt05 commented Dec 1, 2025

Summary

  • Update forcing-data.rst introduction to specify that meteorological data should be within the inertial sublayer (blended response above roughness elements)
  • Add new "Forcing Height" section explaining the urban boundary layer structure (UCL, RSL, ISL) and why forcing height matters
  • Include YAML configuration example for setting the z parameter
  • Improve z parameter description in site.py data model to explain the inertial sublayer requirement

Changes

  1. Introduction update: Clarifies that forcing data should be "representative of the neighbourhood scale, within the inertial sublayer"
  2. New Forcing Height section: Explains UCL → RSL → ISL structure and why forcing height must be within the ISL
  3. Improved z parameter description: Now reads "Height at which forcing data are specified, should be within the inertial sublayer above the blending height where values are spatially representative of the urban neighbourhood"

Test plan

  • Docs build successfully (make docs)
  • Cross-reference to RSL module documentation verified

Closes #953

🤖 Generated with Claude Code

@sunt05 sunt05 temporarily deployed to github-pages-preview December 1, 2025 12:48 — with GitHub Actions Inactive
@github-actions
Copy link

github-actions bot commented Dec 1, 2025

🔍 Schema Preview Deployed

Preview URLs:

Production URLs (unchanged):


⚠️ Important: Preview schemas are in a subdirectory and do not affect production. The preview pages include warning banners to prevent accidental use in production configs.

@sunt05 sunt05 marked this pull request as draft December 1, 2025 12:49
@sunt05 sunt05 force-pushed the sunt05/doc-forcing-height branch from 952124c to 7fdf4e7 Compare December 1, 2025 12:53
@sunt05 sunt05 temporarily deployed to github-pages-preview December 1, 2025 12:53 — with GitHub Actions Inactive
@sunt05 sunt05 force-pushed the sunt05/doc-forcing-height branch from 7fdf4e7 to 09949ed Compare December 1, 2025 14:28
@sunt05 sunt05 temporarily deployed to github-pages-preview December 1, 2025 14:28 — with GitHub Actions Inactive
@sunt05 sunt05 force-pushed the sunt05/doc-forcing-height branch from 09949ed to fbbeabe Compare December 1, 2025 14:29
@sunt05 sunt05 had a problem deploying to github-pages-preview December 1, 2025 14:29 — with GitHub Actions Failure
@sunt05 sunt05 had a problem deploying to github-pages-preview December 1, 2025 15:12 — with GitHub Actions Failure
- Update forcing-data.rst introduction to specify that meteorological
  data should be within the inertial sublayer (blended response above
  roughness elements)
- Add new "Forcing Height" section explaining the urban boundary layer
  structure (UCL, RSL, ISL) and why forcing height matters
- Include YAML configuration example for setting the z parameter
- Improve z parameter description in site.py data model to explain
  the inertial sublayer requirement

Closes #953

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@sunt05 sunt05 force-pushed the sunt05/doc-forcing-height branch from fbbeabe to 9de8f92 Compare December 1, 2025 21:06
@sunt05 sunt05 temporarily deployed to github-pages-preview December 1, 2025 21:06 — with GitHub Actions Inactive
@sunt05 sunt05 marked this pull request as ready for review December 1, 2025 21:07
@sunt05 sunt05 enabled auto-merge December 1, 2025 21:08
@sunt05 sunt05 disabled auto-merge December 1, 2025 21:08
@sunt05 sunt05 requested a review from suegrimmond December 1, 2025 21:11
============================

SUEWS requires continuous meteorological data to drive the urban energy and water balance calculations. This page describes the format and requirements for forcing data files.
SUEWS requires continuous meteorological data representative of the neighbourhood scale, within the inertial sublayer (i.e. a blended response above the roughness elements of buildings and trees), to drive the urban energy and water balance calculations. This page describes the format and requirements for forcing data files.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @suegrimmond , please review this - thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Height of forcing data - needs to be indicated

2 participants