Skip to content

Commit fcb042c

Browse files
committed
Update run-access-issm.md
1 parent 60f16df commit fcb042c

1 file changed

Lines changed: 19 additions & 17 deletions

File tree

docs/models/run_a_model/run_access-issm.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
{% set model = "ACCESS-ISSM" %}
12
{% set model_configurations = "/models/access-issm" %}
23
{% set release_notes = "https://github.com/ACCESS-NRI/ACCESS-ISSM/releases/tag/2025.11.0" %}
34

@@ -126,6 +127,7 @@ python run-mismip.py \
126127
```
127128

128129
Those arguments that accept multiple inputs (e.g. `--steps`, `--storage`, `--module_use`, and `--module_load`) are formatted internally as follows:
130+
129131
* `--steps`: [1, 2]
130132
* `--storage`: `<STORAGE_LOC_1>+<STORAGE_LOC_2>+<STORAGE_LOC_n>`
131133
* `--module_use` and `module_load`:
@@ -172,14 +174,14 @@ The provided execution script supports 9 different experiments comprising differ
172174
A summary of each ice flow approximation and ice flow law is provided below:
173175
174176
* Ice flow approximations:
175-
- Shelfy Stream Approximation (SSA): Assumes that vertical shear is negligible, so ice deformation is dominated by horizonatal stretching and sliding. SSA is ideal for fast-flowing ice streams and ice shelves.
176-
- Higher Order (HO): Includes both vertical and shear membrane stresses, providing a balance between accuracy and computational cost for grounded ice with moderate flow complexity.
177-
- Full-stokes (FS): The complete set of Stokes equations, cpaturing all stress components and deformation modes for the most physically accurate representation of ice flow dynamics.
177+
- **Shelfy Stream Approximation (SSA):** Assumes that vertical shear is negligible, so ice deformation is dominated by horizonatal stretching and sliding. SSA is ideal for fast-flowing ice streams and ice shelves.
178+
- **Higher Order (HO):** Includes both vertical and shear membrane stresses, providing a balance between accuracy and computational cost for grounded ice with moderate flow complexity.
179+
- **Full-stokes (FS):** The complete set of Stokes equations, cpaturing all stress components and deformation modes for the most physically accurate representation of ice flow dynamics.
178180
179181
* Ice flow laws:
180-
- Glen: Power-law relationship that links ice strain rate to stress, desribing how ice deforms under load with a stress exponent of 3.
181-
- Glen (Enhanded): Applies a multiplicative enhancement factor to the standard Glen law to represent softer or damaged ice that deforms more easily.
182-
- Estar: Introduces effective viscosity that blends Glen-type creep with additional physics, providing a smoother, more stable response in fast-flowing or highly-variable regions.
182+
- **Glen:** Power-law relationship that links ice strain rate to stress, desribing how ice deforms under load with a stress exponent of 3.
183+
- **Glen (Enhanded):** Applies a multiplicative enhancement factor to the standard Glen law to represent softer or damaged ice that deforms more easily.
184+
- **Estar:** Introduces effective viscosity that blends Glen-type creep with additional physics, providing a smoother, more stable response in fast-flowing or highly-variable regions.
183185
184186
### Running MISMIP+ Model 1
185187
@@ -220,19 +222,19 @@ Without changing any of the default options, this should generate an output simi
220222
Below, we provide a brief overview of the key "steps" contained in the example MISMIP configuration provided here:
221223

222224
* **Steps 1 - 2: Model parameterisation**
223-
- Step 1 - Mesh generation: This step generates an anisotropic model mesh based on the resolution requested (see Section 3.4).
224-
- Step 2 - Model configuration and initial conditions: This step configures the model components and sets initial conditions based on the model requested (see Section 3.4).
225+
- **Step 1 - Mesh generation:** This step generates an anisotropic model mesh based on the resolution requested (see Section 3.4).
226+
- **Step 2 - Model configuration and initial conditions:** This step configures the model components and sets initial conditions based on the model requested (see Section 3.4).
225227

226228
* **Steps 3 - 8: Model initialisation**
227-
- Step 3 - Initial transient relaxation: This step performs a 200,000 year relaxation transient stress balance.
228-
- Step 4 - Second transient relaxation: This step performs a second 200,000 year relaxation transient stress balance, using the final state of Step 3 as the initial conditions.
229-
- Step 5 - Third transient relaxation: This step performs a third 200,000 year relaxation transient stress balance, using the final state of Step 4 as the initial conditions.
230-
- Step 6 - Fourth transient relaxation: This step performs a fourth 200,000 year relaxation transient stress balance, using the final state of Step 5 as the initial conditions.
231-
- Step 7 - Fifth transient relaxation: This step performs a fifth 200,000 year relaxation transient stress balance, using the final state of Step 6 as the initial conditions.
232-
- Step 8 - 3D Extrusion: This steps perfoms a 3D extrusion from a 2D model mesh to a 3D model mesh, using the final stats of Step 7 as the initial conditions.
229+
- **Step 3 - Initial transient relaxation:** This step performs a 200,000 year relaxation transient stress balance.
230+
- **Step 4 - Second transient relaxation:** This step performs a second 200,000 year relaxation transient stress balance, using the final state of Step 3 as the initial conditions.
231+
- **Step 5 - Third transient relaxation:** This step performs a third 200,000 year relaxation transient stress balance, using the final state of Step 4 as the initial conditions.
232+
- **Step 6 - Fourth transient relaxation:** This step performs a fourth 200,000 year relaxation transient stress balance, using the final state of Step 5 as the initial conditions.
233+
- **Step 7 - Fifth transient relaxation:** This step performs a fifth 200,000 year relaxation transient stress balance, using the final state of Step 6 as the initial conditions.
234+
- **Step 8 - 3D Extrusion:** This steps perfoms a 3D extrusion from a 2D model mesh to a 3D model mesh, using the final stats of Step 7 as the initial conditions.
233235

234236
* **Steps 9 - 17: MISMIP Model experiments**
235-
- Steps 9 - 17 relate to individual MISMIP experiments, summarised in Section 4.3.
237+
- **Steps 9 - 17** relate to individual MISMIP experiments, summarised in Section 4.3.
236238

237239
#### Model parameterisation
238240
Steps 1 and 2 are both required for complete model parameterisation. These steps can typically be executed on a _Gadi_ login node and do not require a PBS job submission. To run steps 1 and 2, run:
@@ -263,7 +265,7 @@ Launching solution sequence on Gadi via SSH...
263265
Model results must be loaded manually with md = loadresultsfromcluster(md).
264266
```
265267

266-
where `<PBS_NUMBER>` will be your unique PBS job number. You can monitor the status of the PBS job using `qstat <PBS_NUMBER>`. Once the job is complete, you can retrieve the results of the model run and save these as a NetCDF file by simply running the same command and adding the `--load_only` argument, as follows:
268+
where `<PBS_NUMBER>` will be your unique PBS job number. You can monitor the status of the PBS job using `qstat <PBS_NUMBER>`. Once the model simulation begins, an `*.outbin` file will be created in the subdirectory. This file will grow in size as the run continues and results are saved to file. Once the model run is completed, you can retrieve the results of the model run from the `*.outbin` file and save these as a NetCDF file by simply running the same command and adding the `--load_only` argument, as follows:
267269

268270
```bash
269271
cd ~/ACCESS-ISSM/examples/mismip/
@@ -312,7 +314,7 @@ Steps 9 - 17 execute each of the MISMIP experiments, as follows:
312314
!!! warning
313315
The Full-stokes experiments are included for completeness, although they are untested and reserved for advanced users. To run the Full-stokes experiments, users must edit the `run-mismip.py` directly to remove current warnings and build upon the current implementation. See [Editing the MISMIP configuration](#editing-the-mismip-configuration) for more information.
314316

315-
To run a given MISMIP experiment, simply execute the same commands as above, with the corresponding step number. For exaple, to run the Glen_SSA experiment, simply run:
317+
To run a given MISMIP experiment, simply execute the same commands as above, with the corresponding step number. For example, to run the Glen_SSA experiment, simply run:
316318

317319
```bash
318320
cd ~/ACCESS-ISSM/examples/mismip/

0 commit comments

Comments
 (0)