Edit or run this notebook

Climate Model Interface Demo

Here we setup, run and plot the MIT general circulation model interactively via MITgcmTools.jl that can generate something like this for the Atmosphere:

plot

15.5 μs

Select Model Configuration

Note: changing this top level parameter should update multiple-choice menus and results below

7.6 μs
133 ms
  ID            = 313995df-2330-49dd-9e21-152c4d4514ba
  model         = MITgcm
  configuration = global_with_exf
  folder        = /tmp
  log subfolder = 313995df-2330-49dd-9e21-152c4d4514ba/log
5.3 μs

Where Is mitgcmuv located?

The model executable mitcmuv is generally found in the $(MITgcm_path)/verification/$(configuration)/build/ subfolder of the selected model configuration.

If mitcmuv is not found at this stage then it is assumed that the chosen model configuration has never been compiled – such that we need to compile and run the model a first time. This might take a lot longer than a normal model run due to the one-time cost of compiling the model.

Once mitgcmuv is found, then the executable file name should appear just below.

7.6 μs
"/home/runner/.julia/artifacts/c1054339e0822e847d82dd219680aa150eb3433f/MITgcm-checkpoint67s/verification/global_with_exf/build/mitgcmuv"
73.8 s

Browse Model Parameters

Once the model has been setup for the selected configuration, then data and PARM01 should be found in the model run directory which should appear just below.

Once model has been compiled and the run directory setup, we are ready to call launch(exps[iexp]) and thus run the model as done below. If an error message suggests that something has gone wrong, sometimes it helps to run the clean(exps[iexp]) and restart this notebook.

6.1 μs
"/tmp/313995df-2330-49dd-9e21-152c4d4514ba/run"
100 ns
19.0 ms
280 ms
55.0 ms
500 ns

Modify Parameters

In the example just below, we change the run duration for the global_with_exf configuration.

Selecting Update Parameter File triggers the following sequence:

  • update file in the run directory

  • launch the model

  • update the plot accordingly

Note: some configurations use nTimeSteps, others use endTime, but using both at once generates an error message.

6.1 ms
101 ms
"🐎"
174 ms

Run Model

Click on button when ready to run the model global_with_exf.

This should also happen automatically after modifying parameters.

22.7 μs
29.7 μs
"🏁"
3.9 s

Plot Model Result

Here we show average temperature in global_with_exf

11.9 μs
6.4 s

Appendices

3.1 μs
"🏁"
60.4 s
"🏁"
339 ms
"🏁"
1.0 s
"🏁"
23.9 μs
"🏁"
1.8 s

plot

6.2 μs
Loading...i