From b5251dc0eda3071588b615065db1b5304cfe31a0 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 29 Oct 2025 17:07:51 +1100 Subject: [PATCH 01/72] Create quick start for AM3 --- docs/models/run-a-model/run-access-am.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index e69de29bb..51443e2c0 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -0,0 +1,20 @@ +{% set model = "ACCESS-AM3" %} +{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} +{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} +{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set example_branch = "main" %} + +# Run ACCESS-AM3 + +## Quick Start + +{{ model }} configurations are hosted on Github and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. + +* Repository: {{ github_ssh }} +* Branch: {{ example_branch }} + +Required NCI projects: +* [ki32](https://my.nci.org.au/mancini/project/ki32/join) +* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) +* [vk83](https://my.nci.org.au/mancini/project/vk83/join) +* [xp65](https://my.nci.org.au/mancini/project/vk65/join) From 4a200425985f81ef23a64f5584a81399a5c25974 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 4 Nov 2025 14:44:07 +1100 Subject: [PATCH 02/72] Minor change to wording --- docs/models/run-a-model/run-access-am.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index 51443e2c0..364fd34b4 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -8,8 +8,9 @@ ## Quick Start -{{ model }} configurations are hosted on Github and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +* _Cylc_ version: 7 * Repository: {{ github_ssh }} * Branch: {{ example_branch }} From 302deeb6d08aa25508e71f0131343d35e14a5ccd Mon Sep 17 00:00:00 2001 From: Whyborn Date: Thu, 6 Nov 2025 10:41:46 +1100 Subject: [PATCH 03/72] Add changes from add-AM3-model-page branch --- docs/models/access-am.md | 28 ++++++++++++++++++++++++++++ docs/models/index.md | 12 ++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 docs/models/access-am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access-am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/index.md b/docs/models/index.md index af98f56c7..ef67a71ad 100644 --- a/docs/models/index.md +++ b/docs/models/index.md @@ -7,6 +7,18 @@ ACCESS models are computer codes comprising complex mathematical representations ## Supported ACCESS Models
+ + +
+ +
+
+ ACCESS-AM + + ACCESS-AM is a global atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemsitry components. + +
+
From 76b08955c9cd6f7c60c1f668654355407de778bb Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 09:12:12 +1100 Subject: [PATCH 04/72] Add access to list of projects --- docs/models/run-a-model/run-access-am.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index 364fd34b4..e9ab686f9 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -15,7 +15,8 @@ * Branch: {{ example_branch }} Required NCI projects: +* [access](https://my.nci.org.au/mancini/project/access/join) * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/vk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xk65/join) From f2e30910f902515811003cf35423b381d6ad04c7 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:07:59 +1100 Subject: [PATCH 05/72] Minor fixes --- docs/models/access-am.md | 2 +- docs/models/index.md | 2 +- docs/models/run-a-model/run-access-am.md | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index 764cab59b..dac44cb16 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/land_bgc#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/index.md b/docs/models/index.md index ef67a71ad..6ef6664ce 100644 --- a/docs/models/index.md +++ b/docs/models/index.md @@ -15,7 +15,7 @@ ACCESS models are computer codes comprising complex mathematical representations
ACCESS-AM - ACCESS-AM is a global atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemsitry components. + ACCESS-AM is a coupled atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemsitry components.
diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index e9ab686f9..07d3b115f 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -1,10 +1,10 @@ {% set model = "ACCESS-AM3" %} {% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} -# Run ACCESS-AM3 +# Run {{ model }} ## Quick Start @@ -19,4 +19,4 @@ Required NCI projects: * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/xk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xp65/join) From 66bdeacd0333e4882f59409856e7fcf07529197f Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:16:52 +1100 Subject: [PATCH 06/72] reverse land_bgc --- docs/models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index dac44cb16..a6715608b 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/land_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} From 549a3a20b1e116f86c3551fcf6af93ccbe0e400f Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:48:46 +1100 Subject: [PATCH 07/72] Fill in missing hyperlinks --- docs/models/access-am.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index a6715608b..61e2d4b91 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -4,12 +4,12 @@ ![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 97716377402a8b2d538ff8f7947ded07c1eb04fe Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 13:19:06 +1100 Subject: [PATCH 08/72] Change suite to set --- docs/models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index 61e2d4b91..8f651b494 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -9,7 +9,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 9e71a44f941b673047274a3908ebece2e3c2d079 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Thu, 6 Nov 2025 10:41:46 +1100 Subject: [PATCH 09/72] Add changes from add-AM3-model-page branch --- docs/models/access-am.md | 28 ++++++++++++++++++++++++++++ docs/models/index.md | 2 +- 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 docs/models/access-am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access-am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/index.md b/docs/models/index.md index 7ed2d882e..8462e8e84 100644 --- a/docs/models/index.md +++ b/docs/models/index.md @@ -51,4 +51,4 @@
-
\ No newline at end of file + From db89ae113b95ecdf68b5fb3701e0c5ad12758284 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 09:12:12 +1100 Subject: [PATCH 10/72] Add access to list of projects --- docs/models/access-am.md | 28 ------------------------ docs/models/run_a_model/run_access_am.md | 21 ++++++++++++++++++ 2 files changed, 21 insertions(+), 28 deletions(-) delete mode 100644 docs/models/access-am.md create mode 100644 docs/models/run_a_model/run_access_am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md deleted file mode 100644 index 764cab59b..000000000 --- a/docs/models/access-am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md new file mode 100644 index 000000000..364fd34b4 --- /dev/null +++ b/docs/models/run_a_model/run_access_am.md @@ -0,0 +1,21 @@ +{% set model = "ACCESS-AM3" %} +{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} +{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} +{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set example_branch = "main" %} + +# Run ACCESS-AM3 + +## Quick Start + +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. + +* _Cylc_ version: 7 +* Repository: {{ github_ssh }} +* Branch: {{ example_branch }} + +Required NCI projects: +* [ki32](https://my.nci.org.au/mancini/project/ki32/join) +* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) +* [vk83](https://my.nci.org.au/mancini/project/vk83/join) +* [xp65](https://my.nci.org.au/mancini/project/vk65/join) From a95b40ac2a3c41a1fbfedc3ce7c617cc0f4f793c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:07:59 +1100 Subject: [PATCH 11/72] Minor fixes --- docs/models/access_models/access_am.md | 28 ++++++++++++++++++++++++ docs/models/run_a_model/run_access_am.md | 6 ++--- 2 files changed, 31 insertions(+), 3 deletions(-) create mode 100644 docs/models/access_models/access_am.md diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access_models/access_am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index 364fd34b4..acdcfd32c 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -1,10 +1,10 @@ {% set model = "ACCESS-AM3" %} {% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} -# Run ACCESS-AM3 +# Run {{ model }} ## Quick Start @@ -18,4 +18,4 @@ Required NCI projects: * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/vk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xp65/join) From dbf46daac00c8000483a0fad0e9e36ad5b5d076d Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:16:52 +1100 Subject: [PATCH 12/72] reverse land_bgc --- docs/models/access_models/access_am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index 764cab59b..a6715608b 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} From 4232edbdf98ad4f4005f1625e07ad1a1b41a0ecf Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:48:46 +1100 Subject: [PATCH 13/72] Fill in missing hyperlinks --- docs/models/access_models/access_am.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index a6715608b..61e2d4b91 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -4,12 +4,12 @@ ![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 26c743ee298dbc2fd9f62f4efcbb54124f3882ba Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 13:19:06 +1100 Subject: [PATCH 14/72] Change suite to set --- docs/models/access_models/access_am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index 61e2d4b91..8f651b494 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -9,7 +9,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 8928881350ee628168492f29fd4caae844919aa8 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 12 Nov 2025 16:00:36 +1100 Subject: [PATCH 15/72] Be slightly more verbose in Quick start section --- docs/models/run_a_model/run_access_am.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index acdcfd32c..fadbc97f4 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -8,13 +8,17 @@ ## Quick Start -{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +!!! warning +If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. -* _Cylc_ version: 7 -* Repository: {{ github_ssh }} -* Branch: {{ example_branch }} +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: -Required NCI projects: +* [_Cylc_ version](/models/run-a-model/rose-cylc/#rose-and-cylc-executables): 7 +* [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} +* [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} + +In addition to the projects specified in the [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc/#prerequisites), the following project memberships are required: +* [access](https://my.nci.org.au/mancini/project/access/join) * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) From 24a505188ea9589cc420d632bf9b74ff6378ff41 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 14 Nov 2025 16:52:17 +1100 Subject: [PATCH 16/72] Add message about getting access to repos and link to config docs --- docs/models/run_a_model/run_access_am.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index fadbc97f4..c8cd664e4 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -9,7 +9,10 @@ ## Quick Start !!! warning -If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. + If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. + +!!! warning + These configurations are based off licensed configurations from the UK Met Office (UKMO). This means the configurations repository is private. To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). {{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: @@ -23,3 +26,5 @@ In addition to the projects specified in the [_Rose/Cylc_ documentation](/models * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) * [xp65](https://my.nci.org.au/mancini/project/xp65/join) + +See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 3b5dde70b0615e1712ee8035dd5c4876909218ab Mon Sep 17 00:00:00 2001 From: Whyborn Date: Thu, 6 Nov 2025 10:41:46 +1100 Subject: [PATCH 17/72] Add changes from add-AM3-model-page branch --- docs/models/access-am.md | 28 ++++++++++++++++++++++++++++ docs/models/index.md | 2 +- 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 docs/models/access-am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access-am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/index.md b/docs/models/index.md index 7ed2d882e..8462e8e84 100644 --- a/docs/models/index.md +++ b/docs/models/index.md @@ -51,4 +51,4 @@ - \ No newline at end of file + From cc6e10691c0cba609dd54aa01ffb9c13ed3499f3 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 09:12:12 +1100 Subject: [PATCH 18/72] Add access to list of projects --- docs/models/access-am.md | 28 ------------------------ docs/models/run_a_model/run_access_am.md | 21 ++++++++++++++++++ 2 files changed, 21 insertions(+), 28 deletions(-) delete mode 100644 docs/models/access-am.md create mode 100644 docs/models/run_a_model/run_access_am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md deleted file mode 100644 index 764cab59b..000000000 --- a/docs/models/access-am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md new file mode 100644 index 000000000..364fd34b4 --- /dev/null +++ b/docs/models/run_a_model/run_access_am.md @@ -0,0 +1,21 @@ +{% set model = "ACCESS-AM3" %} +{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} +{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} +{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set example_branch = "main" %} + +# Run ACCESS-AM3 + +## Quick Start + +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. + +* _Cylc_ version: 7 +* Repository: {{ github_ssh }} +* Branch: {{ example_branch }} + +Required NCI projects: +* [ki32](https://my.nci.org.au/mancini/project/ki32/join) +* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) +* [vk83](https://my.nci.org.au/mancini/project/vk83/join) +* [xp65](https://my.nci.org.au/mancini/project/vk65/join) From 2331ce3b45395c9a95cf3b0b7f2414c846445846 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:07:59 +1100 Subject: [PATCH 19/72] Minor fixes --- docs/models/access_models/access_am.md | 28 ++++++++++++++++++++++++ docs/models/run_a_model/run_access_am.md | 6 ++--- 2 files changed, 31 insertions(+), 3 deletions(-) create mode 100644 docs/models/access_models/access_am.md diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access_models/access_am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index 364fd34b4..acdcfd32c 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -1,10 +1,10 @@ {% set model = "ACCESS-AM3" %} {% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} -# Run ACCESS-AM3 +# Run {{ model }} ## Quick Start @@ -18,4 +18,4 @@ Required NCI projects: * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/vk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xp65/join) From a2baeac0cb62d61c8774ff5f366b2dafa0e48c4c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:16:52 +1100 Subject: [PATCH 20/72] reverse land_bgc --- docs/models/access_models/access_am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index 764cab59b..a6715608b 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} From f1bf718e427155bace5b4a261057205226e11ffc Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:48:46 +1100 Subject: [PATCH 21/72] Fill in missing hyperlinks --- docs/models/access_models/access_am.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index a6715608b..61e2d4b91 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -4,12 +4,12 @@ ![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From be779b1749420796810a12bfb1e7b0386b5fbb74 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 13:19:06 +1100 Subject: [PATCH 22/72] Change suite to set --- docs/models/access_models/access_am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md index 61e2d4b91..8f651b494 100644 --- a/docs/models/access_models/access_am.md +++ b/docs/models/access_models/access_am.md @@ -9,7 +9,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From d83ed6f08a5b0ea4368f31e2f1edc8c767c146f3 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 12 Nov 2025 16:00:36 +1100 Subject: [PATCH 23/72] Be slightly more verbose in Quick start section --- docs/models/run_a_model/run_access_am.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index acdcfd32c..fadbc97f4 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -8,13 +8,17 @@ ## Quick Start -{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +!!! warning +If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. -* _Cylc_ version: 7 -* Repository: {{ github_ssh }} -* Branch: {{ example_branch }} +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: -Required NCI projects: +* [_Cylc_ version](/models/run-a-model/rose-cylc/#rose-and-cylc-executables): 7 +* [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} +* [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} + +In addition to the projects specified in the [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc/#prerequisites), the following project memberships are required: +* [access](https://my.nci.org.au/mancini/project/access/join) * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) From b216d34475d16d20db7768b79dcb2eeeac0655be Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 29 Oct 2025 17:07:51 +1100 Subject: [PATCH 24/72] Create quick start for AM3 --- docs/models/run-a-model/run-access-am.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 docs/models/run-a-model/run-access-am.md diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md new file mode 100644 index 000000000..51443e2c0 --- /dev/null +++ b/docs/models/run-a-model/run-access-am.md @@ -0,0 +1,20 @@ +{% set model = "ACCESS-AM3" %} +{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} +{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} +{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set example_branch = "main" %} + +# Run ACCESS-AM3 + +## Quick Start + +{{ model }} configurations are hosted on Github and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. + +* Repository: {{ github_ssh }} +* Branch: {{ example_branch }} + +Required NCI projects: +* [ki32](https://my.nci.org.au/mancini/project/ki32/join) +* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) +* [vk83](https://my.nci.org.au/mancini/project/vk83/join) +* [xp65](https://my.nci.org.au/mancini/project/vk65/join) From 96ac3f3def08665055edbbb9b05fd5d98139b49b Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 4 Nov 2025 14:44:07 +1100 Subject: [PATCH 25/72] Minor change to wording --- docs/models/run-a-model/run-access-am.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index 51443e2c0..364fd34b4 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -8,8 +8,9 @@ ## Quick Start -{{ model }} configurations are hosted on Github and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. +* _Cylc_ version: 7 * Repository: {{ github_ssh }} * Branch: {{ example_branch }} From cf7c72390404f3ef0cf208c183684bf8be64acde Mon Sep 17 00:00:00 2001 From: Whyborn Date: Thu, 6 Nov 2025 10:41:46 +1100 Subject: [PATCH 26/72] Add changes from add-AM3-model-page branch --- docs/models/access-am.md | 28 ++++++++++++++++++++++++++++ docs/models/access_models/index.md | 12 ++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 docs/models/access-am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md new file mode 100644 index 000000000..764cab59b --- /dev/null +++ b/docs/models/access-am.md @@ -0,0 +1,28 @@ +[run-access-am]: /models/run-a-model/run-access-am3 + +# ACCESS-AM + +![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} + +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). + +{% set model = "ACCESS-AM3" %} +## {{ model }} + +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. + +ACCESS-NRI has released [{{ model }} configurations][run-access-am]. + +**Fill in configurations for release.** + +### Model Components {: #model-components-{{model}} } + +- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). + +- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). + +- **Land**: [CABLE](/models/model_components/land#cable). + +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). + +[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/access_models/index.md b/docs/models/access_models/index.md index 5c5ef08eb..3b60591fe 100644 --- a/docs/models/access_models/index.md +++ b/docs/models/access_models/index.md @@ -6,6 +6,18 @@ Developed in collaboration with international climate modeling institutions, the Below is a list of ACCESS models supported by ACCESS-NRI.
+ + +
+ +
+
+ ACCESS-AM + + A global atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemsitry components. + +
+
From df42d60c2a42b4ed9e6bdc441254fd20e1bbbe2e Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 09:12:12 +1100 Subject: [PATCH 27/72] Add access to list of projects --- docs/models/run-a-model/run-access-am.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index 364fd34b4..e9ab686f9 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -15,7 +15,8 @@ * Branch: {{ example_branch }} Required NCI projects: +* [access](https://my.nci.org.au/mancini/project/access/join) * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/vk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xk65/join) From bd4853c497ad714b577ee091f3a5173048a4d864 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:07:59 +1100 Subject: [PATCH 28/72] Minor fixes --- docs/models/access-am.md | 2 +- docs/models/run-a-model/run-access-am.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index 764cab59b..dac44cb16 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/l`and_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/land_bgc#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md index e9ab686f9..07d3b115f 100644 --- a/docs/models/run-a-model/run-access-am.md +++ b/docs/models/run-a-model/run-access-am.md @@ -1,10 +1,10 @@ {% set model = "ACCESS-AM3" %} {% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-om3-configs.access-hive.org.au" %} +{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} -# Run ACCESS-AM3 +# Run {{ model }} ## Quick Start @@ -19,4 +19,4 @@ Required NCI projects: * [ki32](https://my.nci.org.au/mancini/project/ki32/join) * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/xk65/join) +* [xp65](https://my.nci.org.au/mancini/project/xp65/join) From 95349c2fbefd855d7a27f51b9db0ad59a3009582 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:16:52 +1100 Subject: [PATCH 29/72] reverse land_bgc --- docs/models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index dac44cb16..a6715608b 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -23,6 +23,6 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land**: [CABLE](/models/model_components/land#cable). -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/land_bgc#casa_cnp). +- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). [Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} From dc1cf81ff0c0d208eb7567601d56ceb9b09b568f Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 12:48:46 +1100 Subject: [PATCH 30/72] Fill in missing hyperlinks --- docs/models/access-am.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index a6715608b..61e2d4b91 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -4,12 +4,12 @@ ![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](), [aerosols and atmospheric chemistry](), [land]() and [land biogeochemistry](). +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, [CSIRO]() and the [ARC Centre of Excellence for Weather in the 21st Century]. +{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 6db0926d677de37e103aaaf6df6864536af1f5e2 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Tue, 11 Nov 2025 13:19:06 +1100 Subject: [PATCH 31/72] Change suite to set --- docs/models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access-am.md b/docs/models/access-am.md index 61e2d4b91..8f651b494 100644 --- a/docs/models/access-am.md +++ b/docs/models/access-am.md @@ -9,7 +9,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a suite of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations][run-access-am]. From 4f44200490f6928674ebce685e3b6f4634a0d043 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 14 Nov 2025 16:52:17 +1100 Subject: [PATCH 32/72] Add message about getting access to repos and link to config docs --- docs/models/run_a_model/run_access_am.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md index fadbc97f4..c8cd664e4 100644 --- a/docs/models/run_a_model/run_access_am.md +++ b/docs/models/run_a_model/run_access_am.md @@ -9,7 +9,10 @@ ## Quick Start !!! warning -If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. + If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. + +!!! warning + These configurations are based off licensed configurations from the UK Met Office (UKMO). This means the configurations repository is private. To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). {{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: @@ -23,3 +26,5 @@ In addition to the projects specified in the [_Rose/Cylc_ documentation](/models * [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) * [vk83](https://my.nci.org.au/mancini/project/vk83/join) * [xp65](https://my.nci.org.au/mancini/project/xp65/join) + +See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 18b299499ee3c106d25d95212a7a9b1a7a637abb Mon Sep 17 00:00:00 2001 From: Davide Marchegiani Date: Sat, 15 Nov 2025 09:38:45 +1100 Subject: [PATCH 33/72] Fixes after rebasing --- docs/models/{ => access_models}/access-am.md | 6 ++-- docs/models/access_models/access_am.md | 28 ------------------- docs/models/run-a-model/run-access-am.md | 22 --------------- .../{run_access_am.md => run_access-am3.md} | 0 mkdocs.yml | 1 + 5 files changed, 3 insertions(+), 54 deletions(-) rename docs/models/{ => access_models}/access-am.md (88%) delete mode 100644 docs/models/access_models/access_am.md delete mode 100644 docs/models/run-a-model/run-access-am.md rename docs/models/run_a_model/{run_access_am.md => run_access-am3.md} (100%) diff --git a/docs/models/access-am.md b/docs/models/access_models/access-am.md similarity index 88% rename from docs/models/access-am.md rename to docs/models/access_models/access-am.md index 8f651b494..904435c84 100644 --- a/docs/models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -1,5 +1,3 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - # ACCESS-AM ![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} @@ -11,7 +9,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. +ACCESS-NRI has released [{{ model }} configurations](/models/run_a_model/run_access-am3). **Fill in configurations for release.** @@ -25,4 +23,4 @@ ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} +[Run ACCESS-AM](/models/run_a_model/run_access-am3){: class="text-card"} diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md deleted file mode 100644 index 8f651b494..000000000 --- a/docs/models/access_models/access_am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/run-a-model/run-access-am.md b/docs/models/run-a-model/run-access-am.md deleted file mode 100644 index 07d3b115f..000000000 --- a/docs/models/run-a-model/run-access-am.md +++ /dev/null @@ -1,22 +0,0 @@ -{% set model = "ACCESS-AM3" %} -{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} -{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} -{% set example_branch = "main" %} - -# Run {{ model }} - -## Quick Start - -{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) Github repository and use the [_Rose/Cylc_ workflow tool]()**[TODO] Link to rose/cylc docs when published**. - -* _Cylc_ version: 7 -* Repository: {{ github_ssh }} -* Branch: {{ example_branch }} - -Required NCI projects: -* [access](https://my.nci.org.au/mancini/project/access/join) -* [ki32](https://my.nci.org.au/mancini/project/ki32/join) -* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) -* [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/xp65/join) diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access-am3.md similarity index 100% rename from docs/models/run_a_model/run_access_am.md rename to docs/models/run_a_model/run_access-am3.md diff --git a/mkdocs.yml b/mkdocs.yml index 4ef85aad7..020d82da8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -124,6 +124,7 @@ nav: - Run a Model: - models/run_a_model/index.md - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md + - Run ACCESS-AM3: models/run_a_model/run_access-am3.md - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md - Run ACCESS-ESM: models/run_a_model/run_access-esm.md - Run ACCESS-OM2: models/run_a_model/run_access-om2.md From e6d0098b1a1f64a3e5810557e1ac6d1ff3c5ba5e Mon Sep 17 00:00:00 2001 From: Davide Marchegiani Date: Sat, 15 Nov 2025 10:01:09 +1100 Subject: [PATCH 34/72] Added access-am3-configs private repo to link checker exclusions, because it would fail for permission reasons --- .github/workflows/lychee_config.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/lychee_config.toml b/.github/workflows/lychee_config.toml index a0fa82ef4..8e00cc11f 100644 --- a/.github/workflows/lychee_config.toml +++ b/.github/workflows/lychee_config.toml @@ -129,6 +129,7 @@ glob_ignore_case = false '^https://cds\.climate\.copernicus\.eu/', # EU Copernicus - has firewalls that block link-checkers '^https://www\.nrc\.gov/', # Gov website - has firewalls that block link-checkers '^https://www\.education\.gov\.au/', # AU Gov website - has firewalls that block link-checkers + '^https://github\.com/ACCESS-NRI/access-am3-configs', # Private GitHub repo ] # Exclude paths from getting checked. The values are treated as regular expressions From eb6a9105e7e6a5d3d4f48db83bca448da9767521 Mon Sep 17 00:00:00 2001 From: Claire Carouge Date: Thu, 20 Nov 2025 16:32:36 +1100 Subject: [PATCH 35/72] Reorganise the information --- docs/models/run_a_model/run_access-am3.md | 57 +++++++++++++++++------ 1 file changed, 43 insertions(+), 14 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index c8cd664e4..d0adcf426 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -3,28 +3,57 @@ {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} {% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} +{% set release_notes = "" %} # Run {{ model }} -## Quick Start +## About + +The instructions below outline how to run {{ model }} using ACCESS-NRI's software deployment pipeline, specifically designed to run on the [National Computational Infrastructure (NCI)](https://nci.org.au/about-us/who-we-are) supercomputer [_Gadi_][gadi]. + +If you are unsure whether {{ model }} is the right choice for your experiment, take a look at the overview of [ACCESS Models](/models). + +All {{model}} configurations are licensed under the UKMO's [Momentum licence](). {{model}} is delivered to the community through private GitHub repositories. See the [Prerequisites](#prerequisites) section for details. + +{{ model }} release notes are [available on the ACCESS-Hive Forum]({{release_notes}}) and are updated when new releases are made available. + +## Prerequisites !!! warning If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. -!!! warning - These configurations are based off licensed configurations from the UK Met Office (UKMO). This means the configurations repository is private. To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). +In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc/#prerequisites), you will need: + +- **Request access to the configurations**
+ To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). This step will also allow us to check you are properly licensed to use the software. + +- **Join NCI projects**
+ Join the following projects by requesting membership on their respective NCI project pages: + + - [access](https://my.nci.org.au/mancini/project/access/join) + - [ki32](https://my.nci.org.au/mancini/project/ki32/join) + - [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) + - [vk83](https://my.nci.org.au/mancini/project/vk83/join) + - [xp65](https://my.nci.org.au/mancini/project/xp65/join) + + !!! tip + To request membership for the _ki32_mosrs_ subproject, you need to: + + - already be member of the _ki32_ project + {: style="list-style-type: disc"} + - have a [MOSRS account](#mosrs-account) + {: style="list-style-type: disc"} + + !!! warning + You will not be granted access to some of the projects listed here before we have checked you are properly licensed to use the software. Ensure you request access to the configurations first. + + For more information on joining specific NCI projects, refer to [How to connect to a project](https://opus.nci.org.au/display/Help/How+to+connect+to+a+project). -{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: +## Get {{model}} configuration and run it -* [_Cylc_ version](/models/run-a-model/rose-cylc/#rose-and-cylc-executables): 7 -* [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} -* [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} +Follow the instructions in the _Rose/Cylc_ page using the following specific information: -In addition to the projects specified in the [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc/#prerequisites), the following project memberships are required: -* [access](https://my.nci.org.au/mancini/project/access/join) -* [ki32](https://my.nci.org.au/mancini/project/ki32/join) -* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) -* [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/xp65/join) +- [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} +- [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} -See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. +See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. \ No newline at end of file From b2d06e6b3b609b013c158acfc42d6ccc461278fb Mon Sep 17 00:00:00 2001 From: Claire Carouge Date: Fri, 21 Nov 2025 10:11:04 +1100 Subject: [PATCH 36/72] Added ACCESS-AM model page to navigation --- docs/models/access-am.md | 28 ---- docs/models/access_models/access-am.md | 4 +- docs/models/access_models/access_am.md | 28 ---- mkdocs.yml | 201 +++++++++++++------------ 4 files changed, 103 insertions(+), 158 deletions(-) delete mode 100644 docs/models/access-am.md delete mode 100644 docs/models/access_models/access_am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md deleted file mode 100644 index 8f651b494..000000000 --- a/docs/models/access-am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 904435c84..d82c22086 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -11,11 +11,11 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th ACCESS-NRI has released [{{ model }} configurations](/models/run_a_model/run_access-am3). -**Fill in configurations for release.** +**Fill in configurations for beta release.** ### Model Components {: #model-components-{{model}} } -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). +- **Atmosphere**: [UM13.1](/models/model_components/atmosphere#unified-model-um). - **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md deleted file mode 100644 index 8f651b494..000000000 --- a/docs/models/access_models/access_am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/mkdocs.yml b/mkdocs.yml index 020d82da8..2c18b8195 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -39,14 +39,14 @@ theme: - navigation.tabs.sticky - navigation.indexes - navigation.footer - - navigation.tracking # The URL in the address bar is automatically updated with active anchor - - content.code.copy # for displaying copy icon at top right in code snippets + - navigation.tracking # The URL in the address bar is automatically updated with active anchor + - content.code.copy # for displaying copy icon at top right in code snippets - content.code.annotate - content.tabs.link - search.suggest - search.highlight - search.share - - toc.follow # the sidebar is automatically scrolled to the active anchor + - toc.follow # the sidebar is automatically scrolled to the active anchor logo: assets/ACCESS_icon_HIVE.png favicon: assets/ACCESS_icon_HIVE.png @@ -67,7 +67,7 @@ plugins: - macros # Extensions -markdown_extensions: +markdown_extensions: - attr_list - abbr - md_in_html @@ -84,7 +84,7 @@ markdown_extensions: emoji_index: !!python/name:material.extensions.emoji.twemoji emoji_generator: !!python/name:material.extensions.emoji.to_svg - pymdownx.tabbed: - alternate_style: true + alternate_style: true - pymdownx.keys - pymdownx.arithmatex: generic: true @@ -96,110 +96,111 @@ markdown_extensions: # Navigation nav: - - Getting Started: - - getting_started/index.md - - Set Up your NCI Account: getting_started/set_up_nci_account.md - - Australian Research Environment (ARE): getting_started/are.md - - conda/analysis3 Python Environment: getting_started/environments.md - - Set up Spack for building ACCESS models: getting_started/spack.md + - Getting Started: + - getting_started/index.md + - Set Up your NCI Account: getting_started/set_up_nci_account.md + - Australian Research Environment (ARE): getting_started/are.md + - conda/analysis3 Python Environment: getting_started/environments.md + - Set up Spack for building ACCESS models: getting_started/spack.md - Models: - - models/index.md - - ACCESS Models: - - models/access_models/index.md - - ACCESS-CM: models/access_models/access-cm.md - - ACCESS-ESM: models/access_models/access-esm.md - - ACCESS-OM: models/access_models/access-om.md - - ACCESS-rAM: models/access_models/access-ram.md - - Model Components: - - models/model_components/index.md - - Atmosphere: models/model_components/atmosphere.md - - Land: models/model_components/land.md - - Ocean: models/model_components/ocean.md - - Sea Ice: models/model_components/sea-ice.md - - Aerosols and Atmospheric Chemistry: models/model_components/aerosols_atmospheric_chemistry.md - - Biogeochemistry Land: models/model_components/bgc_land.md - - Biogeochemistry Ocean: models/model_components/bgc_ocean.md - - Coupler: models/model_components/coupler.md - - Run a Model: - - models/run_a_model/index.md - - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md - - Run ACCESS-AM3: models/run_a_model/run_access-am3.md - - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md - - Run ACCESS-ESM: models/run_a_model/run_access-esm.md - - Run ACCESS-OM2: models/run_a_model/run_access-om2.md - - Run ACCESS-OM3: models/run_a_model/run_access-om3.md - - Run ACCESS-rAM: models/run_a_model/run_access-ram.md - - Build a Model: - - models/build_a_model/index.md - - Modify and build an ACCESS model's source code: models/build_a_model/build_source_code.md - - Create Prereleases and Releases for an ACCESS Model: models/build_a_model/create_a_prerelease.md + - models/index.md + - ACCESS Models: + - models/access_models/index.md + - ACCESS-AM: models/access_models/access-am.md + - ACCESS-CM: models/access_models/access-cm.md + - ACCESS-ESM: models/access_models/access-esm.md + - ACCESS-OM: models/access_models/access-om.md + - ACCESS-rAM: models/access_models/access-ram.md + - Model Components: + - models/model_components/index.md + - Atmosphere: models/model_components/atmosphere.md + - Land: models/model_components/land.md + - Ocean: models/model_components/ocean.md + - Sea Ice: models/model_components/sea-ice.md + - Aerosols and Atmospheric Chemistry: models/model_components/aerosols_atmospheric_chemistry.md + - Biogeochemistry Land: models/model_components/bgc_land.md + - Biogeochemistry Ocean: models/model_components/bgc_ocean.md + - Coupler: models/model_components/coupler.md + - Run a Model: + - models/run_a_model/index.md + - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md + - Run ACCESS-AM3: models/run_a_model/run_access-am3.md + - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md + - Run ACCESS-ESM: models/run_a_model/run_access-esm.md + - Run ACCESS-OM2: models/run_a_model/run_access-om2.md + - Run ACCESS-OM3: models/run_a_model/run_access-om3.md + - Run ACCESS-rAM: models/run_a_model/run_access-ram.md + - Build a Model: + - models/build_a_model/index.md + - Modify and build an ACCESS model's source code: models/build_a_model/build_source_code.md + - Create Prereleases and Releases for an ACCESS Model: models/build_a_model/create_a_prerelease.md - Data and Model Evaluation: - - model_evaluation/index.md - - Data: - - model_evaluation/data/index.md - - Data Format and Standards: model_evaluation/data/data_format.md - - Data Variables: model_evaluation/data/variables.md - - Observational Data: model_evaluation/data/observations.md - - Accessing Model Data: model_evaluation/data/model_catalogs.md - - - Model Evaluation: - - model_evaluation/evaluation_on_gadi/index.md - # - Frameworks on Gadi: - - ESMValTool: model_evaluation/evaluation_on_gadi/esmvaltool_workflow.md - - ILAMB: model_evaluation/evaluation_on_gadi/ilamb_workflow.md - - COSIMA cookbook: model_evaluation/evaluation_on_gadi/cosima.md - - Model Live Diagnostics: model_evaluation/evaluation_on_gadi/model_live_diagnostics.md - - METplus: model_evaluation/evaluation_on_gadi/metplus.md - - Additional Resources: - - Additional Resources: model_evaluation/community_med/index.md - - Observational Catalogues: model_evaluation/community_med/community_observational_catalogs.md - - Model Catalogues: model_evaluation/community_med/community_model_catalogs.md - - Data Formatting: model_evaluation/community_med/community_data_processing.md - - Evaluation Recipes: model_evaluation/community_med/community_med_recipes.md + - model_evaluation/index.md + - Data: + - model_evaluation/data/index.md + - Data Format and Standards: model_evaluation/data/data_format.md + - Data Variables: model_evaluation/data/variables.md + - Observational Data: model_evaluation/data/observations.md + - Accessing Model Data: model_evaluation/data/model_catalogs.md + + - Model Evaluation: + - model_evaluation/evaluation_on_gadi/index.md + # - Frameworks on Gadi: + - ESMValTool: model_evaluation/evaluation_on_gadi/esmvaltool_workflow.md + - ILAMB: model_evaluation/evaluation_on_gadi/ilamb_workflow.md + - COSIMA cookbook: model_evaluation/evaluation_on_gadi/cosima.md + - Model Live Diagnostics: model_evaluation/evaluation_on_gadi/model_live_diagnostics.md + - METplus: model_evaluation/evaluation_on_gadi/metplus.md + - Additional Resources: + - Additional Resources: model_evaluation/community_med/index.md + - Observational Catalogues: model_evaluation/community_med/community_observational_catalogs.md + - Model Catalogues: model_evaluation/community_med/community_model_catalogs.md + - Data Formatting: model_evaluation/community_med/community_data_processing.md + - Evaluation Recipes: model_evaluation/community_med/community_med_recipes.md - Tutorials: - - tutorials/index.md - - ACCESS-CM2: tutorials/models.md - - ACCESS-NRI Intake catalog: tutorials/intake.md - - ESMValTool: tutorials/esmvaltool.md - - ILAMB: tutorials/ilamb.md - - Payu: tutorials/payu.md - + - tutorials/index.md + - ACCESS-CM2: tutorials/models.md + - ACCESS-NRI Intake catalog: tutorials/intake.md + - ESMValTool: tutorials/esmvaltool.md + - ILAMB: tutorials/ilamb.md + - Payu: tutorials/payu.md + - Community Resources: - - community_resources/index.md - # Keep this commented for future workshops - # - ACCESS Community Workshop 2025: - # - Overview: community_resources/access_workshop_2025/index.md - # - Training Day materials: community_resources/access_workshop_2025/training_materials.md - - Workshops and Events Archive: - - community_resources/workshops_events_archive/index.md - - ACCESS Community Workshop 2023: - - Overview: community_resources/workshops_events_archive/access_workshop_2023/index.md - - Training materials 2023: community_resources/workshops_events_archive/access_workshop_2023/training_materials.md - - ACCESS Community Workshop 2024: - - Overview: community_resources/workshops_events_archive/access_workshop_2024/index.md - - Training materials 2024: community_resources/workshops_events_archive/access_workshop_2024/training_materials.md - - ACCESS Community Workshop 2025: - - Overview: community_resources/workshops_events_archive/access_workshop_2025/index.md - - Training materials 2025: community_resources/workshops_events_archive/access_workshop_2025/training_materials.md - - Working Groups: community_resources/community_working_groups.md - - External Resources: community_resources/external_resources.md - - Glossaries: community_resources/glossaries.md + - community_resources/index.md + # Keep this commented for future workshops + # - ACCESS Community Workshop 2025: + # - Overview: community_resources/access_workshop_2025/index.md + # - Training Day materials: community_resources/access_workshop_2025/training_materials.md + - Workshops and Events Archive: + - community_resources/workshops_events_archive/index.md + - ACCESS Community Workshop 2023: + - Overview: community_resources/workshops_events_archive/access_workshop_2023/index.md + - Training materials 2023: community_resources/workshops_events_archive/access_workshop_2023/training_materials.md + - ACCESS Community Workshop 2024: + - Overview: community_resources/workshops_events_archive/access_workshop_2024/index.md + - Training materials 2024: community_resources/workshops_events_archive/access_workshop_2024/training_materials.md + - ACCESS Community Workshop 2025: + - Overview: community_resources/workshops_events_archive/access_workshop_2025/index.md + - Training materials 2025: community_resources/workshops_events_archive/access_workshop_2025/training_materials.md + - Working Groups: community_resources/community_working_groups.md + - External Resources: community_resources/external_resources.md + - Glossaries: community_resources/glossaries.md - About: - - about/index.md - - Contact: about/contact.md - - Release stages: about/releases.md - - FAQ: about/faq.md - - User support: about/user_support.md - - How to Contribute: about/contribute.md - - License: about/License.md + - about/index.md + - Contact: about/contact.md + - Release stages: about/releases.md + - FAQ: about/faq.md + - User support: about/user_support.md + - How to Contribute: about/contribute.md + - License: about/License.md # Footer extra: generator: false social: - - icon: fontawesome/brands/bluesky + - icon: fontawesome/brands/bluesky link: https://bsky.app/profile/access-nri.bsky.social name: ACCESS-NRI on Bluesky - icon: fontawesome/brands/linkedin @@ -219,12 +220,12 @@ extra: # - icon: material/emoticon-sad-outline # name: This page could be improved # data: 0 - # note: >- + # note: >- # Thanks for your feedback!
# Help us improve this page by contributing! extra_css: - - "https://fonts.googleapis.com/icon?family=Material+Icons" # Material Icons Reference - https://material.io/resources/icons/?style=baseline + - "https://fonts.googleapis.com/icon?family=Material+Icons" # Material Icons Reference - https://material.io/resources/icons/?style=baseline - fontawesome-free-6.4.0-web/css/all.css - fontello/css/fontello-codes.css - fontello/css/fontello-ie7-codes.css @@ -239,7 +240,7 @@ extra_javascript: - js/custom-tags.js - js/miscellaneous.js -# Automatically reload page when running `mkdocs serve`, for any +# Automatically reload page when running `mkdocs serve`, for any # of the following files outside of the 'docs' directory watch: - mkdocs.yml From 8ea70aef3425c02f5951d8a77d9620512da6b299 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 10:15:50 +1100 Subject: [PATCH 37/72] Remove rogue files and add AM3 to models index in mkdocs.yml --- docs/models/access-am.md | 28 ------------------------- docs/models/access_models/access-esm.md | 2 +- docs/models/access_models/access_am.md | 28 ------------------------- docs/models/access_models/index.md | 4 ++-- mkdocs.yml | 1 + 5 files changed, 4 insertions(+), 59 deletions(-) delete mode 100644 docs/models/access-am.md delete mode 100644 docs/models/access_models/access_am.md diff --git a/docs/models/access-am.md b/docs/models/access-am.md deleted file mode 100644 index 8f651b494..000000000 --- a/docs/models/access-am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/access_models/access-esm.md b/docs/models/access_models/access-esm.md index c15bca3df..a472af5f1 100644 --- a/docs/models/access_models/access-esm.md +++ b/docs/models/access_models/access-esm.md @@ -40,4 +40,4 @@ There are currently two supported configurations: ACCESS-ESM1.5 has an equilibrium climate sensitivity of 3.87°C for doubled CO~2~ concentration. -[Run ACCESS-ESM](/models/run_a_model/run_access-esm){: class="text-card"} \ No newline at end of file +[Run ACCESS-ESM](/models/run_a_model/run_access-esm){: class="text-card"} diff --git a/docs/models/access_models/access_am.md b/docs/models/access_models/access_am.md deleted file mode 100644 index 8f651b494..000000000 --- a/docs/models/access_models/access_am.md +++ /dev/null @@ -1,28 +0,0 @@ -[run-access-am]: /models/run-a-model/run-access-am3 - -# ACCESS-AM - -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} - -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). - -{% set model = "ACCESS-AM3" %} -## {{ model }} - -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). - -ACCESS-NRI has released [{{ model }} configurations][run-access-am]. - -**Fill in configurations for release.** - -### Model Components {: #model-components-{{model}} } - -- **Atmosphere**: [UM13.5](/models/model_components/atmosphere#unified-model-um). - -- **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). - -- **Land**: [CABLE](/models/model_components/land#cable). - -- **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). - -[Run ACCESS-AM](/models/run-a-model/run-access-am){: class="text-card"} diff --git a/docs/models/access_models/index.md b/docs/models/access_models/index.md index 3b60591fe..420ecd76f 100644 --- a/docs/models/access_models/index.md +++ b/docs/models/access_models/index.md @@ -7,7 +7,7 @@ Below is a list of ACCESS models supported by ACCESS-NRI.
- +
@@ -65,4 +65,4 @@ Below is a list of ACCESS models supported by ACCESS-NRI.
-
\ No newline at end of file +
diff --git a/mkdocs.yml b/mkdocs.yml index 020d82da8..b01187eb6 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -107,6 +107,7 @@ nav: - models/index.md - ACCESS Models: - models/access_models/index.md + - ACCESS-AM: models/access_models/access-am.md - ACCESS-CM: models/access_models/access-cm.md - ACCESS-ESM: models/access_models/access-esm.md - ACCESS-OM: models/access_models/access-om.md From 3acf342b347f51857ab25caea65bfaf878347000 Mon Sep 17 00:00:00 2001 From: Claire Carouge Date: Fri, 21 Nov 2025 10:22:26 +1100 Subject: [PATCH 38/72] Correct path to ACCESS-AM logo --- docs/models/access_models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index d82c22086..9e3fbb151 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -1,6 +1,6 @@ # ACCESS-AM -![ACCESS AM model](/assets/model-config-logos/configurations-without-tiles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} +![ACCESS AM model](/assets/model-config-logos/configurations-without-titles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). From a03903d3780584f37126c8f05df970a32e9d409e Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 10:27:24 +1100 Subject: [PATCH 39/72] Add link to specific section of rose/cylc docs in last paragraph --- docs/models/run_a_model/run_access-am3.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index d0adcf426..dc745b239 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -51,9 +51,9 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc ## Get {{model}} configuration and run it -Follow the instructions in the _Rose/Cylc_ page using the following specific information: +Follow the instructions in the [_Rose/Cylc_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) page using the following specific information in : - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} -See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. \ No newline at end of file +See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 37f3e2d279a17183873f5c62b3a84e1aae2e295c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 10:46:22 +1100 Subject: [PATCH 40/72] Add AM3 model card to run a model page --- docs/models/run_a_model/index.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/models/run_a_model/index.md b/docs/models/run_a_model/index.md index 614f61d13..de1c01689 100644 --- a/docs/models/run_a_model/index.md +++ b/docs/models/run_a_model/index.md @@ -13,6 +13,15 @@ If you are unsure which ACCESS model is the best fit for your application, you c Run models using Rose/Cylc + + +
+ ACCESS-AM +
+
+ Run ACCESS-CM +
+
From b75588d4866f1631e7fb04bcab9da9ccd439816a Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 10:48:27 +1100 Subject: [PATCH 41/72] Add correct link to github section --- docs/models/run_a_model/run_access-am3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index dc745b239..1bd8d2003 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -51,7 +51,7 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc ## Get {{model}} configuration and run it -Follow the instructions in the [_Rose/Cylc_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) page using the following specific information in : +Follow the instructions in the _Rose/Cylc_ page using the following specific information in the [Models configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} From fbeb38d1ad557aaedc9054d129bb3b2d66ef65ba Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 10:48:54 +1100 Subject: [PATCH 42/72] Remove misnamed run_access_am file --- docs/models/run_a_model/run_access_am.md | 30 ------------------------ 1 file changed, 30 deletions(-) delete mode 100644 docs/models/run_a_model/run_access_am.md diff --git a/docs/models/run_a_model/run_access_am.md b/docs/models/run_a_model/run_access_am.md deleted file mode 100644 index c8cd664e4..000000000 --- a/docs/models/run_a_model/run_access_am.md +++ /dev/null @@ -1,30 +0,0 @@ -{% set model = "ACCESS-AM3" %} -{% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} -{% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} -{% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} -{% set example_branch = "main" %} - -# Run {{ model }} - -## Quick Start - -!!! warning - If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. - -!!! warning - These configurations are based off licensed configurations from the UK Met Office (UKMO). This means the configurations repository is private. To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). - -{{ model }} configurations are hosted on the [access-am3-configs]({{ github_configs }}) _GitHub_ repository and use the [_Rose/Cylc_ workflow tool](/models/run-a-model/rose-cylc). The _Cylc_ version and remote host location are: - -* [_Cylc_ version](/models/run-a-model/rose-cylc/#rose-and-cylc-executables): 7 -* [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} -* [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} - -In addition to the projects specified in the [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc/#prerequisites), the following project memberships are required: -* [access](https://my.nci.org.au/mancini/project/access/join) -* [ki32](https://my.nci.org.au/mancini/project/ki32/join) -* [ki32_mosrs](https://my.nci.org.au/mancini/project/ki32_mosrs/join) -* [vk83](https://my.nci.org.au/mancini/project/vk83/join) -* [xp65](https://my.nci.org.au/mancini/project/xp65/join) - -See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 1ed2fe9013a24c74a32422645da332326af1b18d Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 11:01:54 +1100 Subject: [PATCH 43/72] Add AM3 mentions to the appropriate model components --- .../model_components/aerosols_atmospheric_chemistry.md | 6 ++++-- docs/models/model_components/atmosphere.md | 1 + docs/models/model_components/bgc_land.md | 1 + docs/models/model_components/land.md | 1 + 4 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/models/model_components/aerosols_atmospheric_chemistry.md b/docs/models/model_components/aerosols_atmospheric_chemistry.md index 442a520d2..68758752f 100644 --- a/docs/models/model_components/aerosols_atmospheric_chemistry.md +++ b/docs/models/model_components/aerosols_atmospheric_chemistry.md @@ -7,11 +7,13 @@ The [UK Chemistry-Aerosol model (UKCA)](https://www.ukca.ac.uk/wiki/index.php/UKCA) is a community atmospheric chemistry-aerosol global model developed in the United Kingdom. It is suitable for a range of topics in climate and environmental change research. ### Models that use UKCA -- [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (optional). +- [ACCESS-AM3](/models/access_models/access-am#access-am3) +- [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (optional) ## GLOMAP UKCA contains the [GLObal Model of Aerosol Processes (GLOMAP)](https://www.ukca.ac.uk/wiki/index.php/Aerosol_Subproject) aerosol scheme, that can also be used independently. The multi-component, multi-modal GLOMAP model allows simulation of aerosol number, size and concentrations of individual components such as sulphate, sea salt, and different types of carbon. ### Models that use GLOMAP -- [ACCESS-CM2](/models/access_models/access-cm#access-cm2). +- [ACCESS-AM3](/models/access_models/access-am#access-am3) +- [ACCESS-CM2](/models/access_models/access-cm#access-cm2) diff --git a/docs/models/model_components/atmosphere.md b/docs/models/model_components/atmosphere.md index 6bb573863..0a380ced0 100644 --- a/docs/models/model_components/atmosphere.md +++ b/docs/models/model_components/atmosphere.md @@ -7,6 +7,7 @@ The UK Met Office [Unified Model (UM)](https://www.metoffice.gov.uk/research/approach/modelling-systems/unified-model) is a numerical model of the atmosphere used for both weather and climate applications across a wide range of temporal scales (nowcasting to centennial) and spatial scales (sub km convective scale to global). The UM includes solutions of the equations of atmospheric fluid dynamics with advanced parameterisations of physical processes like convection, cloud formation and atmospheric radiation. ### Models that use the UM +- [ACCESS-AM3](/models/access_models/access-am#access-am3) - [ACCESS-CM2](/models/access_models/access-cm#access-cm2) - [ACCESS-ESM1.5](/models/access_models/access-esm#access-esm15) - [ACCESS-rAM3](/models/access_models/access-ram#access-ram3) diff --git a/docs/models/model_components/bgc_land.md b/docs/models/model_components/bgc_land.md index 3c26278e3..06381f73f 100644 --- a/docs/models/model_components/bgc_land.md +++ b/docs/models/model_components/bgc_land.md @@ -8,5 +8,6 @@ The [Carnegie-Ames-Stanford Approach with Carbon-Nitrogen-Phosphorus (CASA-CNP)](https://carbonwaterobservatory.csiro.au/casa.html) is the biogeochemical module implemented in the ACCESS land surface model [CABLE](/models/model_components/land#cable). It models the dynamics of carbon pools and the dependence of carbon uptake due to nitrogen and phosphorous limitations. ### Models that use CASA-CNP +- [ACCESS-AM3](/models/access_models/access-am) (enabled with [CABLE](/models/model_components/land#cable)) - [ACCESS-ESM1.5](/models/access_models/access-esm) (enabled within [CABLE](/models/model_components/land#cable)) diff --git a/docs/models/model_components/land.md b/docs/models/model_components/land.md index 962741627..154a0672c 100644 --- a/docs/models/model_components/land.md +++ b/docs/models/model_components/land.md @@ -11,6 +11,7 @@ Refer to [CABLE documentation](https://cable.readthedocs.io/en/latest/user_guide ### Models that use CABLE +- [ACCESS-AM3](/models/access_models/access-am#access-am3) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) - [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) - [ACCESS-ESM1.5](/models/access_models/access-esm#access-esm15) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) From 78938cf9d8713b0faa99a2f2b840da2a4907d88c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 11:29:51 +1100 Subject: [PATCH 44/72] Fix AM run a model card --- docs/models/run_a_model/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/index.md b/docs/models/run_a_model/index.md index de1c01689..1adb5ff3f 100644 --- a/docs/models/run_a_model/index.md +++ b/docs/models/run_a_model/index.md @@ -19,7 +19,7 @@ If you are unsure which ACCESS model is the best fit for your application, you c ACCESS-AM
- Run ACCESS-CM + Run ACCESS-AM
From 3edf7256090506f21df058fb37f611e11832bfe2 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Fri, 21 Nov 2025 16:38:49 +1100 Subject: [PATCH 45/72] Change wording slightly to make clear all components are necessarily always active --- docs/models/access_models/access-am.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 9e3fbb151..f8381a92f 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -2,7 +2,7 @@ ![ACCESS AM model](/assets/model-config-logos/configurations-without-titles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} -The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that includes [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land). +The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model that can include [atmosphere](/models/model_components/atmosphere), [aerosols and atmospheric chemistry](/models/model_components/aerosols_atmospheric_chemsitry), [land](/models/model_components/land) and [land biogeochemistry](/models/model_components/bgc_land), depending on the configuration. {% set model = "ACCESS-AM3" %} ## {{ model }} From 5a21df3c806f533081fd68ea068ffbdd21dc9ad7 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 24 Nov 2025 11:02:27 +1100 Subject: [PATCH 46/72] Set image to ESM image and add some more links to run a model page --- docs/models/run_a_model/index.md | 2 +- docs/models/run_a_model/run_access-am3.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/models/run_a_model/index.md b/docs/models/run_a_model/index.md index 1adb5ff3f..e3ec5c3ce 100644 --- a/docs/models/run_a_model/index.md +++ b/docs/models/run_a_model/index.md @@ -16,7 +16,7 @@ If you are unsure which ACCESS model is the best fit for your application, you c
- ACCESS-AM + ACCESS-ESM
Run ACCESS-AM diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 1bd8d2003..ba5a1a721 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -9,7 +9,7 @@ ## About -The instructions below outline how to run {{ model }} using ACCESS-NRI's software deployment pipeline, specifically designed to run on the [National Computational Infrastructure (NCI)](https://nci.org.au/about-us/who-we-are) supercomputer [_Gadi_][gadi]. +The instructions below outline how to run {{ model }} using ACCESS-NRI's software deployment pipeline, specifically designed to run on the [National Computational Infrastructure (NCI)](https://nci.org.au/about-us/who-we-are) supercomputer [_Gadi_](https://nci.org.au/our-systems/hpc-systems). If you are unsure whether {{ model }} is the right choice for your experiment, take a look at the overview of [ACCESS Models](/models). @@ -51,7 +51,7 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc ## Get {{model}} configuration and run it -Follow the instructions in the _Rose/Cylc_ page using the following specific information in the [Models configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: +Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc.md) using the following specific information in the [Models configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} From 0b5a27853583617bba23bc1635a77a6b5ce2889c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 24 Nov 2025 11:22:49 +1100 Subject: [PATCH 47/72] Accidentally changed preview instead of card image --- docs/models/run_a_model/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/index.md b/docs/models/run_a_model/index.md index e3ec5c3ce..e0ecd5fcd 100644 --- a/docs/models/run_a_model/index.md +++ b/docs/models/run_a_model/index.md @@ -16,7 +16,7 @@ If you are unsure which ACCESS model is the best fit for your application, you c
- ACCESS-ESM + ACCESS-AM
Run ACCESS-AM From 9e83e5897fb9566d305b3597d8c3116156832843 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 24 Nov 2025 11:24:53 +1100 Subject: [PATCH 48/72] Specify atmos chemistry as optional for AM3 --- docs/models/model_components/aerosols_atmospheric_chemistry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/model_components/aerosols_atmospheric_chemistry.md b/docs/models/model_components/aerosols_atmospheric_chemistry.md index 68758752f..0c47d04bc 100644 --- a/docs/models/model_components/aerosols_atmospheric_chemistry.md +++ b/docs/models/model_components/aerosols_atmospheric_chemistry.md @@ -7,7 +7,7 @@ The [UK Chemistry-Aerosol model (UKCA)](https://www.ukca.ac.uk/wiki/index.php/UKCA) is a community atmospheric chemistry-aerosol global model developed in the United Kingdom. It is suitable for a range of topics in climate and environmental change research. ### Models that use UKCA -- [ACCESS-AM3](/models/access_models/access-am#access-am3) +- [ACCESS-AM3](/models/access_models/access-am#access-am3) (optional) - [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (optional) ## GLOMAP From b717c63d6dbe0274b79f5801c6b12272fb138efe Mon Sep 17 00:00:00 2001 From: Claire Carouge Date: Mon, 24 Nov 2025 15:02:00 +1100 Subject: [PATCH 49/72] Update run_access-am3.md with setup instructions Added sections for configuration setup and running the model. --- docs/models/run_a_model/run_access-am3.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index ba5a1a721..1a42d4897 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -49,11 +49,21 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc For more information on joining specific NCI projects, refer to [How to connect to a project](https://opus.nci.org.au/display/Help/How+to+connect+to+a+project). -## Get {{model}} configuration and run it +## Get {{model}} configuration Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc.md) using the following specific information in the [Models configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} +## Setup the configuration + +Before you can run the configuration, you need to specify which projects you want to use for data storage and compute costs. For this, in the configuration you have just retrieved from GitHub, open the `rose-suite.conf_nci_gadi` file and change: + +- `root_dir` to the path you want to use as a work directory for running the simulation. A space under /scratch is ideal. The directory will be created by the suite if it does not exist. +- `STORAGE_PROJECT` must be the same project as used in the `root_dir` path. +- `COMPUTE_PROJECT` to any project you want to use for the compute cost. + +## Run the configuration + See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 1c02304123198ada74b4a3d444b368ddd491e116 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 24 Nov 2025 16:18:04 +1100 Subject: [PATCH 50/72] Add JULES bits for AM3 --- docs/models/access_models/access-am.md | 2 +- docs/models/model_components/land.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index f8381a92f..23ce05631 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -19,7 +19,7 @@ ACCESS-NRI has released [{{ model }} configurations](/models/run_a_model/run_acc - **Aerosols and Atmospheric Chemistry**: [GLOMAP](/models/model_components/aerosols_atmospheric_chemistry#glomap) and [UKCA](/models/model_components/aerosols_atmospheric_chemistry#UKCA). -- **Land**: [CABLE](/models/model_components/land#cable). +- **Land**: [CABLE](/models/model_components/land#cable) and [JULES](/models/model_components/land#jules). - **Land Biogeochemistry**: [CASA-CNP](/models/model_components/bgc_land#casa_cnp). diff --git a/docs/models/model_components/land.md b/docs/models/model_components/land.md index 154a0672c..5f38f6789 100644 --- a/docs/models/model_components/land.md +++ b/docs/models/model_components/land.md @@ -11,7 +11,7 @@ Refer to [CABLE documentation](https://cable.readthedocs.io/en/latest/user_guide ### Models that use CABLE -- [ACCESS-AM3](/models/access_models/access-am#access-am3) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) +- [ACCESS-AM3](/models/access_models/access-am#access-am3) (coupled into the [JULES](/models/model_components/land#jules)) - [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) - [ACCESS-ESM1.5](/models/access_models/access-esm#access-esm15) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) @@ -36,6 +36,7 @@ To learn more about _benchcab_, its functionalities and limitations, refer to [_ The [Joint UK Land Environment System (JULES)](https://jules.jchmr.org/) is a community land surface model that can be used both as a standalone model and as the land surface component in the UM model. By modelling different land surface processes (surface energy balance, hydrological cycle, carbon cycle, dynamic vegetation, etc.) and their interaction with each other, JULES provides a framework to assess the impact of modifying a particular process on the ecosystem as a whole, for example the impact of climate change on hydrology. ### Models that use JULES +- [ACCESS-AM3](/models/access_models/access-am#access-am3) (complementing [CABLE](/models/model_components/land#cable)) - [ACCESS-rAM3](/models/access_models/access-ram#access-ram3) Other ACCESS models used for weather simulations, not supported by ACCESS-NRI, use JULES. Examples are ACCESS-S and ACCESS-C developed by the [Bureau of Meteorology (BoM)](https://www.bom.gov.au/). From aeef13ae2b12f22262b5808f5ba19dd615bcb57c Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 26 Nov 2025 10:11:27 +1100 Subject: [PATCH 51/72] Update name of section based on rose/cylc docs bit --- docs/models/run_a_model/run_access-am3.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 1a42d4897..cafa36961 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -56,11 +56,11 @@ Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc. - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} -## Setup the configuration +## Initial Setup Before you can run the configuration, you need to specify which projects you want to use for data storage and compute costs. For this, in the configuration you have just retrieved from GitHub, open the `rose-suite.conf_nci_gadi` file and change: -- `root_dir` to the path you want to use as a work directory for running the simulation. A space under /scratch is ideal. The directory will be created by the suite if it does not exist. +- `root_dir` to the path you want to use as a work directory for running the simulation. A space under `/scratch` is ideal. The directory will be created by the suite if it does not exist. - `STORAGE_PROJECT` must be the same project as used in the `root_dir` path. - `COMPUTE_PROJECT` to any project you want to use for the compute cost. From c6bf8e48c9a10b712880ab894ebce7e5a5634ba1 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Wed, 26 Nov 2025 12:57:10 +1100 Subject: [PATCH 52/72] Update docs/models/access_models/index.md Co-authored-by: Claire Carouge --- docs/models/access_models/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/access_models/index.md b/docs/models/access_models/index.md index 420ecd76f..2f6f73ae2 100644 --- a/docs/models/access_models/index.md +++ b/docs/models/access_models/index.md @@ -14,7 +14,7 @@ Below is a list of ACCESS models supported by ACCESS-NRI.
ACCESS-AM - A global atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemsitry components. + A global atmospheric model that includes atmosphere, land, atmospheric chemistry, aerosols and land biogeochemistry components.
From 5223d301f69d99b0e8feda6fce0f9c33cc768065 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Wed, 26 Nov 2025 12:57:22 +1100 Subject: [PATCH 53/72] Update docs/models/model_components/bgc_land.md Co-authored-by: Claire Carouge --- docs/models/model_components/bgc_land.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/model_components/bgc_land.md b/docs/models/model_components/bgc_land.md index 06381f73f..d772b2fb4 100644 --- a/docs/models/model_components/bgc_land.md +++ b/docs/models/model_components/bgc_land.md @@ -8,6 +8,6 @@ The [Carnegie-Ames-Stanford Approach with Carbon-Nitrogen-Phosphorus (CASA-CNP)](https://carbonwaterobservatory.csiro.au/casa.html) is the biogeochemical module implemented in the ACCESS land surface model [CABLE](/models/model_components/land#cable). It models the dynamics of carbon pools and the dependence of carbon uptake due to nitrogen and phosphorous limitations. ### Models that use CASA-CNP -- [ACCESS-AM3](/models/access_models/access-am) (enabled with [CABLE](/models/model_components/land#cable)) +- [ACCESS-AM3](/models/access_models/access-am) (enabled within [CABLE](/models/model_components/land#cable)) - [ACCESS-ESM1.5](/models/access_models/access-esm) (enabled within [CABLE](/models/model_components/land#cable)) From 93cf2208a2188e9b86c47fdb4909cc9c3d0d6468 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Wed, 26 Nov 2025 12:57:45 +1100 Subject: [PATCH 54/72] Update docs/models/model_components/land.md Co-authored-by: Claire Carouge --- docs/models/model_components/land.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/model_components/land.md b/docs/models/model_components/land.md index 5f38f6789..1c633b61a 100644 --- a/docs/models/model_components/land.md +++ b/docs/models/model_components/land.md @@ -11,7 +11,7 @@ Refer to [CABLE documentation](https://cable.readthedocs.io/en/latest/user_guide ### Models that use CABLE -- [ACCESS-AM3](/models/access_models/access-am#access-am3) (coupled into the [JULES](/models/model_components/land#jules)) +- [ACCESS-AM3](/models/access_models/access-am#access-am3) (coupled into [JULES](/models/model_components/land#jules)) - [ACCESS-CM2](/models/access_models/access-cm#access-cm2) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) - [ACCESS-ESM1.5](/models/access_models/access-esm#access-esm15) (directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um)) From 8ba664620edb49aac0d8cc6cb4b6247cc8b9db97 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Wed, 26 Nov 2025 16:15:00 +1100 Subject: [PATCH 55/72] Minor fixes and rewording end of run a model page --- docs/models/access_models/access-am.md | 2 +- docs/models/run_a_model/run_access-am3.md | 16 +++++++++++----- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 23ce05631..44b38dab0 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -7,7 +7,7 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a set of coupled atmosphere-land configurations developed by ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by the ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). ACCESS-NRI has released [{{ model }} configurations](/models/run_a_model/run_access-am3). diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index cafa36961..f8569cdf2 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -13,7 +13,7 @@ The instructions below outline how to run {{ model }} using ACCESS-NRI's softwar If you are unsure whether {{ model }} is the right choice for your experiment, take a look at the overview of [ACCESS Models](/models). -All {{model}} configurations are licensed under the UKMO's [Momentum licence](). {{model}} is delivered to the community through private GitHub repositories. See the [Prerequisites](#prerequisites) section for details. +All {{model}} configurations are licensed under the UKMO's Momentum licence. {{model}} is delivered to the community through private GitHub repositories. See the [Prerequisites](#prerequisites) section for details. {{ model }} release notes are [available on the ACCESS-Hive Forum]({{release_notes}}) and are updated when new releases are made available. @@ -25,7 +25,7 @@ All {{model}} configurations are licensed under the UKMO's [Momentum licence](). In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc/#prerequisites), you will need: - **Request access to the configurations**
- To request access to the configurations repository (and associated model component repositories), please contact us [through the forum](). This step will also allow us to check you are properly licensed to use the software. + To request access to the configurations repository (and associated model component repositories), please contact us [through the ACCESS-Hive Forum](https://forum.access-hive.org.au/t/request-access-to-am3-configurations/5580/13). This step will also allow us to check you are properly licensed to use the software. - **Join NCI projects**
Join the following projects by requesting membership on their respective NCI project pages: @@ -51,7 +51,7 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc ## Get {{model}} configuration -Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc.md) using the following specific information in the [Models configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: +Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc.md) using the following specific information in the [Model configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} @@ -60,10 +60,16 @@ Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc. Before you can run the configuration, you need to specify which projects you want to use for data storage and compute costs. For this, in the configuration you have just retrieved from GitHub, open the `rose-suite.conf_nci_gadi` file and change: -- `root_dir` to the path you want to use as a work directory for running the simulation. A space under `/scratch` is ideal. The directory will be created by the suite if it does not exist. +- `root_dir` to the path you want to use as a work directory for running the simulation. A space under `/scratch/` is ideal, where `` is the project associated with the current work. The directory will be created by the suite if it does not exist. - `STORAGE_PROJECT` must be the same project as used in the `root_dir` path. - `COMPUTE_PROJECT` to any project you want to use for the compute cost. -## Run the configuration +Now the configuration can be run using the [Run the model configuration](/models/run-a-model/rose-cylc/#run-the-model-configuration) instructions. + +## Inspecting the outputs + +The outputs are placed in the directory specified in `STORAGE_PROJECT`, under `cylc-run/`. + +## Further Information See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 20fbea47fc244e41125bdc1bd7bd0f60589d312f Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Wed, 26 Nov 2025 16:16:55 +1100 Subject: [PATCH 56/72] Update docs/models/run_a_model/run_access-am3.md Co-authored-by: Claire Carouge --- docs/models/run_a_model/run_access-am3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index f8569cdf2..3ff84b539 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -3,7 +3,7 @@ {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} {% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} {% set example_branch = "main" %} -{% set release_notes = "" %} +{% set release_notes = "https://forum.access-hive.org.au/t/access-am3-release-information/5446" %} # Run {{ model }} From 2824a99bd6ff5acf1dc608455bb60a5c053104cf Mon Sep 17 00:00:00 2001 From: Whyborn Date: Thu, 27 Nov 2025 08:50:43 +1100 Subject: [PATCH 57/72] Specify ACCESS-AM3 at end --- docs/models/run_a_model/run_access-am3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 3ff84b539..fec9ebed6 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -72,4 +72,4 @@ The outputs are placed in the directory specified in `STORAGE_PROJECT`, under `c ## Further Information -See the [model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. +See the [ACCESS-AM3 model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. From 9e8d910e1a1aef83a78745d4083cce7d1e6df7b6 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Thu, 27 Nov 2025 11:17:42 +1100 Subject: [PATCH 58/72] Update docs/models/run_a_model/run_access-am3.md Co-authored-by: Claire Carouge --- docs/models/run_a_model/run_access-am3.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index fec9ebed6..4437b793d 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -68,7 +68,8 @@ Now the configuration can be run using the [Run the model configuration](/models ## Inspecting the outputs -The outputs are placed in the directory specified in `STORAGE_PROJECT`, under `cylc-run/`. +The netCDF outputs are placed in `~/cylc-run//share/data/History_Data/netCDF`. +The outputs in UMFields format are placed in `~/cylc-run//share/data/History_Data`. ## Further Information From 929f8e62265536d776d599e71e47aa984678f97d Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Mon, 1 Dec 2025 15:09:24 +1100 Subject: [PATCH 59/72] Apply suggestions from code review Co-authored-by: Davide Marchegiani --- docs/models/access_models/access-am.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 44b38dab0..70ade1842 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -7,11 +7,14 @@ The ACCESS Atmosphere Model (ACCESS-AM) is a global coupled atmospheric model th {% set model = "ACCESS-AM3" %} ## {{ model }} -{{ model }} is a set of coupled atmosphere-land configurations developed by the ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation](https://www.csiro.au/en/research/natural-environment?start=0&count=12) (CSIRO) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). +{{ model }} is a set of coupled atmosphere-land configurations developed by the ACCESS-NRI, the [Commonwealth Science and Industrial Research Organisation (CSIRO)](https://www.csiro.au/en/research/natural-environment?start=0&count=12) and the [ARC Centre of Excellence for Weather in the 21st Century](https://21centuryweather.org.au/). -ACCESS-NRI has released [{{ model }} configurations](/models/run_a_model/run_access-am3). +ACCESS-NRI has released [{{ model }} configurations](https://github.com/ACCESS-NRI/access-am3-configs). -**Fill in configurations for beta release.** +!!! tip + The configurations GitHub repository is private. To request access to it, follow the related instructions in the [Run {{ model }} page](/models/run_a_model/run_access-am3/#request-access). + + ### Model Components {: #model-components-{{model}} } From e614c03045e8b55ce9a8a1ee949f107d99fdbdbd Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:24:01 +1100 Subject: [PATCH 60/72] Revert accidental whitespace changes --- docs/models/access_models/access-esm.md | 2 +- docs/models/index.md | 2 +- mkdocs.yml | 207 ++++++++++++------------ 3 files changed, 103 insertions(+), 108 deletions(-) diff --git a/docs/models/access_models/access-esm.md b/docs/models/access_models/access-esm.md index a472af5f1..c15bca3df 100644 --- a/docs/models/access_models/access-esm.md +++ b/docs/models/access_models/access-esm.md @@ -40,4 +40,4 @@ There are currently two supported configurations: ACCESS-ESM1.5 has an equilibrium climate sensitivity of 3.87°C for doubled CO~2~ concentration. -[Run ACCESS-ESM](/models/run_a_model/run_access-esm){: class="text-card"} +[Run ACCESS-ESM](/models/run_a_model/run_access-esm){: class="text-card"} \ No newline at end of file diff --git a/docs/models/index.md b/docs/models/index.md index 8462e8e84..7ed2d882e 100644 --- a/docs/models/index.md +++ b/docs/models/index.md @@ -51,4 +51,4 @@
-
+ \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 2c18b8195..75733997e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,11 +1,8 @@ -# This file uses the following environment variables set within the build workflow: -# - SITE_URL: the URL of the site (Falls back to a default URL) -# For example, for PR-previews, SITE_URL is set to /pr-previews/pr-NUM - site_name: ACCESS-Hive Docs # Site URL -site_url: !ENV [SITE_URL, "https://docs.access-hive.org.au/"] +site_url: !ENV READTHEDOCS_CANONICAL_URL +# READTHEDOCS_CANONICAL_URL is set within the website build (GitHub worflow or ReadTheDocs) # Git repository (Adds a link to the GitHub repository at the top) repo_url: https://github.com/ACCESS-NRI/ACCESS-Hive-Docs @@ -39,14 +36,14 @@ theme: - navigation.tabs.sticky - navigation.indexes - navigation.footer - - navigation.tracking # The URL in the address bar is automatically updated with active anchor - - content.code.copy # for displaying copy icon at top right in code snippets + - navigation.tracking # The URL in the address bar is automatically updated with active anchor + - content.code.copy # for displaying copy icon at top right in code snippets - content.code.annotate - content.tabs.link - search.suggest - search.highlight - search.share - - toc.follow # the sidebar is automatically scrolled to the active anchor + - toc.follow # the sidebar is automatically scrolled to the active anchor logo: assets/ACCESS_icon_HIVE.png favicon: assets/ACCESS_icon_HIVE.png @@ -67,7 +64,7 @@ plugins: - macros # Extensions -markdown_extensions: +markdown_extensions: - attr_list - abbr - md_in_html @@ -84,7 +81,7 @@ markdown_extensions: emoji_index: !!python/name:material.extensions.emoji.twemoji emoji_generator: !!python/name:material.extensions.emoji.to_svg - pymdownx.tabbed: - alternate_style: true + alternate_style: true - pymdownx.keys - pymdownx.arithmatex: generic: true @@ -96,111 +93,109 @@ markdown_extensions: # Navigation nav: - - Getting Started: - - getting_started/index.md - - Set Up your NCI Account: getting_started/set_up_nci_account.md - - Australian Research Environment (ARE): getting_started/are.md - - conda/analysis3 Python Environment: getting_started/environments.md - - Set up Spack for building ACCESS models: getting_started/spack.md + - Getting Started: + - getting_started/index.md + - Set Up your NCI Account: getting_started/set_up_nci_account.md + - Australian Research Environment (ARE): getting_started/are.md + - conda/analysis3 Python Environment: getting_started/environments.md + - Set up Spack for building ACCESS models: getting_started/spack.md - Models: - - models/index.md - - ACCESS Models: - - models/access_models/index.md - - ACCESS-AM: models/access_models/access-am.md - - ACCESS-CM: models/access_models/access-cm.md - - ACCESS-ESM: models/access_models/access-esm.md - - ACCESS-OM: models/access_models/access-om.md - - ACCESS-rAM: models/access_models/access-ram.md - - Model Components: - - models/model_components/index.md - - Atmosphere: models/model_components/atmosphere.md - - Land: models/model_components/land.md - - Ocean: models/model_components/ocean.md - - Sea Ice: models/model_components/sea-ice.md - - Aerosols and Atmospheric Chemistry: models/model_components/aerosols_atmospheric_chemistry.md - - Biogeochemistry Land: models/model_components/bgc_land.md - - Biogeochemistry Ocean: models/model_components/bgc_ocean.md - - Coupler: models/model_components/coupler.md - - Run a Model: - - models/run_a_model/index.md - - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md - - Run ACCESS-AM3: models/run_a_model/run_access-am3.md - - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md - - Run ACCESS-ESM: models/run_a_model/run_access-esm.md - - Run ACCESS-OM2: models/run_a_model/run_access-om2.md - - Run ACCESS-OM3: models/run_a_model/run_access-om3.md - - Run ACCESS-rAM: models/run_a_model/run_access-ram.md - - Build a Model: - - models/build_a_model/index.md - - Modify and build an ACCESS model's source code: models/build_a_model/build_source_code.md - - Create Prereleases and Releases for an ACCESS Model: models/build_a_model/create_a_prerelease.md + - models/index.md + - ACCESS Models: + - models/access_models/index.md + - ACCESS-CM: models/access_models/access-cm.md + - ACCESS-ESM: models/access_models/access-esm.md + - ACCESS-OM: models/access_models/access-om.md + - ACCESS-rAM: models/access_models/access-ram.md + - Model Components: + - models/model_components/index.md + - Atmosphere: models/model_components/atmosphere.md + - Land: models/model_components/land.md + - Ocean: models/model_components/ocean.md + - Sea Ice: models/model_components/sea-ice.md + - Aerosols and Atmospheric Chemistry: models/model_components/aerosols_atmospheric_chemistry.md + - Biogeochemistry Land: models/model_components/bgc_land.md + - Biogeochemistry Ocean: models/model_components/bgc_ocean.md + - Coupler: models/model_components/coupler.md + - Run a Model: + - models/run_a_model/index.md + - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md + - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md + - Run ACCESS-ESM: models/run_a_model/run_access-esm.md + - Run ACCESS-OM2: models/run_a_model/run_access-om2.md + - Run ACCESS-OM3: models/run_a_model/run_access-om3.md + - Run ACCESS-rAM: models/run_a_model/run_access-ram.md + - Build a Model: + - models/build_a_model/index.md + - Modify and build an ACCESS model's source code: models/build_a_model/build_source_code.md + - Create Prereleases and Releases for an ACCESS Model: models/build_a_model/create_a_prerelease.md - Data and Model Evaluation: - - model_evaluation/index.md - - Data: - - model_evaluation/data/index.md - - Data Format and Standards: model_evaluation/data/data_format.md - - Data Variables: model_evaluation/data/variables.md - - Observational Data: model_evaluation/data/observations.md - - Accessing Model Data: model_evaluation/data/model_catalogs.md - - - Model Evaluation: - - model_evaluation/evaluation_on_gadi/index.md - # - Frameworks on Gadi: - - ESMValTool: model_evaluation/evaluation_on_gadi/esmvaltool_workflow.md - - ILAMB: model_evaluation/evaluation_on_gadi/ilamb_workflow.md - - COSIMA cookbook: model_evaluation/evaluation_on_gadi/cosima.md - - Model Live Diagnostics: model_evaluation/evaluation_on_gadi/model_live_diagnostics.md - - METplus: model_evaluation/evaluation_on_gadi/metplus.md - - Additional Resources: - - Additional Resources: model_evaluation/community_med/index.md - - Observational Catalogues: model_evaluation/community_med/community_observational_catalogs.md - - Model Catalogues: model_evaluation/community_med/community_model_catalogs.md - - Data Formatting: model_evaluation/community_med/community_data_processing.md - - Evaluation Recipes: model_evaluation/community_med/community_med_recipes.md + - model_evaluation/index.md + - Data: + - model_evaluation/data/index.md + - Data Format and Standards: model_evaluation/data/data_format.md + - Data Variables: model_evaluation/data/variables.md + - Observational Data: model_evaluation/data/observations.md + - Accessing Model Data: model_evaluation/data/model_catalogs.md + + - Model Evaluation: + - model_evaluation/evaluation_on_gadi/index.md + # - Frameworks on Gadi: + - ESMValTool: model_evaluation/evaluation_on_gadi/esmvaltool_workflow.md + - ILAMB: model_evaluation/evaluation_on_gadi/ilamb_workflow.md + - COSIMA cookbook: model_evaluation/evaluation_on_gadi/cosima.md + - Model Live Diagnostics: model_evaluation/evaluation_on_gadi/model_live_diagnostics.md + - METplus: model_evaluation/evaluation_on_gadi/metplus.md + - Additional Resources: + - Additional Resources: model_evaluation/community_med/index.md + - Observational Catalogues: model_evaluation/community_med/community_observational_catalogs.md + - Model Catalogues: model_evaluation/community_med/community_model_catalogs.md + - Data Formatting: model_evaluation/community_med/community_data_processing.md + - Evaluation Recipes: model_evaluation/community_med/community_med_recipes.md - Tutorials: - - tutorials/index.md - - ACCESS-CM2: tutorials/models.md - - ACCESS-NRI Intake catalog: tutorials/intake.md - - ESMValTool: tutorials/esmvaltool.md - - ILAMB: tutorials/ilamb.md - - Payu: tutorials/payu.md - + - tutorials/index.md + - ACCESS-CM2: tutorials/models.md + - ACCESS-NRI Intake catalog: tutorials/intake.md + - ESMValTool: tutorials/esmvaltool.md + - ILAMB: tutorials/ilamb.md + - Payu: tutorials/payu.md + - Community Resources: - - community_resources/index.md - # Keep this commented for future workshops - # - ACCESS Community Workshop 2025: - # - Overview: community_resources/access_workshop_2025/index.md - # - Training Day materials: community_resources/access_workshop_2025/training_materials.md - - Workshops and Events Archive: - - community_resources/workshops_events_archive/index.md - - ACCESS Community Workshop 2023: - - Overview: community_resources/workshops_events_archive/access_workshop_2023/index.md - - Training materials 2023: community_resources/workshops_events_archive/access_workshop_2023/training_materials.md - - ACCESS Community Workshop 2024: - - Overview: community_resources/workshops_events_archive/access_workshop_2024/index.md - - Training materials 2024: community_resources/workshops_events_archive/access_workshop_2024/training_materials.md - - ACCESS Community Workshop 2025: - - Overview: community_resources/workshops_events_archive/access_workshop_2025/index.md - - Training materials 2025: community_resources/workshops_events_archive/access_workshop_2025/training_materials.md - - Working Groups: community_resources/community_working_groups.md - - External Resources: community_resources/external_resources.md - - Glossaries: community_resources/glossaries.md + - community_resources/index.md + # Keep this commented for future workshops + # - ACCESS Community Workshop 2025: + # - Overview: community_resources/access_workshop_2025/index.md + # - Training Day materials: community_resources/access_workshop_2025/training_materials.md + - Workshops and Events Archive: + - community_resources/workshops_events_archive/index.md + - ACCESS Community Workshop 2023: + - Overview: community_resources/workshops_events_archive/access_workshop_2023/index.md + - Training materials 2023: community_resources/workshops_events_archive/access_workshop_2023/training_materials.md + - ACCESS Community Workshop 2024: + - Overview: community_resources/workshops_events_archive/access_workshop_2024/index.md + - Training materials 2024: community_resources/workshops_events_archive/access_workshop_2024/training_materials.md + - ACCESS Community Workshop 2025: + - Overview: community_resources/workshops_events_archive/access_workshop_2025/index.md + - Training materials 2025: community_resources/workshops_events_archive/access_workshop_2025/training_materials.md + - Working Groups: community_resources/community_working_groups.md + - External Resources: community_resources/external_resources.md + - Glossaries: community_resources/glossaries.md - About: - - about/index.md - - Contact: about/contact.md - - Release stages: about/releases.md - - FAQ: about/faq.md - - User support: about/user_support.md - - How to Contribute: about/contribute.md - - License: about/License.md + - about/index.md + - Contact: about/contact.md + - Release stages: about/releases.md + - FAQ: about/faq.md + - User support: about/user_support.md + - How to Contribute: about/contribute.md + - License: about/License.md # Footer extra: generator: false social: - - icon: fontawesome/brands/bluesky + - icon: fontawesome/brands/bluesky link: https://bsky.app/profile/access-nri.bsky.social name: ACCESS-NRI on Bluesky - icon: fontawesome/brands/linkedin @@ -220,12 +215,12 @@ extra: # - icon: material/emoticon-sad-outline # name: This page could be improved # data: 0 - # note: >- + # note: >- # Thanks for your feedback!
# Help us improve this page by contributing! extra_css: - - "https://fonts.googleapis.com/icon?family=Material+Icons" # Material Icons Reference - https://material.io/resources/icons/?style=baseline + - "https://fonts.googleapis.com/icon?family=Material+Icons" # Material Icons Reference - https://material.io/resources/icons/?style=baseline - fontawesome-free-6.4.0-web/css/all.css - fontello/css/fontello-codes.css - fontello/css/fontello-ie7-codes.css @@ -240,7 +235,7 @@ extra_javascript: - js/custom-tags.js - js/miscellaneous.js -# Automatically reload page when running `mkdocs serve`, for any +# Automatically reload page when running `mkdocs serve`, for any # of the following files outside of the 'docs' directory watch: - mkdocs.yml From acdf958190aa71fca2e248f44181e73f3ccccdb3 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:28:11 +1100 Subject: [PATCH 61/72] mkdocs additions without unintential whitespace --- mkdocs.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/mkdocs.yml b/mkdocs.yml index 75733997e..d480ada2b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -104,6 +104,7 @@ nav: - models/index.md - ACCESS Models: - models/access_models/index.md + - ACCESS-AM: models/access_models/access-am.md - ACCESS-CM: models/access_models/access-cm.md - ACCESS-ESM: models/access_models/access-esm.md - ACCESS-OM: models/access_models/access-om.md @@ -121,6 +122,7 @@ nav: - Run a Model: - models/run_a_model/index.md - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md + - Run ACCESS-AM3: models/run_a_model/run_access-am3.md - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md - Run ACCESS-ESM: models/run_a_model/run_access-esm.md - Run ACCESS-OM2: models/run_a_model/run_access-om2.md From 40f80bf545f6f1ac8b543d29795266ba240676a2 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:36:15 +1100 Subject: [PATCH 62/72] Add release statement to AM3 pages --- docs/models/access_models/access-am.md | 3 +++ docs/models/run_a_model/run_access-am3.md | 3 +++ 2 files changed, 6 insertions(+) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 70ade1842..66f39f81e 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -1,3 +1,6 @@ +!!! release + This is an [Alpha Release](/about/releases). + # ACCESS-AM ![ACCESS AM model](/assets/model-config-logos/configurations-without-titles/access-am.png){: class="img-contain white-background round-edges with-padding intro-img" loading="lazy"} diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 4437b793d..80f72258b 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -5,6 +5,9 @@ {% set example_branch = "main" %} {% set release_notes = "https://forum.access-hive.org.au/t/access-am3-release-information/5446" %} +!!! release + This is an [Alpha Release](/about/releases). + # Run {{ model }} ## About From 60f3c30782ea6e7020900567e83479e43ff3a86d Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:37:28 +1100 Subject: [PATCH 63/72] Update run_a_model cards with vn number --- docs/models/run_a_model/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/run_a_model/index.md b/docs/models/run_a_model/index.md index e0ecd5fcd..1548a90a5 100644 --- a/docs/models/run_a_model/index.md +++ b/docs/models/run_a_model/index.md @@ -13,13 +13,13 @@ If you are unsure which ACCESS model is the best fit for your application, you c Run models using Rose/Cylc - +
ACCESS-AM
- Run ACCESS-AM + Run ACCESS-AM3
From 6a158a269758b0ce3dbf965fba76149d723c6af9 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Mon, 1 Dec 2025 15:38:18 +1100 Subject: [PATCH 64/72] Apply suggestions from code review Co-authored-by: Davide Marchegiani --- docs/models/run_a_model/run_access-am3.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 80f72258b..9db4c4156 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -16,19 +16,20 @@ The instructions below outline how to run {{ model }} using ACCESS-NRI's softwar If you are unsure whether {{ model }} is the right choice for your experiment, take a look at the overview of [ACCESS Models](/models). -All {{model}} configurations are licensed under the UKMO's Momentum licence. {{model}} is delivered to the community through private GitHub repositories. See the [Prerequisites](#prerequisites) section for details. +All {{model}} configurations are licensed under the UKMO's Momentum licence. {{model}} is delivered to the community through private GitHub repositories. See the [Request access prerequisite](#request-access) for details. {{ model }} release notes are [available on the ACCESS-Hive Forum]({{release_notes}}) and are updated when new releases are made available. ## Prerequisites !!! warning - If you have not yet read the guide on using the _Rose/Cylc_ tool, please read our [_Rose/Cylc_ documentation](/models/run-a-model/rose-cylc.md) before continuing. + Before continuing, make sure you have read the guide on [running models using _Rose/Cylc_](/models/run-a-model/rose-cylc.md). -In addition to the [prerequisites for _Rose/Cylc_](/models/run-a-model/rose-cylc/#prerequisites), you will need: +In addition to the [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc/#prerequisites), you will need: - **Request access to the configurations**
To request access to the configurations repository (and associated model component repositories), please contact us [through the ACCESS-Hive Forum](https://forum.access-hive.org.au/t/request-access-to-am3-configurations/5580/13). This step will also allow us to check you are properly licensed to use the software. + {: #request-access } - **Join NCI projects**
Join the following projects by requesting membership on their respective NCI project pages: From 9b139f26b83c9a87dfb0739688eb801c20bf8756 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:43:31 +1100 Subject: [PATCH 65/72] Add cards to top of page --- docs/models/run_a_model/run_access-am3.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 9db4c4156..dbfa1931f 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -8,6 +8,12 @@ !!! release This is an [Alpha Release](/about/releases). +
+[:fontawesome-brands-github:{: class="twemoji icon-before-text"} {{ model }} configurations]({{github_configs}}){: class="text-card"} +[![Hive](/assets/ACCESS_icon_HIVE.png){: class="icon-before-text"} {{ model }} configs docs]({{configs_docs}}){: class="text-card"} +[:notepad_spiral:{: class="twemoji icon-before-text"} Release notes]({{release_notes}}){: class="text-card"} +
+ # Run {{ model }} ## About From 424ab316beeac9523b8615cfb7878e394b57584f Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:47:30 +1100 Subject: [PATCH 66/72] Change to css and associated removals in page --- docs/css/access-nri.css | 7 ++++++- docs/models/run_a_model/run_access-am3.md | 4 +--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/css/access-nri.css b/docs/css/access-nri.css index 645190910..6a3ffdbe3 100644 --- a/docs/css/access-nri.css +++ b/docs/css/access-nri.css @@ -461,6 +461,11 @@ h1.homepage { /* =============================================================== Admonitions (https://squidfunk.github.io/mkdocs-material/reference/admonitions/) +*/ + +.admonition > ul li { + list-style-type: disc !important; +} /* General style admonition (In markdown --> `!!! ...`) */ .admonition { @@ -1448,4 +1453,4 @@ div.release-table td:nth-child(3) { } div.release-table td:nth-child(4) { background-color: var(--success-bg) -} \ No newline at end of file +} diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index dbfa1931f..c012f6ba7 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -50,9 +50,7 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc To request membership for the _ki32_mosrs_ subproject, you need to: - already be member of the _ki32_ project - {: style="list-style-type: disc"} - - have a [MOSRS account](#mosrs-account) - {: style="list-style-type: disc"} + - have a [MOSRS account](/models/run_a_model/rose_cylc/#mosrs-account) !!! warning You will not be granted access to some of the projects listed here before we have checked you are properly licensed to use the software. Ensure you request access to the configurations first. From 4a52bde252a627868d9fb51c035dcdb87c76c7d3 Mon Sep 17 00:00:00 2001 From: Whyborn Date: Mon, 1 Dec 2025 15:52:12 +1100 Subject: [PATCH 67/72] Flesh out release admonition --- docs/models/access_models/access-am.md | 2 +- docs/models/run_a_model/run_access-am3.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/access_models/access-am.md b/docs/models/access_models/access-am.md index 66f39f81e..3d523f709 100644 --- a/docs/models/access_models/access-am.md +++ b/docs/models/access_models/access-am.md @@ -1,5 +1,5 @@ !!! release - This is an [Alpha Release](/about/releases). + This is an [**Alpha Release**](/about/releases), intended for use by experienced users and collaborators. Any model configuration and related source code information on this page may change during the release process. # ACCESS-AM diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index c012f6ba7..0c1f53e05 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -6,7 +6,7 @@ {% set release_notes = "https://forum.access-hive.org.au/t/access-am3-release-information/5446" %} !!! release - This is an [Alpha Release](/about/releases). + This is an [**Alpha Release**](/about/releases), intended for use by experienced users and collaborators. Any model configuration and related source code information on this page may change during the release process.
[:fontawesome-brands-github:{: class="twemoji icon-before-text"} {{ model }} configurations]({{github_configs}}){: class="text-card"} From 213d9c9f3fc15e865857a1a9b7341a9bb0fe449a Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Mon, 1 Dec 2025 15:54:04 +1100 Subject: [PATCH 68/72] Update docs/models/run_a_model/run_access-am3.md Co-authored-by: Davide Marchegiani --- docs/models/run_a_model/run_access-am3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 0c1f53e05..80ddb6392 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -53,7 +53,7 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc - have a [MOSRS account](/models/run_a_model/rose_cylc/#mosrs-account) !!! warning - You will not be granted access to some of the projects listed here before we have checked you are properly licensed to use the software. Ensure you request access to the configurations first. + You will not be granted access to some of the projects listed here before we have checked you are properly licensed to use the software. Ensure you [request access to the configurations](#request-access) first. For more information on joining specific NCI projects, refer to [How to connect to a project](https://opus.nci.org.au/display/Help/How+to+connect+to+a+project). From 37939248df3237fb6760721fe4305aa7dc737ce5 Mon Sep 17 00:00:00 2001 From: Lachlan Whyborn Date: Mon, 1 Dec 2025 16:03:28 +1100 Subject: [PATCH 69/72] Apply suggestions from code review Co-authored-by: Davide Marchegiani --- docs/models/run_a_model/run_access-am3.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 80ddb6392..a300614c6 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -59,26 +59,26 @@ In addition to the [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc ## Get {{model}} configuration -Follow the instructions in the [_Rose/Cylc_ page](/models/run-a-model/rose-cylc.md) using the following specific information in the [Model configurations stored on _GitHub_](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github) section: +Follow the instructions for [Model configurations stored on _GitHub_](/models/run_a_model/rose_cylc/#model-configurations-stored-on-github) using the following specific information: - [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} - [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} ## Initial Setup -Before you can run the configuration, you need to specify which projects you want to use for data storage and compute costs. For this, in the configuration you have just retrieved from GitHub, open the `rose-suite.conf_nci_gadi` file and change: +Before you can run {{ model }} configuration, you need to specify which projects you want to use for data storage and compute resources. For this, in the configuration directory open the `rose-suite.conf_nci_gadi` file and change: - `root_dir` to the path you want to use as a work directory for running the simulation. A space under `/scratch/` is ideal, where `` is the project associated with the current work. The directory will be created by the suite if it does not exist. - `STORAGE_PROJECT` must be the same project as used in the `root_dir` path. -- `COMPUTE_PROJECT` to any project you want to use for the compute cost. +- `COMPUTE_PROJECT` to any project you want to be charged for the compute resources. -Now the configuration can be run using the [Run the model configuration](/models/run-a-model/rose-cylc/#run-the-model-configuration) instructions. +Now the configuration can be run using the [Run the model configuration](/models/run_a_model/rose_cylc/#run-the-model-configuration) instructions. ## Inspecting the outputs The netCDF outputs are placed in `~/cylc-run//share/data/History_Data/netCDF`. -The outputs in UMFields format are placed in `~/cylc-run//share/data/History_Data`. +The outputs in [UM Fieldsfiles format](https://code.metoffice.gov.uk/doc/um/latest/papers/umdp_F03.pdf) are placed in `~/cylc-run//share/data/History_Data`. ## Further Information -See the [ACCESS-AM3 model configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about the configuration. +See [{{ model }} configuration documentation](https://access-nri.github.io/access-am3-configs-doc/) for more detailed information about {{ model }} configuration. From 674d368ef37cff3c39b3702907d2620e35891e7f Mon Sep 17 00:00:00 2001 From: Davide Marchegiani Date: Wed, 17 Dec 2025 10:15:47 +1100 Subject: [PATCH 70/72] Reformatted prerequisites --- docs/models/run_a_model/run_access-am3.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index a300614c6..31e691bc6 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -31,7 +31,8 @@ All {{model}} configurations are licensed under the UKMO's Momentum licence. {{m !!! warning Before continuing, make sure you have read the guide on [running models using _Rose/Cylc_](/models/run-a-model/rose-cylc.md). -In addition to the [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc/#prerequisites), you will need: +- **Rose/Cylc prerequisites** + All [prerequisites for _Rose/Cylc_](/models/run_a_model/rose_cylc/#prerequisites). - **Request access to the configurations**
To request access to the configurations repository (and associated model component repositories), please contact us [through the ACCESS-Hive Forum](https://forum.access-hive.org.au/t/request-access-to-am3-configurations/5580/13). This step will also allow us to check you are properly licensed to use the software. From f9e0974a203e09693751b09f9e039b1e8ad92fdd Mon Sep 17 00:00:00 2001 From: Davide Marchegiani Date: Wed, 17 Dec 2025 11:07:02 +1100 Subject: [PATCH 71/72] Fixed broken links --- docs/models/run_a_model/run_access-am3.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 31e691bc6..9fe55fe4c 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -62,8 +62,8 @@ All {{model}} configurations are licensed under the UKMO's Momentum licence. {{m Follow the instructions for [Model configurations stored on _GitHub_](/models/run_a_model/rose_cylc/#model-configurations-stored-on-github) using the following specific information: -- [Repository](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ github_ssh }} -- [Branch](/models/run-a-model/rose-cylc/#model-configurations-stored-on-github): {{ example_branch }} +- **Repository:** {{ github_ssh }} +- **Branch:** {{ example_branch }} ## Initial Setup From e42f5a32cc555907e2fcae852e4ed8f9ac7e04f9 Mon Sep 17 00:00:00 2001 From: Claire Carouge Date: Thu, 8 Jan 2026 10:11:10 +1100 Subject: [PATCH 72/72] Use 'release-n96e' as example branch instead of "main" --- docs/models/run_a_model/run_access-am3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/models/run_a_model/run_access-am3.md b/docs/models/run_a_model/run_access-am3.md index 9fe55fe4c..04b7a3043 100644 --- a/docs/models/run_a_model/run_access-am3.md +++ b/docs/models/run_a_model/run_access-am3.md @@ -2,7 +2,7 @@ {% set github_configs = "https://github.com/ACCESS-NRI/access-am3-configs" %} {% set github_ssh = "git@github.com:ACCESS-NRI/access-am3-configs.git" %} {% set configs_docs = "https://access-am3-configs.access-hive.org.au" %} -{% set example_branch = "main" %} +{% set example_branch = "release-n96e" %} {% set release_notes = "https://forum.access-hive.org.au/t/access-am3-release-information/5446" %} !!! release