| 1 | = IPSL ORCA1 configuration on ARCHER = |
| 2 | |
| 3 | Instructions for running the ShaCoNEMO ORCA1 setup on ARCHER. |
| 4 | |
| 5 | == Access == |
| 6 | |
| 7 | You need to register with the NEMO website to extract the code: |
| 8 | http://www.nemo-ocean.eu/user/register |
| 9 | |
| 10 | The ORCA1 configuration is held in the ShaCoNEMO repository. You need to register for access, but this uses the same username and password as main NEMO repository. |
| 11 | |
| 12 | To create a branch to hold your code changes on the NEMO repository, you will need additional permissions. |
| 13 | |
| 14 | == References == |
| 15 | |
| 16 | The main NEMO website gives more general instructions on building & running NEMO with the standard confgurations included in the code: |
| 17 | http://www.nemo-ocean.eu/Using-NEMO/User-Guides/Basics/NEMO-Quick-Start-Guide |
| 18 | |
| 19 | ORCA1_LIM3_PISCES configuration is documented on the ShaCoNEMO (Shared Configuration) wiki: |
| 20 | https://forge.ipsl.jussieu.fr/shaconemo/wiki/README_ORCA1_LIM3_PISCES |
| 21 | |
| 22 | * LIM3 is the sea-ice |
| 23 | * PISCES is the biogeochemical model |
| 24 | |
| 25 | NEMO uses an external library to handle model output diagnostics (XIOS), documented here: |
| 26 | http://forge.ipsl.jussieu.fr/ioserver/wiki |
| 27 | |
| 28 | == Code versions == |
| 29 | |
| 30 | Here we have used the following versions, based on the NEMO/ShaCoNEMO pages: |
| 31 | |
| 32 | * XIOS-1.0 r703 |
| 33 | * NEMO_3.6_stable r6969 |
| 34 | * ShaCoNEMO r60 |
| 35 | * ORCA1 input data set v9 |
| 36 | |
| 37 | Note: Although XIOS-2.0 is now recommended, revision 932 which is suggested for ORCA1 gave a link-time error which was not investigated. |
| 38 | |
| 39 | == Code extract == |
| 40 | |
| 41 | On ARCHER, navigate to the directory that you wish to hold the code. You may wish to use the home directory as this is backed up. |
| 42 | |
| 43 | To checkout to a directory called `NEMOGCM_3.6_r6969`, run the following, replacing `mylogin` with your NEMO username (you will be prompted for your password): |
| 44 | {{{ |
| 45 | svn --username "mylogin" co -r6969 http://forge.ipsl.jussieu.fr/nemo/svn/branches/2015/nemo_v3_6_STABLE/NEMOGCM NEMOGCM_3.6_r6969 |
| 46 | }}} |
| 47 | |
| 48 | This creates an subversion "working copy". Running `svn info` lists the revision that was checked out, and `svn diff` lists the changes that have been made. |
| 49 | |
| 50 | Then setup and extract the ORCA1 configuration: |
| 51 | {{{ |
| 52 | cd NEMOGCM_3.6_r6969/CONFIG |
| 53 | }}} |
| 54 | |
| 55 | Then edit `cfg.txt` to add the line: |
| 56 | {{{ |
| 57 | ORCA1_LIM3_PISCES OPA_SRC LIM_SRC_3 NST_SRC TOP_SRC |
| 58 | }}} |
| 59 | |
| 60 | Then checkout the ORCA1 configuration: |
| 61 | {{{ |
| 62 | svn --username "mylogin" co http://forge.ipsl.jussieu.fr/shaconemo/svn/trunk/ORCA1_LIM3_PISCES |
| 63 | }}} |
| 64 | |
| 65 | Use same username and password as main NEMO website. |
| 66 | |
| 67 | |
| 68 | |