Compiling and Running TOYOASIS3

The TOYOASIS3 compiling and running environment is available in oasis3/examples/toyoasis3.

Subdirectory /data contains auxiliary grid data files (see 7.2) and coupling restart files (see 7.3). Subdirectory /input contains the file cf_name_table.txt (see 7.1) the configuration file (see chapter 5) used in the classic (not parallel) mode, namcouple, and the configuration files used in the IPSL parallel mode, namcouple_0 and namcouple_1.

To run TOYOASIS3, first compile OASIS3 and the 3 TOYOASIS3 component models (see section 8.1). Go in directory oasis3/examples/toyoasis3/src and type make. This will automatically compile OASIS main executable and PSMILe library, if not done before hand, and the three component models atmoa3.x, cheoa3.x and oceoa3.x, using the header file specified in oasis3/util/make_dir
/make.inc.

The next step is to adapt the ``User's section'' of the running script run_toyoasis3 in subdirectory /script and to launch it. The script run_toyoasis3 supports Linux PC, NEC SX, IBM Power4, CRAYX1, CRAYXD1 and CRAYXT platforms (see arch variable). If your platform is not supported, the script will have to be adapted.

Different modes can be tested.

• To run in the classic (not parallel) mode, compile without the CPP key use_oasis_para or use_oasis_cmcc_para, and set ipsl_comp_para=0 and cmcc_comp_para=0 in the running script. One can now choose between running atmoa3 and cheoa3 toy models on one process only (nproc_atmche=1 and ncpl_atmche=1) or on 3 processes each (nproc_atmche=3 and ncpl_atmche=3). The results for the first and second cases are respectively available in oasis3/examples/toyoasis3/outdata/results_mono_111 and
  oasis3/examples/toyoasis3/outdata/results_mono_313 (XXX this last directory is not updated yet).

  Atmoa3 can run on 1 or 3 processes, depending on the value of the variable nproc_atmche in script run_toyoasis3. When running on 3 processes, atmoa3 can either exchange coupling data through its 3 processes ( ncpl_atmche = 3 in run_toyoasis3 and il_nbcplproc = 3 in atmoa3.F90) or only through the master process ( ncpl_atmche = 1 in run_toyoasis3 and il_nbcplproc = 1 in atmoa3.F90). When atmoa3 runs or exchanges data with only one process, it defines one Serial partition containing the 96X48 grid points. If it runs and exchanges coupling data with 3 processes, its decomposition depends on the cdec parameter hard coded in routine decomp_def.F90. When cdec = APPLE, each of the 3 atmoa3 processes calls the PSMILe prism_def_partition routine to define 1 segment of an APPLE decomposition (1536 grid points per segment). If cdec = BOX, each process will define 1 `box' of a BOX decomposition and will treat a box of 32X48 points. If the user hardcodes cdec = ORANGE, each process will define a partition of two segments of 768 points distant of 1536 points.

• Setting gridswr=1 in the script run_toyoasis3 will make the toy models to create the grid data files grids.nc, masks.nc and areas.nc and to write their grids, corners, areas and masks in these files using the prism_write_grid, prism_write_corner, prism_write_mask and prism_write_area routines (see 4.2). This does not change the results.

• To run in IPSL parallelisation mode, set ipsl_comp_para=1. In this case, make sure that the CPP key use_oasis_para was used for compilation. The script will launch OASIS3 on two processes treating each one a subset of the coupling fields; the first OASIS3 process will treat the coupling fields listed in namcouple_0 while the second will treat the coupling fields listed in namcouple_1. For more details in the IPSL parallelisation mode, see section 8.2.1. The results one should get with ipsl_comp_para=1 (in the case the atmoa3 and cheoa3 toy models run on one process only) are available in oasis3/examples/toyoasis3/outdata/results_para. (XXX This last directory is not updated yet XXX).

• To run in CMCC parallelisation mode, set cmcc_comp_para=1. In this case, make sure that the CPP key use_oasis_cmcc_para was used for compilation. For more details in the CMCC parallelisation mode, see section 8.2.2. The results one should get with cmcc_comp_para=1 are available in ... (XXX to be completed)