diff --git a/ICON-NWP/bacy.md b/ICON-NWP/bacy.md index 78173768cf727d6a3110d678d123a55354def18d..63bddb4a39e73bd137f8f402696d4dc6f3dfb322 100644 --- a/ICON-NWP/bacy.md +++ b/ICON-NWP/bacy.md @@ -21,7 +21,7 @@ git clone git@gitlab.dkrz.de:dace/dace_bacy.git <my_bacy_name> cd <my_bacy_name>/modules ./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) @@ -41,7 +41,7 @@ directory `run`. 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>_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`. For a more detailed module-setup please read `modules/module/README`. This diff --git a/ICON-NWP/how-to-bacy.md b/ICON-NWP/how-to-bacy.md index 493e7af601f3e6f3a9eabc18e8adecbf2f26dde8..cb8d5e153b35bf72c8d028c7dfa4d7d89d2e1319 100644 --- a/ICON-NWP/how-to-bacy.md +++ b/ICON-NWP/how-to-bacy.md @@ -6,7 +6,7 @@ Before running you need: * 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` 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 @@ -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`. -*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 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 ~~~ ./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). - -## Adapting bacy \ No newline at end of file +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`. + +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`. + +## 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