Skip to content

Review 2.14. Model for Scale Adaptive River Transport (MOSART) #3860

Description

@slevis-lmwg

What sort(s) of documentation issue is this?

  • Something is missing.
  • Something is (or might be) incorrect or outdated.
  • Something is confusing.
  • Something is broken.

What part(s) of the documentation does this concern?

  • Technical Note (science and design of the model)
  • User's Guide (using the model and related tools)
  • Somewhere else (e.g., README file, tool help text, or code comment): Please specify
  • I don't know

Describe the issue

See instructions in the parent issue.

Additional context (optional)

  • 2.14.5 need to be removed about changes since the previous release. This will be done in the What'sNew sections.
  • Change between CLM5.0 and CLM6.0. Looks like default ROF changed from RTM to MOSART. No science has changed, while code refactoring was made.

Activity

  1. added
    documentationadditions or edits to user-facing documentation or its infrastructure
    on Mar 25, 2026
  2. ekluzek commented on Apr 24, 2026

    @ekluzek
    Contributor

    The tag for the previous 2.1 release for MOSART was: release-cesm2.0.04 which corresponds closely to: mosart1_0_35. Looking over the ChangeLog the changes are:

    ### One-line Summary: Fixes needed to work with the ifx compiler
    ### One-line Summary: Add write_restart_at_endofrun functionality to mosart same as in clm
    ### One-line Summary: Fix issue with st archive of rpointer files
    ### One-line Summary: Fix MOSART h0i file metadata
    ### One-line Summary: Separate instantaneous and non-inst. history files
    ### One-line Summary: Standardize time metadata
    ### One-line Summary: Fix for Nag compiler
    ### One-line Summary: Add simulation timestamp to rpointer filenames
    ### One-line Summary: Stop running 0th timestep
    ### One-line Summary: time now equals the middle of the time_bounds
    ### One-line Summary: Add more tests and merge in some other PRs
    ### One-line Summary: cism runoff will be now routed to ocn via mosart
    ### One-line Summary: major mosart refactor including addition of new halo capability
    ### One-line Summary: Remove MCT, some cleanup and high level refactoring
    ### One-line Summary: Change bypass_routing option to direct_to_outlet
    ### One-line Summary: Some fixes for the direct_to_outlet option
    ### One-line Summary: PIO ascynchronus changes
    ### One-line Summary: Handle CLM_ACCELERATED_SPINUP option differently
    ### One-line Summary: Nuopc now the default driver, pass channel depth fields, remove do_rtm namelist
    ### One-line Summary: Change shebang lines to python3, abort if direction file not set, add compset
    ### One-line Summary: Support for threading with NUOPC/CMEPS
    ### One-line Summary: Minor changes for pio2 compatibility
    ### One-line Summary: Addition of flux area correction factors
    ### One-line Summary: Remove nuopc_cap_share from build
    ### One-line Summary: Change compset in test
    ### One-line Summary: Bring updates needed for NUOPC
    ### One-line Summary: Updates to NUOPC cap
    

    So the science changes to highlight from above are:

    1. Stop running 0th timestep
    2. Runoff from glacier model CISM goes through MOSART
    3. Addition of flux area correction factors

    The default settings that change are:

    • bypass_routing to direct_to_outlet
    • Pass channel depth fields

    The infrastructure changes include:

    • rpointer changes
    • time changes so it;'s the middle of the bounds unless instantaneous fields
    • NUOPC is the driver and MCT option removed
  3. ekluzek commented on Apr 24, 2026

    @ekluzek
    Contributor

    Looking at code differences in the cime_config directory:

    bypass_routing to direct_to_outlet (as above)
    qgwl_runoff_option is now negative
    There's a new "use_halo" option that's default off
    There's a few things about tracers

    Looking at the src code tree the refactoring includes renaming files, so it's too extensive to really look through.

  4. moved this from Todo to In Progress in CLM documentationon May 13, 2026
  5. wwieder commented on May 13, 2026

    @wwieder
    Contributor

    Is this review of the MOSART chapter in progress, @nmizukami ?

  6. nmizukami commented on May 13, 2026

    @nmizukami
    Contributor

    I think this can be in progress status. I have not edited the rst file yet. I have looked at tech-note (not very long). As far as I know, there are no scientific changes (i.e., routing process).

    items to check before editing are:

    • any science changes made in code refactoring. I doubt but it would be good to double-check with Mariana?
    • it is now handling ice melt from glacier model, which may be good to mention in the tech note?
    • maybe mention irrigation water abstraction from river (is this new in CLM6 or it was already in CLM5), but it is not mentioned in current tech-note?
    • floodwater computation and feedback to land-model (is it good and mature to mention it? ask Sean)
  7. linked a pull request that will close this issueUpdate to tech note section 2-14 MOSART #4054on May 28, 2026
  8. moved this from In Progress to Done pending master merge in CLM documentationon May 28, 2026
  9. moved this from Done pending master merge to Done in CLM documentationon Jun 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

docs-loc:tech-noteRelates to Technical Note (science)documentationadditions or edits to user-facing documentation or its infrastructure

Projects

Relationships

None yet

Development

No branches or pull requests

Issue actions