Skip to content

Add hydrofracture mask input to ismip7_run/ismip7_ais test case - #989

Merged
trhille merged 8 commits into
MPAS-Dev:mainfrom
trhille:landice/ismip7_run_fracture
Sep 21, 2026
Merged

trhille merged 8 commits into
MPAS-Dev:mainfrom
trhille:landice/ismip7_run_fracture

Conversation

@trhille

@trhille trhille commented Sep 14, 2026 •

Copy link
Copy Markdown
Collaborator

This merge sets up the run to use hydrofracture mask forcing in the isimp7_run/ismip7_ais case. It also fixes an issue with the output path of the ismip7_forcing/fracture case being inconsistent with the atmosphere and ocean_thermal_forcing cases.

This also includes some changes to the ais namelist.landice file and experiment set up, including making start times consistent with initial conditions and updating boundary conditions.

Checklist

  • User's Guide has been updated
  • Developer's Guide has been updated
  • Documentation has been built locally and changes look as expected
  • Document (in a comment titled Testing in this PR) any testing that was used to verify the changes

@trhille trhille changed the title Add hydrofracture mask input to ismip7_run ais test case Add hydrofracture mask input to isimp7_run/ismip7_ais test case Sep 14, 2026
@trhille trhille changed the title Add hydrofracture mask input to isimp7_run/ismip7_ais test case Add hydrofracture mask input to ismip7_run/ismip7_ais test case Sep 15, 2026
@trhille

trhille commented Sep 15, 2026 •

Copy link
Copy Markdown
Collaborator Author

Testing

These changes correctly place the fracture output directories at the same level in the directory structure as atmosphere and ocean_thermal_forcing and set up the appropriate ISMIP7 runs to use hydrofracture. I set up and successfully ran CESM2-WACCM historical and SSP585, as well as OCX. The hydrofracture forcing is only applied in the SSP585 run. Further testing can be found the the accompanying MALI-Dev PR: MALI-Dev/E3SM#187 (comment)

- Fix ismip7_forcing fracture output paths (excess_melt, lake_properties,
  shelf_collapse) to use {model}_{scenario}/{category}/ layout, matching
  atmosphere and ocean_thermal_forcing outputs.
- ismip7_ais: optionally apply the Path C calvingMask via a new
  fracture_basepath cfg option, enabling mask calving and the
  hydrofracture vulnerability gating added in MALI PR MPAS-Dev#187
  (config_require_extensional_stresses_for_mask_calving,
  config_calving_fracture_toughness). Disabled by default and per
  experiment when no mask file is found (e.g. ctrl, ocx).
- users_guide/ismip7_forcing: fix fracture output path examples to the
  corrected {model}_{scenario}/{category}/ layout; document it in the
  Output Layout section.
- users_guide/ismip7_run: document fracture_basepath and
  calving_fracture_toughness config options, the shelf_collapse forcing
  directory, and add a Mask Calving (Path C) section describing the
  hydrofracture vulnerability gating from MALI PR MPAS-Dev#187.
- developers_guide/ismip7_run: note the new mask calving setup step in
  SetUpExperiment.
…rofracture_forcing

- Remove the separate fracture_basepath cfg option; the Path C shelf
  collapse mask is now looked up at
  {forcing_basepath}/{model}_{scenario}/shelf_collapse/, the same tree
  used for atmosphere/ocean forcing.
- Add use_hydrofracture_forcing (default true) to toggle mask calving.
  historical, ctrl, and ocx scenarios never use hydrofracture forcing
  regardless of this setting.
- When use_hydrofracture_forcing is true for any other scenario, the
  mask file is now required: setup fails with an error if it is
  missing, instead of silently leaving mask calving off.
- Update users_guide/ismip7_run, users_guide/ismip7_forcing, and
  developers_guide/ismip7_run docs to match.
- historical/ocx experiments now start in 2007/2008 instead of 1990/2000.
- Add config_fem_extension_method = 'ismip7-era' to AIS and GrIS namelists.
- Drop mode="forward;analysis" from the mask_calving stream.

@matthewhoffman matthewhoffman left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@trhille , I left a number of detailed comments, but I leave it up to you if you want to address any of them before merging. Feel free to merge yourself when you are happy with any additional tweaks.

Comment thread compass/landice/tests/ismip7_run/ismip7_ais/__init__.py
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/namelist.landice
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/set_up_experiment.py Outdated
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/streams.landice.template Outdated
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/streams.mask_calving
Comment thread docs/developers_guide/landice/test_groups/ismip7_run.rst Outdated
Comment thread docs/users_guide/landice/test_groups/ismip7_run.rst Outdated
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/set_up_experiment.py Outdated
Remove a hard-coded setting of config_calving = 'none' when using mask calving. We want to be able to use both internal stress-based calving laws and mask-calving simultaneously.
Comment thread docs/developers_guide/landice/test_groups/ismip7_run.rst Outdated
Comment thread docs/users_guide/landice/test_groups/ismip7_run.rst Outdated
Update docs to remove statements that `config_calving` is set to `'none'` when using mask calving.

Co-authored-by: Trevor Hillebrand <trhille@lanl.gov>
Comment thread compass/landice/tests/ismip7_run/ismip7_ais/streams.landice.template Outdated
Change basicmesh to minmesh to reduce file size.
@trhille
trhille merged commit 93dc255 into MPAS-Dev:main Sep 21, 2026
5 checks passed
@trhille trhille mentioned this pull request Sep 21, 2026
6 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants