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)
When the session starts, you will see the following session summary:
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:
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
.
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.
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.)