The COSIMA Cookbook is a framework for analysing output from ocean-sea ice models. The focus is on the ACCESS-OM2 suite of models being developed and run by members of COSIMA: Consortium for Ocean-Sea Ice Modelling in Australia. But this framework is suited to analysing any MOM5/MOM6 output, as well as output from other models.
The cookbook is structured as follows:
- This repository includes boiler-plate code and scripts that underpin the cookbook.
cosima-recipesrepository includes example notebooks on which you can base your analyses.
cosima-recipestemplate provides you with a template if you want to contribute your own scripts to the analysis.
The easiest way to use the COSIMA Cookbook is through NCI's HPC systems (either VDI or Gadi). The cookbook is preinstalled in the latest
Once you have an account on the VDI, you should:
- Clone the
cosima-recipesrepository to your local file space.
- Start a jupyter notebook session using the following commands:
>> module use /g/data/hh5/public/modules/ >> module load conda/analysis3-unstable >> jupyter notebook
- Navigate to one of the COSIMA recipes and run the analysis.
Alternatively, you might prefer to download
vdi_jupyter or the
gadi_jupyter scripts hosted in the CLEx CMS Github Repository coecms/nci_scripts. These scripts will allow you to open a Jupyter notebook in your local browser window.
Using the Cookbook
The COSIMA Cookbook relies on several components:
- There needs to be a database of simulations -- on the NCI system, model output that is stored in the COSIMA space on the
- Once you have access to data, the best place to start is the
cosima-recipesrepository which includes a series of jupyter notebooks containing examples that guide you through to use the cookbook to load model output and then proceed doing simple (or elaborate) computations. The best starting point of exploring the
cosima-recipesis the Documented Examples. A collection of useful examples leveraging the
cosima-cookbookis also found here.
Contributing to the Cookbook
If you like the cookbook, you may like to interact more closely with us:
- Contributions of new notebooks or analysis scripts are always welcome. Please check out the
- If you find a problem, or have a suggestion for improvement, please log an issue.
- All code submitted as part of the
cosima-cookbookitself must be formatted with black