= Name and subject of the action

Last edition: '''[[Wikinfo(changed_ts)]]''' by '''[[Wikinfo(changed_by)]]'''

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       || OASIS_TESTCASE : create a test case for coupling with OASIS                       ||
||=PI(S)        || Claire Lévy                                                 ||
||=Digest       || Motivations and main tasks: create a simple testcase using OASIS to help building new coupled configurations     ||
||=Dependencies || OASIS                                                ||
||=Branch       || source:/NEMO/branches/{YEAR}/dev_r{REV}_{ACTION_NAME} ||
||=Previewer(s) || E. Maisonnave (to be confirmed)                                                 ||
||=Reviewer(s)  || E. Maisonnave (to be confirmed)                                                 ||
||=Ticket       || #2379                                                 ||

=== Description


Create a simple testcase using OASIS to help building new coupled configurations.[[br]]
Will use OASIS and a simplified fake atmosphere (TOY_ATM in OASIS wording.[[br]]
May do more than only ocean-atmosphere coupling (to be discussed).[[br]]
Useful as coupling demonstrator and for first level valisation of coupling with OASIS in future NEMO versions.



=== Implementation

{{{#!box width=35em help
Describe flow chart of the changes in the code. \\
List the Fortran modules and subroutines to be created/edited/deleted. \\
Detailed list of new variables to be defined (including namelists), \\
give for each the chosen name and description wrt coding rules.
}}}

As for the test case defined in STEP1 (see below):
* no changes in NEMO code
* Changes in &namsbc_cpl namelist
* Need to add the TOY_ATM software, as a simplified /fake atmosphere somewhere to be able tu run this test case


=== Documentation updates

{{{#!box width=55em help
Using previous parts, define the main changes to be done in the NEMO literature 
(manuals, guide, web pages, …).
}}}

''...''

== Preview 

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#preview_)]]
}}}

Methodology
==== STEP 1: Implement in the up-to-date version for 2020 the test case developed in 2018
Restarting from /ccc/work/cont003/gen7451/clevy/VALID_CPL_4.0/trunk/cfgs/CPL_TOYATM in irene computer, implment the CPL_TOYATM in the up-to-date NEMO version, as a test case (in trunk/tests).

CPL_TOYATM test case description:
* Based on the ORCA2_ICE_PISCES reference configuration, activate coupling to a TOYATM (kindly offered by Eric M.) through OASIS
* coupled fields (from &namsbc_cpl namelist): 

{{{
&namsbc_cpl    !   coupled ocean/atmosphere model                       ("key_oasis3")
!-----------------------------------------------------------------------
   nn_cplmodel   =     1   !  Maximum number of models to/from which NEMO is potentially sending/receiving data
   ln_usecplmask = .false. !  use a coupling mask file to merge data received from several models
   !                       !   -> file cplmask.nc with the float variable called cplmask (jpi,jpj,nn_cplmodel)
   nn_cats_cpl   =     5   !  Number of sea ice categories over which coupling is to be carried out (if not 1)

   !_____________!__________________________!____________!_____________!______________________!________!
   !             !        description       !  multiple  !    vector   !       vector         ! vector !
   !             !                          ! categories !  reference  !     orientation      ! grids  !
!***   send    ***
   sn_snd_temp   =   'weighted oce and ice' ,    'no'    ,     ''      ,         ''           ,   ''
 
!***  receive  ***

   sn_rcv_qsr    =   'conservative'         ,    'no'    ,     ''      ,         ''           ,   ''
   sn_rcv_qns    =   'oce and ice'          ,    'no'    ,     ''      ,         ''           ,   ''
   sn_rcv_emp    =   'conservative'         ,    'no'    ,     ''      ,         ''           ,   ''
!-----------------------------------------------------------------------
}}}

* The test cases needs OASIS and a simple TOYATM
* Where should the TOYATM be installed? In the test case, in NEMO tools? elsewhere?
* Validation of the test case remains to be defined more precisely (check OASIS output ATSSTSST_toyatm_01.nc compared to ocean SST ?)

==== STEP 2: is this the final version of the expected test case?
* Adding other couplings?
* Checking sea-ice?

==== STEP 3: implement final test case
Implement the finalised test case as part of the usual validation testbed, and also in the github for NEMO test cases

== Tests

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#tests)]]
}}}

''...''

== Review

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#review)]]
}}}

''...''