The OASIS Coupler Un site utilisant Réseau Cerfacs

Getting started with OASIS3-MCT

To use OASIS3-MCT to set up your coupled application, you have to follow these steps:

  1. Obtain OASIS3-MCT sources by filling the registration form; this will give you all instructions on how to download OASIS3-MCT sources and examples.To compile OASIS3-MCT, please see the User Guide, section 6.1.
  2. To start playing with OASIS3-MCT, compile and run the tutorial toy model, which sources can be found in oasis3-mct/examples/tutorial. Instructions on how to compile OASIS3-MCT and run the tutorial can be found in the README and in the document tutorial.pdf. Do not hesitate to have a deeper look at tutorial model1.F90 and model2.F90 sources to understand how to interface a component model with OASIS3-MCT
  3. The next step is to adapt the tutorial toy model so that it reproduces your coupling algorithm, i.e. the sequenceof coupling exchanges that will take place in your real coupled model, using the grids of your real component models. To do so, go over the next steps 4 to 8.
  4. Identify the numerical grids of your coupled models, i.e. the grids onto which the coupling fields will be sent and received by the source and the target component models. Create a file for each grid (see and with the longitudes, latitudes, corners and areas (if conservative interpolation is needed) and the mask of the grid. The corresponding files, will be created by the models during the run, see the User Guide for more details on these files.
  5. Identify the coupling fields to be exchanged between your component models and their sequence of the exchanges. Adapt the sources of model1.F90 and model2.F90 so that they reproduce the coupling exchanges of your coupled model. For more details on how to interface a model with OASIS3-MCT coupling library interface see the User Guide.
  6. If coupling restart files are needed for your coupled algorithm, build these files following indications provided in the User Guide. More information on the restart concept can be found in the User Guide.
  7. Define all coupling parameters and the transformation required to adapt each coupling field from its source model grid to its target model grid ; see the User Guide for details about the transformations available. On this basis, prepare the OASIS3-MCT configuration file namcouple as detailed in the User Guide.
  8. Compile OASIS3-MCT, the component models and run your toy coupled experiment.
  9. Before interfacing your real component models with OASIS3-MCT, it is recommended to test off-line the quality of the chosen transformations with your grids (using, and, in the test_interpolation environment which sources can be found in oasis3-mct/examples/test_interpolation.
  10. Now that you fully understand how to interface your component models with OASIS3-MCT and that you have checked the quality of the OASIS3-MCT transformations when applied to your grids, you are ready to proceed to the implementation of your coupled system repeating steps 4. to 8. with your real component models.


SPOC on line on OASIS3-MCT from March 21s to April 6th 2022

Please note that a Small Private Online Course (SPOC) on Code Coupling with OASIS3-MCT is planned (on-line) from March 21s to ...

OASIS3-MCT_5.0 official release December 2021

The last version of the coupler, OASIS3-MCT_5.0, is now available ! To get it, please follow instructions at OASIS3- MCT_5.0 comes...

SPOC on line on OASIS3-MCT, April 29 – May 12 2021

A new Small Private Online Course (SPOC) on OASIS3-MCT is planned from April 29 - May 12 2021. Information about next...

All the actualities