1 | usage of SETTE package: |
---|
2 | |
---|
3 | principal script is sette.sh (usage: ./sette.sh) |
---|
4 | |
---|
5 | VERY IMPORTANT : for a verbose debug do: |
---|
6 | ./sette.sh 2>&1 | tee out.sette |
---|
7 | this create out.sette file in ${SETTE_DIR} |
---|
8 | |
---|
9 | USER MODIFICATIONS |
---|
10 | in sette.sh script : |
---|
11 | COMPILER : compiler among those available in NEMOGCM/ARCH, needed for makenemo (see below) |
---|
12 | can also be pass as an argument, e.g. ./sette.sh ifort_osx |
---|
13 | makenemo -m : machine (compilator); see ./makenemo -m help (in NEMOGCM/CONFIG directory) |
---|
14 | -n : config name (in examples config_name_nproci_nprocj), see ./makenemo -n help |
---|
15 | -r : reference configuration (if you don't give it you have to choise directories to install) |
---|
16 | add_key : to add list of keys (for example to test reproductibility: add_key mpp_rep) |
---|
17 | del_key : to del list of keys |
---|
18 | and for more details and options of makenemo see ./makenemo -h |
---|
19 | set_namelist : to set namelist values |
---|
20 | (example : to set 75 time steps for one test : namelist nn_itend 75) |
---|
21 | ( : to change cn_icerst_in name : namelist_ice cn_icerst_in \"test_00101231_restart_icemod\") |
---|
22 | ( : to activate control print : namelist ln_ctl false ) |
---|
23 | copy_original : to namelist of reference configuration in configuration directory in which tests are done |
---|
24 | fcm_job.sh needs input: input_CONFIG_NAME TOTAL_NUMBER_OF_PROCS_used TEST_NAME |
---|
25 | (for example if you compile ORCA2_LIM with key_mpp_mpi |
---|
26 | and only run short test ===> ./fcm_job input_ORCA2_LIM.cfg 4 SHORT) |
---|
27 | in param.cfg : |
---|
28 | EXE_DIR : directory in which job s executed (by default CONFIG_DIR) |
---|
29 | FORCING_DIR : directory in which will be found input.tar file (same name in input_CONFIG_NAME.cfg) |
---|
30 | INPUT_DIR : directory in which store input files |
---|
31 | TMPDIR : temporary directory NEEDED ONLY FOR IBM machines (put EXP00 directory) |
---|
32 | OUTPUT_DIR : directory in which store output files |
---|
33 | NEMO_VALIDATION_DIR : directory in which create NEMO_VALIDATION tree, and store restart, solver.stat and ocean.output files in |
---|
34 | tree NEMO_VALIDATION_DIR/WCONFIG_NAME/WCOMPILER_NAME/TEST_NAME/REVISION_NUMBER(or DATE) |
---|
35 | in fcm_job.sh : |
---|
36 | IMPORTANT : control that name of tar file in FORCING directory |
---|
37 | is the same of that in input_REF_CONFIG.cfg, if not change one. |
---|
38 | change in "RUN OPA" part the command line (some examples are already written) |
---|
39 | TEST_NAME by convention is LONG: 10 days run or SHORT: 5 days run |
---|
40 | so NEMO_VALIDATION tree is coherent, |
---|
41 | but user can choise a TEST_NAME that represent his own test. |
---|
42 | |
---|
43 | NOTE: |
---|
44 | in case of error you can remove you NEW_CONF directory and all files doing : |
---|
45 | ./makenemo -n MY_CONFIG clean_config |
---|
46 | |
---|
47 | if you want recompile nemo but before you want to clean compiled code do : |
---|
48 | ./makenemo clean |
---|
49 | |
---|
50 | and if you have already compiled you can re-run all sette.sh and compilation part will be by-passed. |
---|
51 | |
---|
52 | NOTE 2: |
---|
53 | if you want a completly verbose makenemo you can uncomment "set -x" in makenemo script |
---|
54 | and then launch ./sette.sh 2>&1 | tee out.sette |
---|
55 | |
---|
56 | TO ADD NEW CONFIGURATION: |
---|
57 | 1. makenemo -n NEW_CONFIG (see makenemo -h for help) OR |
---|
58 | 2. makenemo -n NEW_CONFIG -r REF_CONFIG (if it is based on another reference configuration) |
---|
59 | 3. for fcm_job.sh creates a new input_NEW_CONFIG.cfg if you need tar file (if you use same tar file of GYRE, ORCA2_LIM or ORCA2_LIM_PISCES you can use it) |
---|
60 | |
---|
61 | TO ADD NEW MACHINE: |
---|
62 | 1. add arch-compiler.fcm in NEMOGCM/ARCH directory |
---|
63 | 2. makenemo -m new_compiler (see makenemo -h for help) |
---|