Direkt zum Inhalt | Direkt zur Navigation

Personal tools

You are here: Home » Users » Getting started with OASIS » Getting started with OASIS3

Getting started with OASIS3

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

  1. Obtain OASIS3 sources by filling the  registration form; this will give you all instructions on how to download OASIS3 sources and examples.
  2. To start playing around with OASIS3, compile and run the tutorial toy model, which sources can be found in oasis3/examples/tutorial. Instructions on how to compile OASIS3 and run the tutorial can be found in the document tutorial.pdf . Do not hesitate to have a deeper look at tutorialmodel1.F90 and model2.F90 sources to understand how to interface a component model with OASIS3.
  3. The next step is to adapt the tutorial toy model so that it reproduces your coupling algorithm, i.e. the sequence of coupling exchanges that will take place in your real coupled model, using the grids of your real component models. To do so, go over steps 4 to 8.
  4. Identify the numerical grids of your component models, i.e. the grids onto which the coupling fields will be sent and received by the source and target component models. Create the related grid auxiliary data file as described in section 7.2 of the User Guide. See files grids.nc, masks.nc, and areas.ncin oasis3/examples/tutorial/data_oasis3 as an example.
  5. Identify the coupling fields to be exchanged between your component models and their sequence of the exchanges. Adapt sources of model1.F90and model2.F90 so that they reproduce the coupling exchanges of your coupled model. For more details on how to interface a model with OASIS3 coupling library interface, see chapter 4 of the User Guide.
  6. If coupling restart are needed for your coupled algorithm, build these files following indications provided in section 7.3 of the User Guide. More information on the restart concept can also be found in section 4.8 of theUser Guide. The TOYOASIS3 toy coupled model, which sources can be found in oasis3/examples/toyoasis3, gives a practical example of a coupled model using coupling restart files (see chapter 8 of the User Guide for instructions on how to compile and run TOYOASIS3).
  7. Define all coupling parameters and the transformations required to adapt each coupling field from its source model grid to its target model grid; see chapter 6 of the User Guide for details about the transformations available in OASIS3. On this basis, prepare OASIS3 configuring file namcouple, as detailed in chapter 5 of the User Guide.
  8. Compile OASIS3, the component models and run your toy coupled experiment.
  9. Before interfacing your real component models with OASIS3, we strongly recommend that you test off-line the quality of the chosen transformations in the testNONE environment, which source can be found inoasis3/examples/testNONE (see also details in section 8.4.2 of the User Guide).
  10. Now that you fully understand how to interface your component models with OASIS3 and that you have checked the quality of OASIS3 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.
© Copyright ENES Portal 2011