[2494] | 1 | usage of SETTE package: |
---|
| 2 | |
---|
[2665] | 3 | principal script is sette.sh (usage: ./sette.sh) |
---|
[2494] | 4 | |
---|
[2539] | 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 | |
---|
[2494] | 9 | USER MODIFICATIONS |
---|
| 10 | in sette.sh script : |
---|
[2732] | 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 |
---|
[2539] | 13 | makenemo -m : machine (compilator); see ./makenemo -m help (in NEMOGCM/CONFIG directory) |
---|
[2494] | 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) |
---|
[2675] | 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 ) |
---|
[2757] | 23 | copy_original : to namelist of reference configuration in configuration directory in which tests are done |
---|
[2665] | 24 | fcm_job.sh needs input: input_CONFIG_NAME TOTAL_NUMBER_OF_PROCS_used TEST_NAME |
---|
[2716] | 25 | (for example if you compile ORCA2_LIM with key_mpp_mpi |
---|
[2665] | 26 | and only run short test ===> ./fcm_job input_ORCA2_LIM.cfg 4 SHORT) |
---|
[2494] | 27 | in param.cfg : |
---|
[2675] | 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) |
---|
[2665] | 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 |
---|
[2675] | 33 | NEMO_VALIDATION_DIR : directory in which create NEMO_VALIDATION tree, and store restart, solver.stat and ocean.output files in |
---|
[2665] | 34 | tree NEMO_VALIDATION_DIR/WCONFIG_NAME/WCOMPILER_NAME/TEST_NAME/REVISION_NUMBER(or DATE) |
---|
[2494] | 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) |
---|
[2675] | 39 | TEST_NAME by convention is LONG: 10 days run or SHORT: 5 days run |
---|
[2665] | 40 | so NEMO_VALIDATION tree is coherent, |
---|
| 41 | but user can choise a TEST_NAME that represent his own test. |
---|
[2494] | 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 | |
---|
[2539] | 52 | NOTE 2: |
---|
| 53 | if you want a completly verbose makenemo you can uncomment "set -x" in makenemo script |
---|
[2545] | 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) |
---|