= VALID-12_CLEVY_CoupledInterface

The PI is responsible to closely follow the progress of the action, and especially to contact NEMO project manager if the delay on preview (or review) are longer than the 2 weeks expected.

[[PageOutline(2, , inline)]]

== Summary


||=Action'''    || VALID-12_CLEVY_CoupledInterface   ||
||=PI(S)'''     || C. Levy                    ||
{{{#!th style='text-align: left'
Digest
}}}
{{{#!td
Validation of NEMO coupled interface, using OASIS in the trunk (as future 4.0 release) 
}}}
|-
||=Dependencies ||                                                                       ||
||=Expected for ||                                                                       ||
||=Ticket       || #2147                                                                 ||
||=Branch       || [source:/NEMO/branches/$YEAR/dev_r{REV}_{ACTION_NAME}]                ||
||=Previewer(s) ||    S. Masson, R. Hill, E. Maisonnave                                                                   ||
||=Reviewer(s)  ||    S. Masson, R. Hill, E. Maisonnave                                                                   ||
||=Link         || [[ExtractUrl(.)]]                                                     ||

== Abstract
The NEMO OASIS interface is important for all coupled configurations. Testing that this section (mainly the coupling activated) is functional must be done before the 4.0 announcement. 

== Implementation

To check if the coupling interfaces are functional, three steps/tests will be set up:

'''STEP1:'''
Validation of the SAS reference configuration[[BR]]

'''STEP2:'''
Set up a test using NEMO (starting from the global reference configuration) with key_coupled, OASIS active and a toy atmospheric model[[BR]]

'''STEP3:'''
Using this configuration, check that the coupled interface is functional for ocean dynamics, sea ice and biogeochemistry [[BR]]




== Reference manual and web pages updates

''Not done yet''
== Preview 

{{{#!box help
[[Include(wiki:Developers/DevProcess#preview_)]]
}}}

For this taks, no development is scheduled: the goal is only to check that the coupling interface of NEMO 4.0 is working.[[BR]]
The advice of previewer on the list of proposed tests is of course welcome.
== Tests

{{{#!box help
[[Include(wiki:Developers/DevProcess#tests)]]
}}}

=== TEST1: Validation of the SAS reference configuration
The reference configuration ORCA2_SAS_LIM has run sucessfully for 1 year using the set up defined in the NEMO shared reference.[[BR]]
Validation of the results:
* After one year experiment, the ice restart file is created and ''looks like a correct ice restart file''
* Having a complete an exact validation of this configuration will need some more work: here the ice is forced with an ocean input file containing the surface fields. These fields are not varying with time for now in the input file. To have a complete validation, it would need:
  * to run a one year of ORCA2_ICE_PISCES full reference configuration, with outputs of these daily surface fields
  * to use this output as input to the SAS configuration
  * to make some subtle changes in SAS in order to have the exact same use of these fields in time (not the case for now, work done once by Sébastien and Eric, remaining to be taken in account again
  * Once all this is done, the ice restart file should be strictly identical between the ORCA2_ICE_PISCES run and the ORCA2_SAS_LIM one
This work has not been done at this stage, so that for now the conclusion is: the ORCA2_SAS_LIM configuration is running in NEMO 4.0, e.g. the SAS interface is functionnal in this case.

=== TEST2: Set up a test using NEMO (starting from the global reference configuration) with key_coupled, OASIS active and a toy atmospheric model[[BR]]
Using this configuration, check that the coupled interface is functional for ocean dynamics, sea ice and biogeochemistry [[BR]]

=== Summary
As a result of the tests, a few things needs to be updated/fixed:
* sbccpl.F90
* namelist_ref

A new test case has been build with a toy for the atmosphere and is now a test case (proposed name: YAZD, for Yardstick Atmosphere to Zero a Demonstrator, since yazd is an oasis in Iran...). It is proposed to add this configuration in the list of available test cases.
== Review

{{{#!box help
[[Include(wiki:Developers/DevProcess#review)]]
}}}