Changeset 3294 for trunk/NEMOGCM/SETTE/README

Timestamp:

2012-01-28T17:44:18+01:00 (12 years ago)

Author:

rblod

Message:

Merge of 3.4beta into the trunk

File:

• trunk/NEMOGCM/SETTE/README (modified) (3 diffs)

trunk/NEMOGCM/SETTE/README

@@ -11 +11 @@
                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 : command for job submission in batch mode
+          MPI_INTERACT : "yes" if you want to run in interactive mode for MPI run
+                     "no" if you want to run in batch mode for MPI run
+               NOTE : every job using only 1 proc is run in interactive mode
+
                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
@@ -17 +22 @@
                         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 )
-          copy_original : to namelist of reference configuration in configuration directory in which tests are done
+          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)
+
                fcm_job.sh needs input: input_CONFIG_NAME TOTAL_NUMBER_OF_PROCS_used TEST_NAME
          (for example if you compile ORCA2_LIM with key_mpp_mpi 
          and only run short test ===> ./fcm_job input_ORCA2_LIM.cfg 4 SHORT)
+
  in param.cfg :
-               EXE_DIR           : directory in which job s executed (by default CONFIG_DIR)
                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
+               INPUT_DIR         : directory in which store input files (tar file)
                TMPDIR            : temporary directory NEEDED ONLY FOR IBM machines (put EXP00 directory)
-               OUTPUT_DIR        : directory in which store output files
-          NEMO_VALIDATION_DIR : directory in which create NEMO_VALIDATION tree, and store restart, solver.stat and ocean.output files in
+          NEMO_VALIDATION_DIR : directory in which create NEMO_VALIDATION tree, and store restart, solver.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" part the command line (some examples are already written)
-          TEST_NAME by convention is LONG: 10 days run or SHORT: 5 days run
-          so NEMO_VALIDATION tree is coherent,
-          but user can choise a TEST_NAME that represent his own test.
+
+               change in "RUN OPA" if [ ${MPI_INTERACT} == "yes" ] mpirun command line (some examples are already written)
+          NOTE: if MPI_INTERACT="no" it is neede a batch_file (see below to create a new one)
 
 NOTE:
@@ -62 +70 @@
 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 MPI_INTERACT="no")