source: branches/2017/dev_merge_2017/NEMOGCM/SETTE @ 9221

Name Size Rev Age Author Last Change
../
BATCH_TEMPLATE 9019   3 years timgraham Merge of dev_CNRS_2017 into branch
all_functions.sh 15.8 KB 9220   3 years mathiot fix detection of revision number in sette (wrong for ISOMIP because config …
fcm_job.sh 2.1 KB 3635   8 years acc Branch dev_NOC_2012_r3555. #1006. Step 13: Merge in trunk changes between …
input_AMM12.cfg 26 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
input_GYRE.cfg 1 bytes 2354   10 years flavoni first draft for SETTE (SET tests for NEMO), a new version of NVTK, see …
input_ISOMIP.cfg 28 bytes 9019   3 years timgraham Merge of dev_CNRS_2017 into branch
input_ORCA2_LIM3_AGRIF.cfg 44 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
input_ORCA2_LIM3_OBS.cfg 44 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
input_ORCA2_LIM3_PISCES.cfg 47 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
input_ORCA2_OFF_PISCES.cfg 40 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
input_SAS.cfg 69 bytes 7646   4 years timgraham Merge of dev_merge_2016 into trunk. UPDATE TO ARCHFILES NEEDED for XIOS2. …
iodef_sette.xml 13.1 KB 7715   4 years flavoni #1850 commit new list of REFERENCE CONFIGURATIONS, and SETTE tests
new_sette.sh 52.7 KB 9025   3 years timgraham Resolved conflicts in SETTE (hopefully)
new_sette_rpt.sh 12.3 KB 9221   3 years mathiot add extra print in sette_rpt to detect missing config validation directory
param.cfg 234 bytes 9161   3 years davestorkey Reformulation of closea module. See ticket #2000
prepare_exe_dir.sh 1.7 KB 7715   4 years flavoni #1850 commit new list of REFERENCE CONFIGURATIONS, and SETTE tests
prepare_job.sh 13.5 KB 8468   3 years flavoni #1936: add in sette_rpt.sh difference of SAS restart_ice files
README 4.4 KB 9019   3 years timgraham Merge of dev_CNRS_2017 into branch
SETTE.pdf 71.1 KB 3608   8 years acc Branch dev_NOC_2012_r3555. #1006. Step 3: Merge in trunk changes between …
sette.sh 54.4 KB 9203   3 years clem restore compatible orca2 tests in SETTE
sette_beginner.sh 6.2 KB 9019   3 years timgraham Merge of dev_CNRS_2017 into branch
sette_rpt.SAS.sh 10.0 KB 9019   3 years timgraham Merge of dev_CNRS_2017 into branch
sette_rpt.sh 12.4 KB 9221   3 years mathiot add extra print in sette_rpt to detect missing config validation directory
sette_xios.sh 16.3 KB 9019   3 years timgraham Merge of dev_CNRS_2017 into branch

README

usage of SETTE package:

principal script is sette.sh (usage: ./sette.sh) 

VERY IMPORTANT : for a verbose debug do:
./sette.sh 2>&1 | tee out.sette
this create out.sette file in ${SETTE_DIR}

USER MODIFICATIONS
 in sette.sh script :
               COMPILER    : compiler among those available in NEMOGCM/ARCH, needed for makenemo (see below)
                             can also be pass as an argument, e.g. ./sette.sh ifort_osx
          BATCH_COMMAND_PAR : command for job submission in batch mode parallel (MMIÂ)
          BATCH_COMMAND_SEQ : command for job submission in batch mode sequential (NB_PROC = 1)
          INTERACT_FLAG : "yes" if you want to run in interactive mode 
                      "no" if you want to run in batch mode
          MPIRUN_FLAG   : "yes" if you want to run in parallel (MPI)
                "no" if you want to run in sequential mode (NB_PROC = 1)

               makenemo -m : machine (compilator); see ./makenemo -m help (in NEMOGCM/CONFIG directory)
                        -n : config name (in examples config_name_nproci_nprocj), see ./makenemo -n help
                        -r : reference configuration (if you don't give it you have to choise directories to install)
                        add_key : to add list of keys
                        del_key : to del list of keys
               and for more details and options of makenemo see ./makenemo -h

          set_namelist : to set namelist values 
         (example : to set 75 time steps for one test : namelist nn_itend 75)
         (        : to change cn_icerst_in name : namelist_ice cn_icerst_in  \"test_00101231_restart_icemod\")
         (      : to activate control print : namelist ln_ctl false )
          prepare_exe_dir.sh creates execution directory for each test
                    : NOTE for EACH JOB EXECUTION it is needed to set TEST_NAME variable
                TEST_NAME variable gives name to execution directory (created in prepare_exe_dir.sh)
                IT is mandatory to have different TEST_NAME for each job run if not existing files are re-written (for example namelist)

               prepare_job.sh generates the script to be executed 
         input: INPUT_FILE_CONFIG_NAME NUMBER_PROC TEST_NAME MPIRUN_FLAG JOB_FILE

               fcm_job.sh needs input: TOTAL_NUMBER_OF_PROCS_used JOB_FILE_NAME INTERACT_FLAG MPIRUN_FLAG 
         (for example if you run with 4 procs JOB_FILE batch parallel 
         and only run short test ===> ./fcm_job 4 SHORT no    yes   )

 in param.cfg :
               FORCING_DIR       : directory in which will be found input.tar file (same name in input_CONFIG_NAME.cfg)
               INPUT_DIR         : directory in which store input files (tar file)
               TMPDIR            : temporary directory NEEDED ONLY FOR IBM machines (put EXP00 directory)
          NEMO_VALIDATION_DIR : directory in which create NEMO_VALIDATION tree, and store restart, run.stat, tracer.stat and ocean.output files in
                            tree NEMO_VALIDATION_DIR/WCONFIG_NAME/WCOMPILER_NAME/TEST_NAME/REVISION_NUMBER(or DATE)
 in fcm_job.sh :
               IMPORTANT : control that name of tar file in FORCING directory
               is the same of that in input_REF_CONFIG.cfg, if not change one.

               change in "RUN OPA" if [ ${INTERACT_FLAG} == "yes" ] mpirun command line (some examples are already written)
          NOTE: if INTERACT_FLAG="no" it is needed a batch_file (see below to create a new one)

NOTE:
in case of error you can remove you NEW_CONF directory and all files doing :
./makenemo -n MY_CONFIG clean_config

if you want recompile nemo but before you want to clean compiled code do :
./makenemo clean

and if you have already compiled you can re-run all sette.sh and compilation part will be by-passed.

NOTE 2: 
if you want a completly verbose makenemo you can uncomment "set -x" in makenemo script
and then launch ./sette.sh 2>&1 | tee out.sette

TO ADD NEW CONFIGURATION:
1. makenemo -n NEW_CONFIG (see makenemo -h for help) OR
2. makenemo -n NEW_CONFIG -r REF_CONFIG (if it is based on another reference configuration)
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)

TO ADD NEW MACHINE:
1. add arch-compiler.fcm in NEMOGCM/ARCH directory
2. makenemo -m new_compiler  (see makenemo -h for help)

TO ADD NEW BATCH-FILE:
1. see in SETTE/BATCH_TEMPLATE directory existing examples
2. create you own batch file like: batch-${COMPILER}
(note: sette.sh will copy it in job_batch_template if you run tests in INTERACT_FLAG="no")
Note: See TracBrowser for help on using the repository browser.