Skip to content

Model Live Diagnostics

What is Model Live Diagnostics?

Model Live Diagnostics is a simple, accessible and easy-to-use Jupyter notebook-based framework for the ACCESS modelling community to monitor, visualise and evaluate the behaviour of models in real time (live) while they run on Gadi.

In addition to monitoring a live model, the package also provides the functionality to load, visualise and compare legacy ACCESS model data with the live model.

Below, we show an example of the Model Live Diagnostics Tool. For more information and tutorials, please visit Model Diagnostics Documentation.

Example: Monitoring total seawater mass of an ACCESS-CM2 run

This example provides a brief demonstration of how the Model Live Diagnostics tool can be use to monitor the progress of an ACCESS Coupled Model 2 (ACCESS-CM2) run.

To start a session that automatically checks for new model output within a given period of 20 minutes:

import med_diagnostics
session = med_diagnostics.session.CreateModelDiagnosticsSession(model_type='CM2', model_path='path/to/your/live/model/data/output', period=20)
For more details on paths and packages refer to the ACCESS-NRI Model Diagnostics documentation.

When the session starts, you will see the following session summary:

Output of the Model Live Diagnostics after a session has been started and a new catalogue is being built.
The blue status message box appears while the new intake catalogue is being built from the live model data. Depending on the size of the model data, this can take several minutes.

Once the live model data catalogue has been successfully built, the blue status message will update.
The orange status message will report the time and date of the last live model catalogue build, as shown below:

Output of the Model Live Diagnostics after the catalogue has been built.

All available datasets for the selected model will be listed in the dropdown menu.
Select the dataset that you want to monitor (e.g., ocean_scalar.1mon) and click Load dataset.

Output of the Model Live Diagnostics with a dropdown menu of available datasets.

Once loaded, a plot will display the first data variable selected from the list.
Use the dropdown menu to select and plot any available model variables listed.

Plot of total liquid seawater mass over time of the ‘live’ ACCES CM2 run.

The plot above shows the users own 'live' data so doesn't have a name. It is also possible to load and compare legacy data, such as other previous ACCESS-CM2 model runs (by578 and by578a etc.)

Plot of total liquid seawater mass over time of the ‘live’ ACCES CM2 run when compared to legacy model data.

Last update: November 6, 2024