Skip to content
Ocean and sea-ice model analysis tools and examples.
Branch: master
Clone or download
aekiss Merge pull request #106 from angus-g/database-update
New database structure with corresponding indexing/querying APIs
Latest commit a6d60eb May 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
conda-recipe better directory name Aug 10, 2017
cosima_cookbook Merge pull request #106 from angus-g/database-update May 15, 2019
scripts Merge pull request #106 from angus-g/database-update May 15, 2019
.gitattributes use nbdime to diff notebooks Mar 14, 2017
.gitignore ignore mac debris Aug 1, 2018
.travis.yml Added date time tools (#92) Jul 20, 2018
LICENSE Initial commit Mar 15, 2017 Update README Mar 7, 2019
requirements.txt Update required notebook package version Feb 12, 2019 Update requirements in Feb 7, 2019


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.
  • The COSIMA recipes repository includes example notebooks on which you can base your analyses.
  • The COSIMA recipes template provides you with a template if you want to contribute your own scripts to the analysis.

Getting Started

The easiest way to use the COSIMA Cookbook is via the NCI Virtual Desktop Infrastructure (VDI). The cookbook is preinstalled in the latest conda implemntation on the VDI.

Once you have an account on the VDI, you should:

  1. Clone the COSIMA recipes repository to your local file space.
  2. Start a jupyter notebook session using the following commands:
>> module use /g/data3/hh5/public/modules/
>> module load conda/analysis3-unstable
>> jupyter notebook
  1. Navigate to one of the COSIMA recipes and run the analysis.

Alternatively, you might prefer to download our jupyter VDI script to your local machine to open a jupyer notebook in your local browser window.

Using the Cookbook

The COSIMA Cookbook relies on several components:

  1. There needs to be a database of simulations -- on the NCI system, model output that is stored in the COSIMA space on the hh5 directory.
  2. Once you have access to data, the best place to start is the cosima-recipes repository. Here, there are a series of jupyter notebooks containing examples which explain how you can use the cookbook. There are also some example notebooks here. There's some documentation here but it's very out-of-date - caveat lector.

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 cosima-recipes repository.
  • If you find a problem, or have a suggestion for improvement, please log an issue.
Travis CI Read the Docs
Travis CI Build Status Documentation Status
You can’t perform that action at this time.