[3744] | 1 | ----------------------------------------------------------------------- |
---|
| 2 | Coupling with the Biogeochemical Flux Model (BFM) |
---|
| 3 | ----------------------------------------------------------------------- |
---|
| 4 | Author: M. Vichi, BFM system team and NEMO system team |
---|
| 5 | INFO HELPDESK: info@bfm-community.eu |
---|
| 6 | WEB SITE: www.bfm-community.eu |
---|
[4230] | 7 | REVISION DATE: October 2013 |
---|
[3744] | 8 | |
---|
| 9 | Please address any technical query to the BFM System Team |
---|
| 10 | bfm_st@lists.cmcc.it |
---|
| 11 | ----------------------------------------------------------------------- |
---|
| 12 | |
---|
| 13 | ----------------------------------------------------------------------- |
---|
| 14 | What is the BFM? |
---|
| 15 | ----------------------------------------------------------------------- |
---|
| 16 | The Biogeochemical Flux Model (BFM) is a numerical model for the |
---|
| 17 | simulation of the dynamics of major biogeochemical properties |
---|
| 18 | in marine ecosystems. The BFM is open source software freely available |
---|
| 19 | under the GNU Public License. The model can be used in standalone mode |
---|
| 20 | to simulate a 0-D system or coupled with other OGCM. |
---|
| 21 | The coupling with NEMO is maintained by CMCC as part of the |
---|
| 22 | NEMO system team activity |
---|
| 23 | |
---|
| 24 | ----------------------------------------------------------------------- |
---|
| 25 | How to get the BFM code |
---|
| 26 | ----------------------------------------------------------------------- |
---|
| 27 | The code can be downloaded from http://www.bfm-community.eu after |
---|
| 28 | the registration of a new user. Follow the instructions on how to |
---|
| 29 | install the code. It is recommended to run the STANDALONE test cases |
---|
| 30 | before using the NEMO-BFM coupled system. |
---|
| 31 | |
---|
| 32 | ----------------------------------------------------------------------- |
---|
| 33 | Compile NEMO with the BFM |
---|
| 34 | ----------------------------------------------------------------------- |
---|
[4230] | 35 | NEMO-BFM is compiled from the BFM configuration script relying on the |
---|
| 36 | NEMO FCM compilation environment. This is done to allow BFM users to |
---|
| 37 | use new configurations in NEMO that are not part of the NEMO |
---|
| 38 | standard distribution code. |
---|
| 39 | The BFM configuration shipped with NEMO is GYRE_BFM (see next section) |
---|
| 40 | |
---|
[3744] | 41 | Make sure that the BFMDIR variable is defined in your environment |
---|
[4230] | 42 | and define the variable NEMODIR pointing to the root of NEMO source code |
---|
| 43 | It is assumed here that you have expanded the bfm in /home/user/bfm |
---|
| 44 | and the root of this NEMO directory in /home/user/nemo then |
---|
| 45 | and that you have already adjusted the appropriate ARCHFILE that |
---|
| 46 | is used for the NEMO compilation with makenemo in ../../ARCH |
---|
[3744] | 47 | |
---|
[4230] | 48 | Execute the following commands: |
---|
| 49 | >> export BFMDIR=/home/user/bfm |
---|
| 50 | >> export NEMODIR=/home/user/nemo |
---|
| 51 | >> cd $BFMDIR/build |
---|
| 52 | >> ./bfm_config.sh -gcd -p GYRE_BFM |
---|
[3744] | 53 | |
---|
[4230] | 54 | The script will generate (-g) the BFM code, then launch |
---|
| 55 | makenemo for compilation (-c) and create the run directory |
---|
| 56 | (-d) in $BFMDIR/run. |
---|
[3744] | 57 | |
---|
[4230] | 58 | to get information on how to use the BFM configuration script run |
---|
| 59 | >> ./bfm_config.sh -h |
---|
| 60 | |
---|
[3744] | 61 | ----------------------------------------------------------------------- |
---|
| 62 | Standard test case |
---|
| 63 | ----------------------------------------------------------------------- |
---|
| 64 | The distributed standard test case is GYRE_BFM, a version of GYRE |
---|
| 65 | with a full-blown BFM. It is a demnstration simulation and it is not |
---|
[4230] | 66 | meant to produce any published result. |
---|
| 67 | GYRE_BFM runs with analytical input data only. |
---|
| 68 | The namelists for the BFM are not distributed with NEMO but are |
---|
| 69 | generated directly by the BFM, in directory $BFMDIR/run/gyre_bfm. |
---|
| 70 | The generation of the BFM namelist also copy the required NEMO |
---|
| 71 | namelist and namelist_top files to this directory. |
---|
| 72 | This is why there are no namelist files found in the standard |
---|
| 73 | run directory $NEMODIR/NEMOGCM/CONFIG/GYRE_BFM/EXP00 |
---|
[3744] | 74 | |
---|
[4230] | 75 | Note for expert users: |
---|
| 76 | If a user prefers to work in the NEMO directory than she has to |
---|
| 77 | copy the generated namelists there |
---|
| 78 | >> cp $BFMDIR/run/gyre_bfm/* $NEMODIR/NEMOGCM/CONFIG/GYRE_BFM/EXP00 |
---|
| 79 | Once the BFM code has been generated the first time, the code can be |
---|
| 80 | also rebuilt with the standard NEMO command: |
---|
| 81 | >> ./makenemo -n GYRE_BFM -m ARCHFILE -e $BFMDIR/src/nemo |
---|
| 82 | |
---|
[3744] | 83 | ----------------------------------------------------------------------- |
---|
| 84 | Other examples |
---|
| 85 | ----------------------------------------------------------------------- |
---|
[4230] | 86 | Other couplings with NEMO are available in $BFMDIR/build/configurations. |
---|
| 87 | Run the command |
---|
| 88 | >> ./bfm_config.sh -P |
---|
| 89 | to get a list of available presets |
---|
[3744] | 90 | Please refer to the README file in each directory for more information. |
---|