diff --git a/.github/workflows/paper-preview.yml b/.github/workflows/paper-preview.yml new file mode 100644 index 00000000..6bfcef06 --- /dev/null +++ b/.github/workflows/paper-preview.yml @@ -0,0 +1,29 @@ +on: [push] + +jobs: + paper: + runs-on: ubuntu-latest + name: Paper Draft + steps: + - name: Checkout + uses: actions/checkout@v5 + - name: Build draft PDF + uses: openjournals/openjournals-draft-action@master + with: + journal: jose + # This should be the path to the paper within your repo. + paper-path: paper/paper.md + - name: Upload + uses: actions/upload-artifact@v4 + with: + name: paper + # This is the output path where Pandoc will write the compiled + # PDF. Note, this should be the same directory as the input + # paper.md + path: paper/paper.pdf + # These lines have been added following + # https://github.com/openjournals/openjournals-draft-action/issues/15 + - name: save pdf to repo + uses: stefanzweifel/git-auto-commit-action@v6 + with: + commit_message: Saved new PDF of paper diff --git a/paper/paper.bib b/paper/paper.bib new file mode 100644 index 00000000..36cfb318 --- /dev/null +++ b/paper/paper.bib @@ -0,0 +1,300 @@ +@software{cosimaCookbook, + author = {Constantinou, Navid C. and + Hogg, Andy McC. and + Gibson, Angus and + Steketee, Anton and + Beucher, Romain and + Proft, Max and + Heerdegen, Aidan and + Neme, Julia and + Holmes, Ryan M. and + Morrison, Adele and + Fierro-Arcos, Denisse and + Kiss, Andrew E. and + Oliveira, Micael and + Yung, Claire and + Doddridge, Edward and + Huneke, Wilma and + Bhagtani, Dhruv and + Ong, Ellie Q. Y. and + Munroe, James and + Schmidt, Christina and + Dawson, Hannah and + Squire, Dougal T. and + Dias, Fabio Boeira and + Jeffree, Jemma and + Moorman, Ruth and + Martínez-Moreno, Josué and + Zika, Jan and + Meijer, Jan Jaap and + Auger, Matthis and + Aguiar, Wilton and + Moore, Thomas and + Vilela da Silva, Felipe and + Yang, Luwei and + White, Marc and + Sohail, Taimoor and + Barnes, Ashley J. and + Spence, Paul and + Turner, Charles and + Rosevear, Madelaine G. and + Bull, Christopher Yit Sen and + Day, Noah and + Li, Minghang and + Ellepola, Anupiya and + Narayanan, Aditya}, + title = {{COSIMA Cookbook: A cookbook of recipes for analysing ocean and sea ice model output}}, + year = {2026}, + doi = {10.5281/zenodo.14353852}, + url = {https://doi.org/10.5281/zenodo.14353852} +} + +@software{sphinx, + author = {Komiya, Takeshi and + Brandl, Georg and + Turner, Adam and + Bakosi, Jean-Francois and + Shimizukawa, Takayuki and + Andersen, Jakob Lykke and + Neuh{\"a}user, Daniel and + Finucane, Stephen and + Lehmann, Robert and + Mason, Jacob and + Kampik, Timotheus and + Addison, James and + Magin, Justus and + Dufresne, Jon and + Waltman, Jonathan and + Eades, Daniel and + Cano Rodr{\'i}guez, Juan Luis and + Ronacher, Armin and + Geier, Matthias and + Shachnev, Dmitry and + Shibukawa, Yoshiki and + Tran, B{\'e}n{\'e}dikt and + Dangoor, Adam and + Sewell, Chris and + Ruana, Rob and + Virtanen, Pauli and + Hoffmann, Tim and + Li{\v{s}}ka, Martin and + Freitag, Fran{\c c}ois}, + title = {{sphinx-doc/sphinx: Sphinx 9.1.0}}, + year = {2025}, + publisher = {Zenodo}, + version = {v9.1.0}, + doi = {10.5281/zenodo.18109073}, + url = {https://doi.org/10.5281/zenodo.18109073} +} + +@article{kiss2020accessom2, + author = {Kiss, Andrew E. and Woodward, Melanie J. and Hollings, T. and Mu, Minyu and Fiedler, Raquel and Steven, Andrew D. L. and Lenton, Andrew and Matear, Richard and Chamberlain, Matthew A. and Oke, Peter R. and Alves, Orly and Griffies, Stephen M. and Hill, Catherine and Kovach, Alexander and Marsland, Simon J. and Fiedler, Rebecca and Waters, Judith and Yang, Chun-Hsu and Zhou, Xiaobing and Savita, Abha and Rymph, Stacey and Bi, D. and Griffin, David and Mackallah, Christian and Underwood, Stuart and Druken, Karina A. and Merati, Nasim and Hogg, Andrew McC.}, + title = {ACCESS-OM2 v1.0: a global ocean-sea ice model at three resolutions}, + journal = {Geoscientific Model Development}, + year = {2020}, + volume = {13}, + number = {2}, + pages = {401--442}, + doi = {10.5194/gmd-13-401-2020}, + url = {https://doi.org/10.5194/gmd-13-401-2020} +} + +@article{hoyer2017xarray, + author = {Hoyer, Stephan and Hamman, Joseph J.}, + title = {{xarray: N-D labeled arrays and datasets in Python}}, + journal = {Journal of Open Research Software}, + year = {2017}, + volume = {5}, + number = {1}, + pages = {10}, + doi = {10.5334/jors.148}, + url = {https://doi.org/10.5334/jors.148} +} + +@incollection{kluyver2016jupyter, + author = {Kluyver, Thomas and Ragan-Kelley, Benjamin and P{\'e}rez, Fernando and Granger, Brian and Bussonnier, Matthias and Frederic, Jonathan and Kelley, Kyle and Hamrick, Jessica and Grout, Jason and Corlay, Sylvain and Ivanov, Paul and Avila, Dami{\'a}n and Abdalla, Safia and Willing, Carol}, + title = {Jupyter Notebooks---a publishing format for reproducible computational workflows}, + booktitle = {Positioning and Power in Academic Publishing: Players, Agents and Agendas}, + editor = {Loizides, Fernando and Schmidt, Birgit}, + publisher = {IOS Press}, + address = {Amsterdam}, + year = {2016}, + pages = {87--90}, + doi = {10.3233/978-1-61499-649-1-87}, + url = {https://doi.org/10.3233/978-1-61499-649-1-87} +} + +@article{barnes2024regionalmom6, + author = {Barnes, Ashley J. and Constantinou, Navid C. and Gibson, Angus H. and Kiss, Andrew E. and Chapman, Chris and Reilly, John and Bhagtani, Dhruv and Yang, Luwei}, + title = {{regional-mom6: A Python package for automatic generation of regional configurations for the Modular Ocean Model 6}}, + journal = {Journal of Open Source Software}, + year = {2024}, + volume = {9}, + number = {100}, + pages = {6857}, + doi = {10.21105/joss.06857}, + url = {https://doi.org/10.21105/joss.06857} +} + +@software{cartopy, + author = {Phil Elson and + Elliott Sales de Andrade and + Greg Lucas and + Ryan May and + Richard Hattersley and + Ed Campbell and + Ruth Comer and + Andrew Dawson and + Bill Little and + Stephane Raynaud and + scmc72 and + Alan D. Snow and + lgolston and + Byron Blay and + Peter Killick and + lbdreyer and + Patrick Peglar and + Nat Wilson and + Andrew and + Jon Szymaniak and + Adrien Berchet and + Corinne Bosley and + Luke Davis and + Filipe and + John Krasting and + Matthew Bradbury and + stephenworsley and + Daniel Kirkham}, + title = {{SciTools/cartopy: v0.24.1}}, + month = oct, + year = 2024, + publisher = {Zenodo}, + version = {v0.24.1}, + doi = {10.5281/zenodo.13905945}, + url = {https://doi.org/10.5281/zenodo.13905945}, +} + +@manual{intake, + author = {{Intake developers}}, + title = {Intake: a lightweight package for finding, investigating, loading and disseminating data}, + year = {2026}, + url = {https://intake.readthedocs.io/en/reader/} +} + +@Article{Delandmeter-vanSebille-2019, + author = {Delandmeter, P. and van Sebille, E.}, + title = {The Parcels v2.0 Lagrangian framework: new field interpolation schemes}, + journal = {Geoscientific Model Development}, + volume = {12}, + year = {2019}, + number = {8}, + pages = {3571--3584}, + doi = {10.5194/gmd-12-3571-2019} +} + +@article{lange2017parcels, + author = {Lange, Michael and van Sebille, Erik}, + title = {Parcels v0.9: prototyping a {Lagrangian} ocean analysis framework for the petascale age}, + journal = {Geoscientific Model Development}, + year = {2017}, + volume = {10}, + number = {11}, + pages = {4175--4186}, + doi = {10.5194/gmd-10-4175-2017}, + url = {https://doi.org/10.5194/gmd-10-4175-2017} +} + +@Manual{dask, + title = {Dask: Library for dynamic task scheduling}, + author = {{Dask Development Team}}, + year = {2016}, + url = {http://dask.pydata.org}, +} + +@software{xgcm, + author = {Abernathey, Ryan P. and + Busecke, Julius J. M. and + Smith, Timothy Andrew and + Deauna, Josephine Dianne and + Banihirwe, Anderson and + Nicholas, Thomas and + Fernandes, Filipe and + James, Bourbeau and + Dussin, Raphael and + Cherian, Deepak A. and + Caneill, Romain and + Sinha, Anirban and + Uieda, Leonardo and + Rath, Willi and + Balwada, Dhruv and + Constantinou, Navid C. and + Ponte, Aurélien and + Zhou, Yuxin and + Uchida, Takaya and + Thielen, Jon}, + title = {{xgcm}}, + month = nov, + year = 2022, + publisher = {Zenodo}, + version = {v0.8.1}, + doi = {10.5281/zenodo.7348619}, + url = {https://doi.org/10.5281/zenodo.7348619}, +} + +@software{xesmf, + author = {Jiawei Zhuang and + Raphael Dussin and + Pascal Bourgault and + David Huard and + Anderson Banihirwe and + Stephane Raynaud and + Brewster Malevich and + Martin Schupfner and + Charles Gauthier and + Filipe and + Sam Levang and + Mattia Almansi and + André Jüling and + RichardScottOZ and + RondeauG and + Stephan Rasp and + Trevor James Smith and + Aaron G. Meyer and + Ben Mares and + Bill Sacks and + Jemma Stachelek and + Matthew Plough and + Pierre and + Ray Bell and + Romain Caneill and + Xianxiang Li}, + title = {{pangeo-data/xESMF: v0.9.2}}, + year = {2025}, + doi = {10.5281/zenodo.4294774}, + url = {https://doi.org/10.5281/zenodo.4294774} +} + +@InProceedings{rocklin2015dask, + author = {Matthew Rocklin}, + title = {Dask: Parallel Computation with Blocked algorithms and Task Scheduling}, + booktitle = {Proceedings of the 14th Python in Science Conference}, + pages = {130--136}, + year = {2015}, + editor = {Kathryn Huff and James Bergstra}, + doi = {10.25080/Majora-7b98e3ed-013} +} + +@Article{Hunter2007matplotlib, + Author = {Hunter, J. D.}, + Title = {Matplotlib: A 2D graphics environment}, + Journal = {Computing in Science \& Engineering}, + Volume = {9}, + Number = {3}, + Pages = {90--95}, + abstract = {Matplotlib is a 2D graphics package used for Python for + application development, interactive scripting, and publication-quality + image generation across user interfaces and operating systems.}, + publisher = {IEEE COMPUTER SOC}, + doi = {10.1109/MCSE.2007.55}, + year = 2007 +} diff --git a/paper/paper.md b/paper/paper.md new file mode 100644 index 00000000..cc0dafb7 --- /dev/null +++ b/paper/paper.md @@ -0,0 +1,346 @@ +--- +title: "COSIMA Cookbook: a community resource for ocean and sea-ice modelling" +tags: + - Jupyter + - oceanography + - sea ice + - computational learning + - reproducible workflows + - Python +authors: + - name: Navid C. Constantinou + orcid: 0000-0002-8149-4094 + equal-contrib: true + affiliation: "4, 13" + - name: Julia Neme + orcid: 0000-0002-3573-996X + equal-contrib: true + affiliation: 2 + - name: Wilton Aguiar + orcid: 0000-0003-2453-9791 + affiliation: 2 + - name: Matthis Auger + orcid: 0000-0001-6228-5732 + affiliation: 16 + - name: Ashley J. Barnes + orcid: 0000-0003-3165-8676 + affiliation: "4, 10" + - name: Romain Beucher + orcid: 0000-0003-3891-5444 + affiliation: 3 + - name: Dhruv Bhagtani + orcid: 0000-0002-1222-375X + affiliation: 11 + - name: Christopher Yit Sen Bull + orcid: 0000-0001-8362-3446 + affiliation: 3 + - name: Hannah Dawson + orcid: 0000-0001-9113-1329 + affiliation: 16 + - name: Noah Day + orcid: 0000-0003-4176-7956 + affiliation: 13 + - name: Fabio Boeira Dias + orcid: 0000-0002-2965-2120 + affiliation: 14 + - name: Edward W. Doddridge + orcid: 0000-0002-6097-5729 + affiliation: 16 + - name: Anupiya Ellepola + orcid: 0009-0002-8898-0068 + affiliation: 2 + - name: Denisse Fierro-Arcos + orcid: 0000-0002-5039-6272 + affiliation: 16 + - name: Angus Gibson + orcid: 0000-0001-7577-3604 + affiliation: 2 + - name: Maurice F. Huguenin + orcid: 0000-0002-1476-0452 + affiliation: 8 + - name: Aidan Heerdegen + orcid: 0000-0002-4481-4896 + affiliation: 3 + - name: Andy McC. Hogg + orcid: 0000-0001-5898-7635 + affiliation: "2, 3, 4" + - name: Ryan M. Holmes + orcid: 0000-0002-6799-9109 + affiliation: 5 + - name: Wilma Huneke + orcid: 0000-0001-8624-365X + affiliation: 2 + - name: Jemma Jeffree + orcid: 0000-0001-7190-7329 + affiliation: "2, 4" + - name: Andrew E. Kiss + orcid: 0000-0001-8960-9557 + affiliation: 2 + - name: Minghang Li + orcid: 0000-0002-6167-9999 + affiliation: 3 + - name: Josué Martínez-Moreno + orcid: 0000-0002-8348-1588 + affiliation: 12 + - name: Jan Jaap Meijer + orcid: 0000-0001-8667-488X + affiliation: 16 + - name: Thomas Moore + orcid: 0000-0003-3930-1946 + affiliation: 7 + - name: Ruth Moorman + orcid: 0000-0001-5054-1559 + affiliation: 6 + - name: Paige Martin + orcid: 0000-0003-3538-633X + affiliation: 3 + - name: Adele K. Morrison + orcid: 0009-0003-5143-5020 + affiliation: 2 + - name: James Munroe + orcid: 0000-0001-9098-6309 + affiliation: 1 + - name: Aditya Narayanan + orcid: 0000-0002-8967-2211 + affiliation: 15 + - name: Micael Oliveira + orcid: 0000-0003-1364-0907 + affiliation: 3 + - name: Ellie Q. Y. Ong + orcid: 0000-0002-0392-7915 + affiliation: "4, 10" + - name: Max Proft + affiliation: 3 + - name: Madelaine G. Rosevear + orcid: 0000-0003-4254-843X + affiliation: "4, 16" + - name: Christina Schmidt + orcid: 0000-0002-7672-5054 + affiliation: 12 + - name: Taimoor Sohail + orcid: 0000-0002-4162-3269 + affiliation: 13 + - name: Paul Spence + orcid: 0000-0001-5156-2204 + affiliation: "4, 16" + - name: Dougal T. Squire + orcid: 0000-0003-3271-6874 + affiliation: 3 + - name: Anton Steketee + orcid: 0009-0002-9081-4106 + affiliation: 3 + - name: Charles Turner + orcid: 0000-0002-3262-4972 + affiliation: 3 + - name: Felipe Vilela da Silva + orcid: 0000-0003-1967-880X + affiliation: 9 + - name: Marc White + orcid: 0000-0003-3882-418X + affiliation: "2, 3" + - name: Luwei Yang + orcid: 0000-0001-8570-7424 + affiliation: 2 + - name: Claire Yung + orcid: 0000-0002-0052-7668 + affiliation: 2 + - name: Jan Zika + orcid: 0000-0003-3462-3559 + affiliation: 14 +affiliations: + - name: 2i2c, USA + index: 1 + - name: Australian National University, Australia + index: 2 + - name: "Australian National University, Australia's Climate Simulator (ACCESS-NRI), Australia" + index: 3 + - name: Australian Research Council Centre of Excellence for the Weather of the 21st Century, Australia + index: 4 + - name: Bureau of Meteorology, Australia + index: 5 + - name: California Institute of Technology, USA + index: 6 + - name: Commonwealth Scientific and Industrial Research Organisation, Australia + index: 7 + - name: GEOMAR Helmholtz Centre for Ocean Research Kiel, Germany + index: 8 + - name: IFREMER - French Institute for Ocean Science, France + index: 9 + - name: Monash University, Australia + index: 10 + - name: Princeton University, USA + index: 11 + - name: British Antarctic Survey, UK + index: 12 + - name: University of Melbourne, Australia + index: 13 + - name: University of New South Wales Sydney, Australia + index: 14 + - name: University of Southampton, UK + index: 15 + - name: University of Tasmania, Australia + index: 16 +date: 26 May 2026 +bibliography: paper.bib + +--- + +# Summary + +The COSIMA Cookbook is an open computational learning module for analysing +ocean and sea-ice model output in Jupyter notebooks +[@kluyver2016jupyter]. It has been developed by +the Consortium for Ocean--Sea Ice Modelling in Australia (COSIMA; ) +as a community resource for researchers, students, and practitioners working +with large gridded datasets, especially output from the ACCESS ocean--sea ice +model configurations [e.g. @kiss2020accessom2]. The repository combines introductory +tutorials with worked analysis examples, all exposed through a browsable +documentation site built with Sphinx, a documentation generator for Python +projects [@sphinx] (\autoref{fig:website}) and backed by a citable archived +release [@cosimaCookbook]. + +![The COSIMA Cookbook documentation website, showing the browsable Sphinx-based +landing page used to navigate tutorials and recipes. The live site is available +at https://cosima-recipes.readthedocs.io. \label{fig:website}](website.png) + +Following the "Cookbook" concept, the website sections are deliberately named +using a gastronomy theme. "Cooking Tutorials" refers to tutorials that teach +generic, transferable techniques for handling ocean--sea ice model output. +Then comes the main part of any cookbook -- its recipes. Here, by "recipes" +we mean self-contained notebooks showing how to perform concrete diagnostics +and analyses on ocean and sea-ice datasets. First come the "Easy Recipes" that +provide a good entry point after the tutorials; then the "Advanced Recipes" +that are more elaborate and demonstrate advanced analysis techniques, and lastly the "Regional Specialties" +contains recipes for regional model configurations [@barnes2024regionalmom6]. +Together these sections present the documentation as a browsable collection of +lessons and recipes gathered into a single cookbook. + +Pedagogy and instructional structure are central to the project. The recipes provide the starting point for more elaborate analyses. +"Cooking Tutorials" introduces generic skills such as loading model output, +working with labelled arrays, plotting, and interacting with shared data catalogues. +These tutorials lead into domain-focused recipes giving learners an incremental path +from first contact with the data ecosystem to adaptation of full workflows for +their own science questions. + +Within this structure, the tutorials leverage and demonstrate open source tools for +scientific analysis of large data. This includes examples of loading model output +through Intake-based catalogues [@intake], using xarray [@hoyer2017xarray] +and Dask [@rocklin2015dask; @dask] to process very large multi-dimensional datasets +in parallel. The recipe collection includes a Lagrangian particle-tracking workflow +built with Parcels [@Delandmeter-vanSebille-2019], as well as analyses that use +xgcm [@xgcm] to handle variables defined on staggered finite-volume grids, and xESMF [@xesmf] +for regridding model output. Figures are generated using matplotlib [@Hunter2007matplotlib] +incorporating Cartopy [@cartopy] for map-based visualisation. + +The Cookbook grew from a practical need inside the COSIMA community: the tools +used to analyse modern ocean model output are powerful, but the gap between +package-level documentation and reproducible end-to-end workflows remains +large. Users need to understand not only Python and Jupyter +[@kluyver2016jupyter], but also how to navigate high-dimensional model output, +shared high-performance computing environments, and domain-specific analysis +conventions. The Cookbook addresses this gap by packaging reusable workflows in +the same medium in which users actually work. + +# Statement of Need + +Ocean and climate model analysis has a steep entry cost. New users must learn +how to find datasets, load them efficiently, interpret metadata, operate on +multi-dimensional arrays, and produce scientifically meaningful diagnostics. +General-purpose libraries such as xarray [@hoyer2017xarray] provide the +foundations for these tasks, but they do not by themselves show a learner how +to translate a research question into a robust analysis workflow for a specific +model and computing environment. + +That gap is not only pedagogical; it directly affects how quickly model output +can be turned into science. For a beginner, becoming productive with a model +often requires substantial time just to understand the structure of the output, +the relevant conventions, and the computational environment in which analysis is +expected to run. There is also substantial scientific labour embedded in many +common diagnostics. Some calculations, for example computing cross-contour transports, +require non-trivial development, understanding of model numerics, and validation before +they can be used confidently. If every new user or project had to reconstruct +those workflows independently, a large amount of effort would be repeatedly spent +on rebuilding analysis code rather than conducting research using the model output. + +The COSIMA Cookbook facilitates knowledge sharing and accelerates research with +a domain-specific, openly maintained collection of computational lessons and examples. +Its contribution is not a new analysis library; rather, it is a reusable scientific +and educational resource that exposes complete, well-documented workflows in the same +notebook format in which many researchers actually explore data and communicate methods. +By choosing notebooks instead of packaging these examples only as a software +library, the project makes intermediate reasoning, methodological choices, and +practical execution details visible to learners while still giving more +experienced users analysis patterns they can adapt directly for research. This +aligns well with JOSE's emphasis on open educational resources that enable +computational learning through authentic practice. + +Several design decisions make the Cookbook particularly useful for adoption by +other groups. First, each notebook is intended to be self-contained and +well-documented, so learners can read, run, and modify a complete workflow +without reconstructing missing context from scattered notes. Second, the +repository distinguishes tutorials from recipes. Tutorials teach transferable +skills, while recipes demonstrate how those skills combine in realistic +analysis tasks. Third, the project includes contributor guidance and notebook +review conventions that encourage new analyses to be written in a reusable and +pedagogically clear style. A caveat is that some recipes use high-resolution +model output with datasets of order terabytes, so the underlying data are not +always practical to distribute or mirror in full. However, beyond the initial +data-loading step, which usually occurs early in each recipe, the analysis +workflows are generally applicable to most operational ocean--sea ice model +outputs that can be loaded with xarray [@hoyer2017xarray]. + +Thus, the structure is valuable beyond the immediate COSIMA context. Many research +communities maintain model output on shared infrastructure and face the same +challenge: turning expert tacit knowledge into examples that newcomers can +adapt. The Cookbook offers a model for how a scientific collaboration can +capture that knowledge in version-controlled notebooks, publish it as a living +resource, and continuously improve it through community contribution. + +# Educational Design and Experience of Use + +The learning experience is organised as a progression. The documentation points +new users first to introductory lessons, including material on loading, +slicing, and visualising model output. Learners then move to more advanced +tutorials and finally to recipe notebooks that address concrete scientific +questions. The categories of "easy" and "advanced" recipes provide +a lightweight pedagogical cue about expected complexity and scope, with +"regional specialties" specifically covering recipes for regional model configurations +[@barnes2024regionalmom6]. + +The intended mode of use is also explicit. The repository is designed around +Jupyter-based analysis on the Australian National Computational Infrastructure, +with guidance on running notebooks through ARE/JupyterLab sessions and on +accessing shared data holdings. This makes the Cookbook more than a static +collection of examples: it is operational documentation for a real analysis +environment. At the same time, the notebooks demonstrate broadly transferable +patterns for working with labelled geophysical data, so individual lessons can +be reused or adapted outside that environment. + +The project also supports community authorship. Contributors are encouraged to +submit new notebooks through pull requests, document their methods clearly, and +generalise workflows so that they remain useful to others. In that sense, the +Cookbook functions both as a learning module for end users and as a framework +for teaching reproducible scientific communication through notebook design and +peer review. The easy access to data and analysis provided by the COSIMA Cookbook +showcases best practices to the broader oceanographic community and has enabled rapid +community adoption of the ACCESS ocean and sea-ice model configurations internationally, +facilitating to date well over [100 peer-reviewed papers](https://scholar.google.com/citations?hl=en&user=inVqu_4AAAAJ) and more than 20 PhD projects to completion with several +other underway. + +# Author Order + +The first two authors contributed equally; authors from the third position +onward are listed alphabetically by surname. + +# Acknowledgements + +This work was supported by computational resources provided by the Australian Government through the National Computational Infrastructure (NCI) under the National Computational Merit +Allocation Scheme and the Australian National University Allocation Scheme. We thank the +vibrant communities of the Consortium for Ocean–Sea Ice Modelling in Australia (COSIMA; +[cosima.org.au](https://cosima.org.au)) and Australia’s climate simulator (ACCESS-NRI; [access-nri.org.au](https://access-nri.org.au)) +for making the ACCESS-OM2 and ACCESS-OM3 outputs and analysis tools available through the NCI. +We further acknowledge funding from the Australian Research Council under the Centre of +Excellence for the Weather of the 21st Century CE230100012, the Linkage Infrastructure, +Equipment and Facilities LP160100073 and LP200100406, and the Discovery Project DP240101274. + +# References diff --git a/paper/paper.pdf b/paper/paper.pdf new file mode 100644 index 00000000..51d21b20 Binary files /dev/null and b/paper/paper.pdf differ diff --git a/paper/website.png b/paper/website.png new file mode 100644 index 00000000..4060d07a Binary files /dev/null and b/paper/website.png differ