Skip to content
Snippets Groups Projects
Commit ac170cb4 authored by Ludwig Wolfgruber's avatar Ludwig Wolfgruber
Browse files

adding even more how to bacy instructions

parent 0be0c6f5
No related branches found
No related tags found
1 merge request!5Ludwigw95 icon docu
...@@ -21,7 +21,7 @@ git clone git@gitlab.dkrz.de:dace/dace_bacy.git <my_bacy_name> ...@@ -21,7 +21,7 @@ git clone git@gitlab.dkrz.de:dace/dace_bacy.git <my_bacy_name>
cd <my_bacy_name>/modules cd <my_bacy_name>/modules
./copy_defaults.sh ./copy_defaults.sh
~~~ ~~~
If you want to get access to the DKRZ-gitlab, someone at DWD or DKRZ needs to approve, maybe Martin Weissmann or Stefano Serafin can help you. *If you want to get access to the DKRZ-gitlab, someone at DWD or DKRZ needs to approve, maybe someone from the DA or Climate group can help you.*
## How to use BACY_1.0? (Overview) ## How to use BACY_1.0? (Overview)
...@@ -41,7 +41,7 @@ directory `run`. ...@@ -41,7 +41,7 @@ directory `run`.
The behaviour of a module can be controlled via its INPUT ARGUMENTS during the The behaviour of a module can be controlled via its INPUT ARGUMENTS during the
`<module>` script call and via its PARAMETERS defined in the configuration file `<module>` script call and via its PARAMETERS defined in the configuration file
`<module>_conf.sh`. Parametes which are needed by more than one module are `<module>_conf.sh`. Parameters which are needed by more than one module are
outsourced to the COMMON configuration file `common/bacy_conf.sh`. outsourced to the COMMON configuration file `common/bacy_conf.sh`.
For a more detailed module-setup please read `modules/module/README`. This For a more detailed module-setup please read `modules/module/README`. This
......
...@@ -6,7 +6,7 @@ Before running you need: ...@@ -6,7 +6,7 @@ Before running you need:
* a path to a directory containing a bacy with initial conditions for your experiment * a path to a directory containing a bacy with initial conditions for your experiment
* a icon gridfile, a radiation gridfile and extpar-Data. You can create these using the `icongridgen` * a icon gridfile, a radiation gridfile and extpar-Data. You can create these using the `icongridgen`
or via the [web](https://webservice.dwd.de/cgi-bin/spp1167/webservice.cgi) interface at DWD (user icon-web, pw: icon@dwd). or via the [web](https://webservice.dwd.de/cgi-bin/spp1167/webservice.cgi) interface at DWD (user icon-web, pw: icon@dwd).
* a working bacy, cloned eihter from [`git@gitlab.dkrz.de:dace/dace_bacy.git`](./bacy.md#markdown-header-how-to-get-bacy_1.0?) or from another bacy using `bacy_clone.sh` * a working bacy, cloned eihter from [`git@gitlab.dkrz.de:dace/dace_bacy.git`](./bacy.md#how-to-get-bacy_10) or from another bacy using `bacy/bacy_clone`
## Running bacy ## Running bacy
...@@ -91,7 +91,7 @@ nohup ./cycle ICON-LAM ASS 2023112812 2023112912 &> cycle.log & ...@@ -91,7 +91,7 @@ nohup ./cycle ICON-LAM ASS 2023112812 2023112912 &> cycle.log &
This will start the process in the background, writing its output to the file `cycle.log`. This will start the process in the background, writing its output to the file `cycle.log`.
*Pro Tip*: You can read the output using `less`. While in `less` press `SHIFT + F` to read it like a feed. To exit this mode press `CTRL + C` and then `q` to exit `less`. *Pro Tip:* You can read the output using `less`. While in `less` press `SHIFT + F` to read it like a feed. To exit this mode press `CTRL + C` and then `q` to exit `less`.
### Interrupting and Restarting the cycle ### Interrupting and Restarting the cycle
To interrupt a cycle you can create a file named `STOP_CYCLE` (eg. `touch STOP_CYCLE`) in the `cycle` directory. After completion of the current step, the cycle will break. To interrupt a cycle you can create a file named `STOP_CYCLE` (eg. `touch STOP_CYCLE`) in the `cycle` directory. After completion of the current step, the cycle will break.
...@@ -100,6 +100,15 @@ To restart a interrupted cycle at any of the past times, delete `STOP_CYCLE` and ...@@ -100,6 +100,15 @@ To restart a interrupted cycle at any of the past times, delete `STOP_CYCLE` and
~~~ ~~~
./cycle --cycle=5 --task=7 ICON-LAM ASS 2023112812 2023112912 ./cycle --cycle=5 --task=7 ICON-LAM ASS 2023112812 2023112912
~~~ ~~~
restarts the former cycle at 28.11.2023 - 16 UTC, at the 7th task, which is the `core` module (assimilation). restarts the former cycle at 28.11.2023 - 16 UTC, at the 7th task, which is the `core` module (assimilation). This of course also works with `nohup`.
## Adapting bacy You can also change the `enddate` when resarting a cycle. Just make sure you also change the name of a logfile `bacy/data/cycle_icon-lam_ass.log_20230928120000_20231129120000` so the last number matches your new `endtime`.
\ No newline at end of file
## Adapting bacy
Bacy is modular and quite flexible. The challenge is to know where to find the settings you want to change. A few hints:
* "global" settings can be changed in `modules/common/bacy_conf.sh` This includes parameters like the ensemble size (`BA_ENSIZE_ASS`), on-off switches for snow, surface and sst analysis (`BA_RUN_SNW`, `BA_RUN_SMA`, `BA_RUN_SST`) and several settings regarding the icon grid (serach for `GRID`)
* each module has
- namelists, which can be found in the `modules/module-name/const/` folder. Only the namelists without the `.default` ending affect the run. Inside there probably all paramters of the said module can be set.
- the file `module_name_conf.sh` containing high-level configurations of the module
- the scripts `prep_module-name`, `module-name`, `save_module-name` which make use of `prep_module-name_fcns.sh`, `module-name_fcns.sh`, `save_module-name_fcns.sh`. Inside said functions the real work of the module (file logistics, putting the namelists together and filling them with values, starting and monitoring the jobs and saving the output) is done. You can insert `ksh` prompts inside the functions to get your code executed at the desired time. Be aware that many functions differentiate between cycle and model modes, so make sure your code is actually executed where you put it.
- also see [here](./bacy.md#modules)
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment