Skip to content

Commit b8d41c2

Browse files
committed
Test line continuation
1 parent 3daa37a commit b8d41c2

2 files changed

Lines changed: 17 additions & 5 deletions

File tree

docs/includes/payu.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ An _experiment_ is a realisation of a configuration: a series of sequential runs
4747

4848
### Data organisation and _payu_'s directories designation
4949

50-
# --8<-- [start:organisation]
50+
# --8<-- [start:organisation_generic]
5151
!!! info
5252
_payu_ creates all the directories it needs. Therefore, they do not need to be created beforehand.
5353

@@ -62,12 +62,18 @@ A representation of the data organisation for _payu_ is given in the following d
6262

6363
![payu directory structure](/assets/payu_directory_structure.png){: class="example-img" loading="lazy"}
6464

65-
6665
As shown in the diagram, the general layout of a _payu_-supported model run consists of two main directories:
66+
# --8<-- [end:organisation_generic]
67+
# --8<-- [start:organisation_control]
6768

6869
- The _control_ directory contains the model configuration and is the directory from which the model run is started. The `control` directory is a git repository where experiments are stored as branches, allowing the same _control_ directory to be used for multiple experiments. For more information, refer to [this payu tutorial](https://forum.access-hive.org.au/t/access-om2-payu-tutorial/1750#select-experiment-12). {: #control-directory }
69-
- The _laboratory_ directory contains all data from _payu_ experiments of the same model. By default, it is `/scratch/$PROJECT/$USER/<model_name>`. `$PROJECT` and `$USER` are environment variables on _Gadi_ that points to your [default project](/getting_started/set_up_nci_account/#change-default-project-on-gadi) and your username respectively. See the section on [modifying the PBS resources](#modify-pbs-resources) to learn how to change the _laboratory_ location.
70+
# --8<-- [end:organisation_control]
71+
# --8<-- [start:organisation_lab]
72+
- The _laboratory_ directory contains all data from _payu_ experiments of the same model. By default, it is `/scratch/$PROJECT/$USER/<model_name>`. `$PROJECT` and `$USER` are environment variables on _Gadi_ that points to your [default project](/getting_started/set_up_nci_account/#change-default-project-on-gadi) and your username respectively.
73+
# --8<-- [end:organisation_lab]
74+
See the section on [modifying the PBS resources](#modify-pbs-resources) to learn how to change the _laboratory_ location.
7075

76+
# --8<-- [start:organisation_suite]
7177
On _Gadi_, it is good practice to put experiment _control_ directories in your `$HOME` directory as this is the only filesystem that is actively backed-up. There is a 10GB limit for home directories, but the _control_ directory only contains text files and symlinks, and so uses relatively little space (<1MB). The _laboratory_ directory is on `/scratch` which is optimised for fast I/O for large data and where there is adequate space available for large model output.
7278

7379
Inside the _laboratory_ directory, there are two subdirectories of particular interest:
@@ -81,7 +87,7 @@ The _archive_ and _work_ directories for an experiment are most easily accessed
8187

8288
!!! warning
8389
Files on the `/scratch` drive, such as the _laboratory_ directory, might be deleted if not accessed for 90 days. All experiments which are to be kept should be moved to `/g/data/` by enabling the automated `sync` step in _payu_. For further information, refer to [Syncing output data](#syncing-output-data-to-long-term-storage).
84-
# --8<-- [end:organisation]
90+
# --8<-- [end:organisation_suite]
8591

8692
## Prerequisites
8793

docs/models/run_a_model/run_access-esm.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,13 @@ All {{model}} configurations are open source, licensed under [CC BY 4.0](https:/
7373

7474
??? abstract
7575

76-
--8<-- "payu.md:organisation"
76+
--8<-- "payu.md:organisation_generic"
77+
--8<-- "payu.md:organisation_control"
78+
--8<-- "payu.md:organisation_lab"
79+
See the section on [modifying the PBS resources](#modify-pbs-resources) to learn how to change the _laboratory_ location.
80+
81+
--8<-- "payu.md:organisation_suite"
82+
7783

7884
----------------------------------------------------------------------------------------
7985

0 commit comments

Comments
 (0)