COSIMA
Ocean and sea-ice model analysis tools and examples.
https://github.com/cosima/cosima-recipes
Category: Cryosphere
Sub Category: Sea Ice
Keywords
climate-analysis climate-model climate-science jupyter ocean-modelling python sea-ice
Keywords from Contributors
ocean climate mom6 regional-model oceanography eddies med-team model-evaluation
Last synced: 1 day ago
JSON representation
Repository metadata
A cookbook ๐ of recipes (i.e., examples) for analysing ocean and sea ice model output. ๐ฉ๐ฝโ๐ณ๐๐จ๐ปโ๐ณ
- Host: GitHub
- URL: https://github.com/cosima/cosima-recipes
- Owner: COSIMA
- License: apache-2.0
- Created: 2018-10-12T01:09:50.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-11-27T23:49:59.000Z (27 days ago)
- Last Synced: 2025-12-07T16:49:19.393Z (17 days ago)
- Topics: climate-analysis, climate-model, climate-science, jupyter, ocean-modelling, python, sea-ice
- Language: Jupyter Notebook
- Homepage: https://cosima-recipes.readthedocs.io
- Size: 202 MB
- Stars: 57
- Watchers: 14
- Forks: 75
- Open Issues: 66
- Releases: 4
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.rst
- License: LICENSE
- Zenodo: .zenodo.json
README.md
COSIMA Cookbook
This repository is a Cookbook of Recipes ๐ฉ๐ฝโ๐ณ ๐จ๐ปโ๐ณ.
A collection of cooking lessons and recipes for analysing ocean and sea ice model output produced by the Consortium for Ocean-Sea Ice Modelling in Australia (COSIMA).
We explain: a "cooking lesson" here is a tutorial that teaches you something generic (e.g. about plotting or loading data); a "recipe" is an example of an analysis of some ocean-sea ice model output or some ocean-related observational datasets.
Both "cooking lessons" and "recipes" come in self-contained and well-documented Jupyter notebooks.
All the lessons and the recipes combined form a cookbook ๐!
Most recipes use output from the ACCESS-OM2 model, while some also use results from configurations of the Modular Ocean Model 6 (MOM6) and remote sensing observations.
To access the data used in these recipes you need an account with the Australian-based National Computational Infrastructure (NCI).
To get started, clone this repository in your local space on one of the NCI HPC machines so you can have access to model output. You should then be able to run these recipes (i.e., example analyses) through an Australian Research Environment (ARE) JupyterLab session running python or via any other way you might want to run a Jupyter notebook on an NCI HPC machine. You need to join projects xp65, ik11, cj50, and ol01 to run the recipes and access the data analysed.
If you plan to use an ARE session, then remember to include the projects in the Storage line: gdata/xp65+gdata/ik11+gdata/cj50+gdata/ol01 as well as any of your own project you need access to. In Module directories, set /g/data/xp65/public/modules and in Modules set conda/analysis3. Use a Compute Size of large or greater.
If you have never used the NCI see these first steps instructions and getting started with ARE.
Contents
-
Cooking Lessons 101 (Tutorials)
The starting point should be all the Basic Tutorials:
-
Basics
The Introduction: loading, slicing, dicing model output should be the starting point.
Recipes load model output to using an intake catalogue. The intake package is available on the conda-analysis python environments on
xp65. The ACCESS-NRI_Intake_Catalog tutorial outlines the basic philosophy of the Intake catalog to load model output variables.Also included here are some other tutorials, related to techniques (e.g., Maps_with_Cartopy.ipynb).
After going through the Basic Tutorials, feel free to browse some of the Advanced ones:
-
Recipes
The main part of this cookbook: All the recipes!
These are Jupyter notebooks for either simple or not-so-simple diagnostics and analyses. All recipes are aimed to be self-contained and well-documented and explained.
If you can find a recipe that suits your purposes, then this is the best place to start.
-
Appetisers (easy)
Easier/simpler recipes; a good place to start after youโve been through the Cooking Lessons 101 (Tutorials)
-
Mains (advanced)
More elaborate/advanced recipes.
-
Local Dishes (regional Configurations)
Recipes for regional configurations.
Conditions of use for ACCESS-OM2 output
We request that users of ACCESS-OM2 model code or output consider:
-
citing Kiss et al. (2020) (http://doi.org/10.5194/gmd-13-401-2020)
-
including an acknowledgement such as the following:
The authors thank the vibrant community of the Consortium for Ocean-Sea Ice Modelling in Australia (COSIMA; http://www.cosima.org.au) for making the ACCESS-OM2 suite of models available at https://github.com/COSIMA/access-om2.
-
let us know of any publications which use these models or data so we can add them to our list.
Contributing
Have you made a recipe for analysing something that is not already included in this cookbook?
You are more than welcome to share it and include it in the cookbook!
Consider contributing your recipe back to the repository.
We are always delighted to expand the cookbook with more recipes.
If the process of contributing to the repository sounds a bit intimidating to you, rest assured that we will guide you and help you with submitting your contribution.
To make a contribution follow the steps laid out in the beginner's guide on how to contribute. If they sound intimidating then don't worry!
Just raise an issue explaining briefly what the contribution you want to make is and we'll help out with the process!
Contributors to the COSIMA Cookbook are added to the citable DOI entry associated with the repository.
Hence, users who put together a pull request for a new contribution, should ensure that the pull request also modifies the .zenodo.json file to include their affiliation details.
Citation
If you use a recipe from the Cookbook for your research or teaching, or have based your analysis on one of the recipes, we would be grateful if you could cite:
Owner metadata
- Name: COSIMA
- Login: COSIMA
- Email:
- Kind: organization
- Description: Consortium for Ocean-Sea Ice Modelling in Australia
- Website: http://cosima.org.au
- Location: Australia
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/12704607?v=4
- Repositories: 70
- Last ynced at: 2023-08-24T18:07:05.486Z
- Profile URL: https://github.com/COSIMA
GitHub Events
Total
- Create event: 65
- Commit comment event: 1
- Release event: 3
- Delete event: 81
- Member event: 5
- Pull request event: 150
- Fork event: 10
- Issues event: 103
- Watch event: 9
- Issue comment event: 713
- Push event: 311
- Gollum event: 4
- Pull request review comment event: 130
- Pull request review event: 158
Last Year
- Create event: 59
- Commit comment event: 1
- Release event: 2
- Delete event: 77
- Member event: 5
- Pull request event: 140
- Fork event: 10
- Issues event: 98
- Watch event: 8
- Issue comment event: 676
- Push event: 295
- Gollum event: 4
- Pull request review comment event: 125
- Pull request review event: 145
Committers metadata
Last synced: 10 days ago
Total Commits: 501
Total Committers: 53
Avg Commits per committer: 9.453
Development Distribution Score (DDS): 0.593
Commits in past year: 96
Committers in past year: 20
Avg Commits per committer in past year: 4.8
Development Distribution Score (DDS) in past year: 0.729
| Name | Commits | |
|---|---|---|
| Navid C. Constantinou | n****y | 204 |
| Andy Hogg | A****g@a****u | 59 |
| Angus Gibson | a****s@a****e | 29 |
| Romain Beucher | r****r@a****u | 26 |
| Charles Turner | 5****1 | 25 |
| Anton Steketee | 7****e | 19 |
| Aidan Heerdegen | a****n@a****u | 13 |
| Adele Morrison | a****n@a****u | 11 |
| Ryan Holmes | h****m@g****m | 11 |
| Julia Neme | j****e@u****u | 9 |
| Andrew Kiss | 3****s | 7 |
| Lidefi87 | l****7@h****m | 7 |
| Marc White | m****6@g****m | 7 |
| Micael Oliveira | m****a@a****u | 5 |
| claireyung | 6****g | 5 |
| ongqingyee | 5****e | 4 |
| Wilma Huneke | W****e@a****u | 4 |
| Ed Doddridge | e****e | 4 |
| Christina Schmidt | 3****a | 3 |
| Christopher Bull | 5****3 | 3 |
| Claire Yung | c****4@v****l | 3 |
| Hannah | 6****n | 3 |
| James Munroe | j****e@m****a | 3 |
| Wilton Aguiar | 7****r | 3 |
| Fabio Boeira Dias | f****d@g****m | 2 |
| Madi Rosevear | m****r@u****u | 2 |
| jemmajeffree | 9****e | 2 |
| Claire Yung | c****4@v****l | 2 |
| James Munroe | j****4@g****u | 2 |
| Paige Martin | p****7@g****u | 1 |
| and 23 more... | ||
Committer domains:
- anu.edu.au: 7
- gadi-login-01.gadi.nci.org.au: 2
- gadi-login-04.gadi.nci.org.au: 2
- agibson.me: 1
- unsw.edu.au: 1
- vdi-n17.novalocal: 1
- mun.ca: 1
- utas.edu.au: 1
- vdi-n24.novalocal: 1
- gadi-cpu-clx-0715.gadi.nci.org.au: 1
- gadi-login-03.gadi.nci.org.au: 1
- vdi-n22.novalocal: 1
- vdi-n26.novalocal: 1
- gadi-cpu-clx-2125.gadi.nci.org.au: 1
- vdi-n14.novalocal: 1
- vdi-n15.novalocal: 1
- gadi-login-02.gadi.nci.org.au: 1
- alumni.usp.br: 1
- unimelb.edu.au: 1
Issue and Pull Request metadata
Last synced: 20 days ago
Total issues: 180
Total pull requests: 405
Average time to close issues: about 1 year
Average time to close pull requests: about 1 month
Total issue authors: 39
Total pull request authors: 44
Average comments per issue: 4.29
Average comments per pull request: 5.64
Merged pull request: 291
Bot issues: 0
Bot pull requests: 0
Past year issues: 53
Past year pull requests: 131
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 11 days
Past year issue authors: 16
Past year pull request authors: 23
Past year average comments per issue: 3.38
Past year average comments per pull request: 4.18
Past year merged pull request: 96
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- navidcy (53)
- adele-morrison (39)
- AndyHoggANU (12)
- anton-seaice (7)
- rbeucher (6)
- claireyung (5)
- aidanheerdegen (5)
- julia-neme (4)
- charles-turner-1 (4)
- jmunroe (4)
- aekiss (3)
- schmidt-christina (3)
- taimoorsohail (3)
- dougiesquire (2)
- wghuneke (2)
Top Pull Request Authors
- navidcy (126)
- rbeucher (76)
- charles-turner-1 (34)
- anton-seaice (25)
- julia-neme (20)
- angus-g (13)
- adele-morrison (13)
- marc-white (11)
- AndyHoggANU (7)
- chrisb13 (6)
- lidefi87 (5)
- ashjbarnes (5)
- willaguiar (4)
- claireyung (4)
- micaeljtoliveira (4)
Top Issue Labels
- ๐น๏ธ hackathon 4.0 (35)
- ๐ป hackathon 2.0 (26)
- ๐ฎ hackathon 3.0 (16)
- โ question (14)
- ๐ฃ good first issue (12)
- ๐บ hackathon 1.0 (10)
- ๐ tutorial (10)
- ๐ bug (9)
- ๐ธ updating (7)
- ๐งน cleanup (7)
- ๐ง๐ฝโโ๏ธ enhancement (6)
- ๐ฃ new example (5)
- MOM6 ๐ธ (5)
- MOM5 ๐ (4)
- ๐ hackathon 5.0 (4)
- testing ๐งช (3)
- ๐ฃ new recipe (3)
- technical (2)
- hackathon 4.0 (2)
- documentation ๐ (2)
- staleโ๐ (2)
- MOM5+MOM6 โค๏ธ (2)
- โ invalid (1)
- ARD (1)
- ๐ help wanted (1)
Top Pull Request Labels
- ๐น๏ธ hackathon 4.0 (97)
- ๐ธ updating (46)
- ๐ป hackathon 2.0 (26)
- documentation ๐ (26)
- ๐งน cleanup (22)
- ๐ tutorial (19)
- ready to review โฃ๏ธ (15)
- ๐ฎ hackathon 3.0 (14)
- ๐ bug (12)
- MOM5+MOM6 โค๏ธ (12)
- staleโ๐ (8)
- ๐ฃ new recipe (7)
- testing ๐งช (6)
- ๐ฃ new example (6)
- ๐ hackathon 5.0 (5)
- ๐ง๐ฝโโ๏ธ enhancement (5)
- performance ๐๏ธ (4)
- MOM6 ๐ธ (3)
- MOM5 ๐ (3)
- technical (2)
- ๐ help wanted (1)
- draft (1)
Package metadata
- Total packages: 2
- Total downloads: unknown
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 8
proxy.golang.org: github.com/COSIMA/cosima-recipes
- Homepage:
- Documentation: https://pkg.go.dev/github.com/COSIMA/cosima-recipes#section-documentation
- Licenses: apache-2.0
- Latest release: v0.1.3 (published 4 months ago)
- Last Synced: 2025-12-18T18:07:49.766Z (6 days ago)
- Versions: 4
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
proxy.golang.org: github.com/cosima/cosima-recipes
- Homepage:
- Documentation: https://pkg.go.dev/github.com/cosima/cosima-recipes#section-documentation
- Licenses: apache-2.0
- Latest release: v0.1.3 (published 4 months ago)
- Last Synced: 2025-12-18T18:07:52.088Z (6 days ago)
- Versions: 4
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
Dependencies
- sphinx *
- sphinx-nbexamples *
- actions/cache v2 composite
- actions/checkout v2 composite
- actions/setup-python v2 composite
Score: -Infinity