Skip to content

Commit 2c35ee5

Browse files
authored
Merge pull request #6 from ACCESS-Community-Hub/jbisits-mom6dev-aus
Added content for @jbisits presentation on developing mom6 code in Australia
2 parents 31530b4 + f572ca1 commit 2c35ee5

1 file changed

Lines changed: 31 additions & 2 deletions

File tree

documentation/docs/pages/decoding_mom6.md

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Season 1
22
## How to use github's search functionality to find code: MOM6 as an example.
3-
Presenter: @dougiesquire (4/12).
3+
Presenter: @dougiesquire (4/12/2025).
44

55
Working example, [the MOM6 code repository](https://github.com/access-nri/mom6).
66
Contains all of the MOM6 Fortran code
@@ -27,9 +27,38 @@ Workflow suggestions:
2727

2828
Further details on search strategies are [here](https://docs.github.com/en/search-github/github-code-search/understanding-github-code-search-syntax).
2929

30+
## Lessons learned from MOM6 code development
3031

32+
Presenter: @jbisits (11/12/2025).
33+
Take-home message: when starting development, take care with which version of the MOM6 code repository you fork from.
34+
35+
### Background
36+
37+
When @jbisits started work on MOM6, he went to google and found the MOM6 codebase and then made a fork of `mom-ocean/MOM6` (the [central consortium repository](https://github.com/mom-ocean/MOM6)). Actually if one is looking to contribute to the MOM6 codebase from Australia, there is an [access-nri/MOM6](https://github.com/access-nri/mom6) fork. They are different forks with different branches and code bases!
38+
39+
### How do I find out which version of MOM6 I am currently using?
40+
41+
Go to the OM3 configuration that you are using [example](https://github.com/ACCESS-NRI/access-om3-configs/blob/release-MC_25km_jra_iaf/config.yaml
42+
) and find the `config.yaml` following lines:
43+
44+
Note these lines:
45+
```yaml
46+
modules:
47+
use:
48+
- /g/data/vk83/modules
49+
load:
50+
- access-om3/2025.08.001
51+
```
52+
53+
Specifically note this line `access-om3/2025.08.001` highlights the [Spack bundle package](https://github.com/ACCESS-NRI/access-spack-packages/blob/main/packages/access-om3/package.py) and git tag that is being used for MOM6 code. One can then match this tag name `2025.08.001` from the model deployment repository, this link [lists all the tags](https://github.com/ACCESS-NRI/ACCESS-OM3/tags), and here is the tag we are looking for: [`2025.08.001`](https://github.com/ACCESS-NRI/ACCESS-OM3/releases/tag/2025.08.001).
54+
55+
Further information:
56+
57+
- [MOM6 fork management for being a development node](https://github.com/ACCESS-NRI/MOM6/wiki);
58+
- [OM3 build system and deployment](https://access-om3-configs.access-hive.org.au/infrastructure/Building/);
59+
- [NOAA-GFDL MOM6 development guide](https://github.com/NOAA-GFDL/MOM6-examples/wiki/Developers-guide);
60+
- [MOM6 development presentation by @marshallward](https://www.marshallward.org/mom6workshop/develop.html).
3161

32-
## Distributed nature of MOM6 code across different development hubs / github repositories
3362
## How to find code that corresponds to a particular executable (both ACCESS-NRI and other MOM6 executables e.g. from Angus)
3463
## How to find what diagnostics are available
3564
## Overview of MOM6 configuration (input files etc)

0 commit comments

Comments
 (0)