Skip to content

docs: clarify goSPL coupling limitations - #92

Merged
chaseshyu merged 1 commit into
masterfrom
docs/gospl-coupling-limitations
Sep 15, 2026
Merged

chaseshyu merged 1 commit into
masterfrom
docs/gospl-coupling-limitations

Conversation

@echoi

@echoi echoi commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a "Known Limitations" section to gospl_driver/README.md covering three behaviors clarified while reviewing the coupling scheme for the manuscript:
    • The coupling interval (gospl_coupling_interval_in_yr) only gates when coupling fires; DES's actual dt is passed to goSPL as-is, not clamped to the configured interval.
    • A remesh occurring mid-coupling-interval doesn't disturb the coupling clock or reset goSPL's elevation state, but the time-averaged-velocity calculation's node-count-only guard can miss a remesh that happens to preserve the top-boundary node count, silently differencing unrelated nodes.
    • The goSPL mesh domain (padding around the DES model's initial surface extent) is fixed at initialization and never regenerated, so the padding fraction effectively bounds how much lateral extension the DES model can accumulate before hitting boundary artifacts.
  • Fixes a stale comment on GoSPLDriver::needs_elevation_reset in gospl-driver.hpp that incorrectly claimed the flag is re-armed after remeshing (it is not, in the current implementation).

Test plan

  • Documentation-only change; no code behavior modified.
  • Reviewed rendered Markdown for formatting.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Rqf5nW3ahreo3Skp1Lpss6

…d domain padding

Documents three behaviors that came up while reviewing the coupling
scheme for the manuscript: the coupling interval only gates *when*
coupling fires (DES's dt is used as-is, not clamped to it); a remesh
mid-interval doesn't disturb the coupling clock or reset GoSPL's
elevation, but the time-averaged-velocity node-count guard can miss a
remesh that preserves node count; and the goSPL mesh domain is fixed
at init, so its padding fraction effectively bounds how much lateral
extension the DES model can accumulate. Also fixes a stale comment on
needs_elevation_reset that no longer matches the implementation.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Rqf5nW3ahreo3Skp1Lpss6
@chaseshyu
chaseshyu merged commit c59fcca into master Sep 15, 2026
32 of 35 checks passed
@chaseshyu
chaseshyu deleted the docs/gospl-coupling-limitations branch September 15, 2026 02:41
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.

2 participants