New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
sbccpl.F90 in NEMO/branches/2019/dev_r11943_MERGE_2019/src/OCE/SBC – NEMO

source: NEMO/branches/2019/dev_r11943_MERGE_2019/src/OCE/SBC/sbccpl.F90 @ 12252

Last change on this file since 12252 was 12252, checked in by smasson, 4 years ago

rev12240_dev_r11943_MERGE_2019: same as [12251], merge trunk 12072:12248, all sette tests ok, GYRE_PISCES, AMM12, ISOMIP, VORTEX intentical to 12236

  • Property svn:keywords set to Id
File size: 155.0 KB
Line 
1MODULE sbccpl
2   !!======================================================================
3   !!                       ***  MODULE  sbccpl  ***
4   !! Surface Boundary Condition :  momentum, heat and freshwater fluxes in coupled mode
5   !!======================================================================
6   !! History :  2.0  ! 2007-06  (R. Redler, N. Keenlyside, W. Park) Original code split into flxmod & taumod
7   !!            3.0  ! 2008-02  (G. Madec, C Talandier)  surface module
8   !!            3.1  ! 2009_02  (G. Madec, S. Masson, E. Maisonave, A. Caubel) generic coupled interface
9   !!            3.4  ! 2011_11  (C. Harris) more flexibility + multi-category fields
10   !!----------------------------------------------------------------------
11
12   !!----------------------------------------------------------------------
13   !!   namsbc_cpl      : coupled formulation namlist
14   !!   sbc_cpl_init    : initialisation of the coupled exchanges
15   !!   sbc_cpl_rcv     : receive fields from the atmosphere over the ocean (ocean only)
16   !!                     receive stress from the atmosphere over the ocean (ocean-ice case)
17   !!   sbc_cpl_ice_tau : receive stress from the atmosphere over ice
18   !!   sbc_cpl_ice_flx : receive fluxes from the atmosphere over ice
19   !!   sbc_cpl_snd     : send     fields to the atmosphere
20   !!----------------------------------------------------------------------
21   USE dom_oce         ! ocean space and time domain
22   USE sbc_oce         ! Surface boundary condition: ocean fields
23   USE trc_oce         ! share SMS/Ocean variables
24   USE sbc_ice         ! Surface boundary condition: ice fields
25   USE sbcapr          ! Stochastic param. : ???
26   USE sbcdcy          ! surface boundary condition: diurnal cycle
27   USE sbcwave         ! surface boundary condition: waves
28   USE phycst          ! physical constants
29   USE isf_oce , ONLY : l_isfoasis, fwfisf_oasis ! ice shelf boundary condition
30#if defined key_si3
31   USE ice            ! ice variables
32#endif
33   USE cpl_oasis3     ! OASIS3 coupling
34   USE geo2ocean      !
35   USE oce     , ONLY : ts, uu, vv, ssh, fraqsr_1lev
36   USE ocealb         !
37   USE eosbn2         !
38   USE sbcrnf  , ONLY : l_rnfcpl
39#if defined key_cice
40   USE ice_domain_size, only: ncat
41#endif
42#if defined key_si3
43   USE icethd_dh      ! for CALL ice_thd_snwblow
44#endif
45   !
46   USE in_out_manager ! I/O manager
47   USE iom            ! NetCDF library
48   USE lib_mpp        ! distribued memory computing library
49   USE lbclnk         ! ocean lateral boundary conditions (or mpp link)
50
51   IMPLICIT NONE
52   PRIVATE
53
54   PUBLIC   sbc_cpl_init      ! routine called by sbcmod.F90
55   PUBLIC   sbc_cpl_rcv       ! routine called by icestp.F90
56   PUBLIC   sbc_cpl_snd       ! routine called by step.F90
57   PUBLIC   sbc_cpl_ice_tau   ! routine called by icestp.F90
58   PUBLIC   sbc_cpl_ice_flx   ! routine called by icestp.F90
59   PUBLIC   sbc_cpl_alloc     ! routine called in sbcice_cice.F90
60
61   INTEGER, PARAMETER ::   jpr_otx1   =  1   ! 3 atmosphere-ocean stress components on grid 1
62   INTEGER, PARAMETER ::   jpr_oty1   =  2   !
63   INTEGER, PARAMETER ::   jpr_otz1   =  3   !
64   INTEGER, PARAMETER ::   jpr_otx2   =  4   ! 3 atmosphere-ocean stress components on grid 2
65   INTEGER, PARAMETER ::   jpr_oty2   =  5   !
66   INTEGER, PARAMETER ::   jpr_otz2   =  6   !
67   INTEGER, PARAMETER ::   jpr_itx1   =  7   ! 3 atmosphere-ice   stress components on grid 1
68   INTEGER, PARAMETER ::   jpr_ity1   =  8   !
69   INTEGER, PARAMETER ::   jpr_itz1   =  9   !
70   INTEGER, PARAMETER ::   jpr_itx2   = 10   ! 3 atmosphere-ice   stress components on grid 2
71   INTEGER, PARAMETER ::   jpr_ity2   = 11   !
72   INTEGER, PARAMETER ::   jpr_itz2   = 12   !
73   INTEGER, PARAMETER ::   jpr_qsroce = 13   ! Qsr above the ocean
74   INTEGER, PARAMETER ::   jpr_qsrice = 14   ! Qsr above the ice
75   INTEGER, PARAMETER ::   jpr_qsrmix = 15 
76   INTEGER, PARAMETER ::   jpr_qnsoce = 16   ! Qns above the ocean
77   INTEGER, PARAMETER ::   jpr_qnsice = 17   ! Qns above the ice
78   INTEGER, PARAMETER ::   jpr_qnsmix = 18
79   INTEGER, PARAMETER ::   jpr_rain   = 19   ! total liquid precipitation (rain)
80   INTEGER, PARAMETER ::   jpr_snow   = 20   ! solid precipitation over the ocean (snow)
81   INTEGER, PARAMETER ::   jpr_tevp   = 21   ! total evaporation
82   INTEGER, PARAMETER ::   jpr_ievp   = 22   ! solid evaporation (sublimation)
83   INTEGER, PARAMETER ::   jpr_sbpr   = 23   ! sublimation - liquid precipitation - solid precipitation
84   INTEGER, PARAMETER ::   jpr_semp   = 24   ! solid freshwater budget (sublimation - snow)
85   INTEGER, PARAMETER ::   jpr_oemp   = 25   ! ocean freshwater budget (evap - precip)
86   INTEGER, PARAMETER ::   jpr_w10m   = 26   ! 10m wind
87   INTEGER, PARAMETER ::   jpr_dqnsdt = 27   ! d(Q non solar)/d(temperature)
88   INTEGER, PARAMETER ::   jpr_rnf    = 28   ! runoffs
89   INTEGER, PARAMETER ::   jpr_cal    = 29   ! calving
90   INTEGER, PARAMETER ::   jpr_taum   = 30   ! wind stress module
91   INTEGER, PARAMETER ::   jpr_co2    = 31
92   INTEGER, PARAMETER ::   jpr_topm   = 32   ! topmeltn
93   INTEGER, PARAMETER ::   jpr_botm   = 33   ! botmeltn
94   INTEGER, PARAMETER ::   jpr_sflx   = 34   ! salt flux
95   INTEGER, PARAMETER ::   jpr_toce   = 35   ! ocean temperature
96   INTEGER, PARAMETER ::   jpr_soce   = 36   ! ocean salinity
97   INTEGER, PARAMETER ::   jpr_ocx1   = 37   ! ocean current on grid 1
98   INTEGER, PARAMETER ::   jpr_ocy1   = 38   !
99   INTEGER, PARAMETER ::   jpr_ssh    = 39   ! sea surface height
100   INTEGER, PARAMETER ::   jpr_fice   = 40   ! ice fraction         
101   INTEGER, PARAMETER ::   jpr_e3t1st = 41   ! first T level thickness
102   INTEGER, PARAMETER ::   jpr_fraqsr = 42   ! fraction of solar net radiation absorbed in the first ocean level
103   INTEGER, PARAMETER ::   jpr_mslp   = 43   ! mean sea level pressure
104   INTEGER, PARAMETER ::   jpr_hsig   = 44   ! Hsig
105   INTEGER, PARAMETER ::   jpr_phioc  = 45   ! Wave=>ocean energy flux
106   INTEGER, PARAMETER ::   jpr_sdrftx = 46   ! Stokes drift on grid 1
107   INTEGER, PARAMETER ::   jpr_sdrfty = 47   ! Stokes drift on grid 2
108   INTEGER, PARAMETER ::   jpr_wper   = 48   ! Mean wave period
109   INTEGER, PARAMETER ::   jpr_wnum   = 49   ! Mean wavenumber
110   INTEGER, PARAMETER ::   jpr_tauwoc = 50   ! Stress fraction adsorbed by waves
111   INTEGER, PARAMETER ::   jpr_wdrag  = 51   ! Neutral surface drag coefficient
112   INTEGER, PARAMETER ::   jpr_isf    = 52
113   INTEGER, PARAMETER ::   jpr_icb    = 53
114   INTEGER, PARAMETER ::   jpr_wfreq  = 54   ! Wave peak frequency
115   INTEGER, PARAMETER ::   jpr_tauwx  = 55   ! x component of the ocean stress from waves
116   INTEGER, PARAMETER ::   jpr_tauwy  = 56   ! y component of the ocean stress from waves
117   INTEGER, PARAMETER ::   jpr_ts_ice = 57   ! Sea ice surface temp
118
119   INTEGER, PARAMETER ::   jprcv      = 57   ! total number of fields received 
120
121   INTEGER, PARAMETER ::   jps_fice   =  1   ! ice fraction sent to the atmosphere
122   INTEGER, PARAMETER ::   jps_toce   =  2   ! ocean temperature
123   INTEGER, PARAMETER ::   jps_tice   =  3   ! ice   temperature
124   INTEGER, PARAMETER ::   jps_tmix   =  4   ! mixed temperature (ocean+ice)
125   INTEGER, PARAMETER ::   jps_albice =  5   ! ice   albedo
126   INTEGER, PARAMETER ::   jps_albmix =  6   ! mixed albedo
127   INTEGER, PARAMETER ::   jps_hice   =  7   ! ice  thickness
128   INTEGER, PARAMETER ::   jps_hsnw   =  8   ! snow thickness
129   INTEGER, PARAMETER ::   jps_ocx1   =  9   ! ocean current on grid 1
130   INTEGER, PARAMETER ::   jps_ocy1   = 10   !
131   INTEGER, PARAMETER ::   jps_ocz1   = 11   !
132   INTEGER, PARAMETER ::   jps_ivx1   = 12   ! ice   current on grid 1
133   INTEGER, PARAMETER ::   jps_ivy1   = 13   !
134   INTEGER, PARAMETER ::   jps_ivz1   = 14   !
135   INTEGER, PARAMETER ::   jps_co2    = 15
136   INTEGER, PARAMETER ::   jps_soce   = 16   ! ocean salinity
137   INTEGER, PARAMETER ::   jps_ssh    = 17   ! sea surface height
138   INTEGER, PARAMETER ::   jps_qsroce = 18   ! Qsr above the ocean
139   INTEGER, PARAMETER ::   jps_qnsoce = 19   ! Qns above the ocean
140   INTEGER, PARAMETER ::   jps_oemp   = 20   ! ocean freshwater budget (evap - precip)
141   INTEGER, PARAMETER ::   jps_sflx   = 21   ! salt flux
142   INTEGER, PARAMETER ::   jps_otx1   = 22   ! 2 atmosphere-ocean stress components on grid 1
143   INTEGER, PARAMETER ::   jps_oty1   = 23   !
144   INTEGER, PARAMETER ::   jps_rnf    = 24   ! runoffs
145   INTEGER, PARAMETER ::   jps_taum   = 25   ! wind stress module
146   INTEGER, PARAMETER ::   jps_fice2  = 26   ! ice fraction sent to OPA (by SAS when doing SAS-OPA coupling)
147   INTEGER, PARAMETER ::   jps_e3t1st = 27   ! first level depth (vvl)
148   INTEGER, PARAMETER ::   jps_fraqsr = 28   ! fraction of solar net radiation absorbed in the first ocean level
149   INTEGER, PARAMETER ::   jps_ficet  = 29   ! total ice fraction 
150   INTEGER, PARAMETER ::   jps_ocxw   = 30   ! currents on grid 1 
151   INTEGER, PARAMETER ::   jps_ocyw   = 31   ! currents on grid 2
152   INTEGER, PARAMETER ::   jps_wlev   = 32   ! water level
153   INTEGER, PARAMETER ::   jps_fice1  = 33   ! first-order ice concentration (for semi-implicit coupling of atmos-ice fluxes)
154   INTEGER, PARAMETER ::   jps_a_p    = 34   ! meltpond area
155   INTEGER, PARAMETER ::   jps_ht_p   = 35   ! meltpond thickness
156   INTEGER, PARAMETER ::   jps_kice   = 36   ! sea ice effective conductivity
157   INTEGER, PARAMETER ::   jps_sstfrz = 37   ! sea surface freezing temperature
158   INTEGER, PARAMETER ::   jps_ttilyr = 38   ! sea ice top layer temp
159
160   INTEGER, PARAMETER ::   jpsnd      = 38   ! total number of fields sent
161
162   !                                  !!** namelist namsbc_cpl **
163   TYPE ::   FLD_C                     !   
164      CHARACTER(len = 32) ::   cldes      ! desciption of the coupling strategy
165      CHARACTER(len = 32) ::   clcat      ! multiple ice categories strategy
166      CHARACTER(len = 32) ::   clvref     ! reference of vector ('spherical' or 'cartesian')
167      CHARACTER(len = 32) ::   clvor      ! orientation of vector fields ('eastward-northward' or 'local grid')
168      CHARACTER(len = 32) ::   clvgrd     ! grids on which is located the vector fields
169   END TYPE FLD_C
170   !                                   ! Send to the atmosphere 
171   TYPE(FLD_C) ::   sn_snd_temp  , sn_snd_alb , sn_snd_thick, sn_snd_crt   , sn_snd_co2,  &
172      &             sn_snd_thick1, sn_snd_cond, sn_snd_mpnd , sn_snd_sstfrz, sn_snd_ttilyr
173   !                                   ! Received from the atmosphere
174   TYPE(FLD_C) ::   sn_rcv_w10m, sn_rcv_taumod, sn_rcv_tau, sn_rcv_tauw, sn_rcv_dqnsdt, sn_rcv_qsr,  &
175      &             sn_rcv_qns , sn_rcv_emp   , sn_rcv_rnf, sn_rcv_ts_ice
176   TYPE(FLD_C) ::   sn_rcv_cal, sn_rcv_iceflx, sn_rcv_co2, sn_rcv_mslp, sn_rcv_icb, sn_rcv_isf
177   ! Send to waves
178   TYPE(FLD_C) ::   sn_snd_ifrac, sn_snd_crtw, sn_snd_wlev 
179   ! Received from waves
180   TYPE(FLD_C) ::   sn_rcv_hsig, sn_rcv_phioc, sn_rcv_sdrfx, sn_rcv_sdrfy, sn_rcv_wper, sn_rcv_wnum, sn_rcv_tauwoc, &
181                    sn_rcv_wdrag, sn_rcv_wfreq
182   !                                   ! Other namelist parameters
183   INTEGER     ::   nn_cplmodel           ! Maximum number of models to/from which NEMO is potentialy sending/receiving data
184   LOGICAL     ::   ln_usecplmask         !  use a coupling mask file to merge data received from several models
185                                          !   -> file cplmask.nc with the float variable called cplmask (jpi,jpj,nn_cplmodel)
186   TYPE ::   DYNARR     
187      REAL(wp), POINTER, DIMENSION(:,:,:) ::   z3   
188   END TYPE DYNARR
189
190   TYPE( DYNARR ), SAVE, DIMENSION(jprcv) ::   frcv                ! all fields recieved from the atmosphere
191
192   REAL(wp), ALLOCATABLE, SAVE, DIMENSION(:,:) ::   alb_oce_mix    ! ocean albedo sent to atmosphere (mix clear/overcast sky)
193
194   REAL(wp) ::   rpref = 101000._wp   ! reference atmospheric pressure[N/m2]
195   REAL(wp) ::   r1_grau              ! = 1.e0 / (grav * rau0)
196
197   INTEGER , ALLOCATABLE, SAVE, DIMENSION(:) ::   nrcvinfo           ! OASIS info argument
198
199   !! Substitution
200#  include "vectopt_loop_substitute.h90"
201   !!----------------------------------------------------------------------
202   !! NEMO/OCE 4.0 , NEMO Consortium (2018)
203   !! $Id$
204   !! Software governed by the CeCILL license (see ./LICENSE)
205   !!----------------------------------------------------------------------
206CONTAINS
207 
208   INTEGER FUNCTION sbc_cpl_alloc()
209      !!----------------------------------------------------------------------
210      !!             ***  FUNCTION sbc_cpl_alloc  ***
211      !!----------------------------------------------------------------------
212      INTEGER :: ierr(4)
213      !!----------------------------------------------------------------------
214      ierr(:) = 0
215      !
216      ALLOCATE( alb_oce_mix(jpi,jpj), nrcvinfo(jprcv),  STAT=ierr(1) )
217     
218#if ! defined key_si3 && ! defined key_cice
219      ALLOCATE( a_i(jpi,jpj,1) , STAT=ierr(2) )  ! used in sbcice_if.F90 (done here as there is no sbc_ice_if_init)
220#endif
221      ALLOCATE( xcplmask(jpi,jpj,0:nn_cplmodel) , STAT=ierr(3) )
222      !
223      IF( .NOT. ln_apr_dyn ) ALLOCATE( ssh_ib(jpi,jpj), ssh_ibb(jpi,jpj), apr(jpi, jpj), STAT=ierr(4) ) 
224
225      sbc_cpl_alloc = MAXVAL( ierr )
226      CALL mpp_sum ( 'sbccpl', sbc_cpl_alloc )
227      IF( sbc_cpl_alloc > 0 )   CALL ctl_warn('sbc_cpl_alloc: allocation of arrays failed')
228      !
229   END FUNCTION sbc_cpl_alloc
230
231
232   SUBROUTINE sbc_cpl_init( k_ice )     
233      !!----------------------------------------------------------------------
234      !!             ***  ROUTINE sbc_cpl_init  ***
235      !!
236      !! ** Purpose :   Initialisation of send and received information from
237      !!                the atmospheric component
238      !!
239      !! ** Method  : * Read namsbc_cpl namelist
240      !!              * define the receive interface
241      !!              * define the send    interface
242      !!              * initialise the OASIS coupler
243      !!----------------------------------------------------------------------
244      INTEGER, INTENT(in) ::   k_ice   ! ice management in the sbc (=0/1/2/3)
245      !
246      INTEGER ::   jn          ! dummy loop index
247      INTEGER ::   ios, inum   ! Local integer
248      REAL(wp), DIMENSION(jpi,jpj) ::   zacs, zaos
249      !!
250      NAMELIST/namsbc_cpl/  sn_snd_temp  , sn_snd_alb   , sn_snd_thick, sn_snd_crt   , sn_snd_co2  ,   & 
251         &                  sn_snd_ttilyr, sn_snd_cond  , sn_snd_mpnd , sn_snd_sstfrz, sn_snd_thick1,  & 
252         &                  sn_snd_ifrac , sn_snd_crtw  , sn_snd_wlev , sn_rcv_hsig  , sn_rcv_phioc,   & 
253         &                  sn_rcv_w10m  , sn_rcv_taumod, sn_rcv_tau  , sn_rcv_dqnsdt, sn_rcv_qsr  ,   & 
254         &                  sn_rcv_sdrfx , sn_rcv_sdrfy , sn_rcv_wper , sn_rcv_wnum  , sn_rcv_tauwoc,  &
255         &                  sn_rcv_wdrag , sn_rcv_qns   , sn_rcv_emp  , sn_rcv_rnf   , sn_rcv_cal  ,   &
256         &                  sn_rcv_iceflx, sn_rcv_co2   , nn_cplmodel , ln_usecplmask, sn_rcv_mslp ,   &
257         &                  sn_rcv_icb   , sn_rcv_isf   , sn_rcv_wfreq , sn_rcv_tauw, nn_cats_cpl  ,   &
258         &                  sn_rcv_ts_ice
259
260      !!---------------------------------------------------------------------
261      !
262      ! ================================ !
263      !      Namelist informations       !
264      ! ================================ !
265      !
266      READ  ( numnam_ref, namsbc_cpl, IOSTAT = ios, ERR = 901)
267901   IF( ios /= 0 )   CALL ctl_nam ( ios , 'namsbc_cpl in reference namelist' )
268      !
269      READ  ( numnam_cfg, namsbc_cpl, IOSTAT = ios, ERR = 902 )
270902   IF( ios >  0 )   CALL ctl_nam ( ios , 'namsbc_cpl in configuration namelist' )
271      IF(lwm) WRITE ( numond, namsbc_cpl )
272      !
273      IF(lwp) THEN                        ! control print
274         WRITE(numout,*)
275         WRITE(numout,*)'sbc_cpl_init : namsbc_cpl namelist '
276         WRITE(numout,*)'~~~~~~~~~~~~'
277      ENDIF
278      IF( lwp .AND. ln_cpl ) THEN                        ! control print
279         WRITE(numout,*)'  received fields (mutiple ice categogies)'
280         WRITE(numout,*)'      10m wind module                 = ', TRIM(sn_rcv_w10m%cldes  ), ' (', TRIM(sn_rcv_w10m%clcat  ), ')'
281         WRITE(numout,*)'      stress module                   = ', TRIM(sn_rcv_taumod%cldes), ' (', TRIM(sn_rcv_taumod%clcat), ')'
282         WRITE(numout,*)'      surface stress                  = ', TRIM(sn_rcv_tau%cldes   ), ' (', TRIM(sn_rcv_tau%clcat   ), ')'
283         WRITE(numout,*)'                     - referential    = ', sn_rcv_tau%clvref
284         WRITE(numout,*)'                     - orientation    = ', sn_rcv_tau%clvor
285         WRITE(numout,*)'                     - mesh           = ', sn_rcv_tau%clvgrd
286         WRITE(numout,*)'      non-solar heat flux sensitivity = ', TRIM(sn_rcv_dqnsdt%cldes), ' (', TRIM(sn_rcv_dqnsdt%clcat), ')'
287         WRITE(numout,*)'      solar heat flux                 = ', TRIM(sn_rcv_qsr%cldes   ), ' (', TRIM(sn_rcv_qsr%clcat   ), ')'
288         WRITE(numout,*)'      non-solar heat flux             = ', TRIM(sn_rcv_qns%cldes   ), ' (', TRIM(sn_rcv_qns%clcat   ), ')'
289         WRITE(numout,*)'      freshwater budget               = ', TRIM(sn_rcv_emp%cldes   ), ' (', TRIM(sn_rcv_emp%clcat   ), ')'
290         WRITE(numout,*)'      runoffs                         = ', TRIM(sn_rcv_rnf%cldes   ), ' (', TRIM(sn_rcv_rnf%clcat   ), ')'
291         WRITE(numout,*)'      calving                         = ', TRIM(sn_rcv_cal%cldes   ), ' (', TRIM(sn_rcv_cal%clcat   ), ')'
292         WRITE(numout,*)'      iceberg                         = ', TRIM(sn_rcv_icb%cldes   ), ' (', TRIM(sn_rcv_icb%clcat   ), ')'
293         WRITE(numout,*)'      ice shelf                       = ', TRIM(sn_rcv_isf%cldes   ), ' (', TRIM(sn_rcv_isf%clcat   ), ')'
294         WRITE(numout,*)'      sea ice heat fluxes             = ', TRIM(sn_rcv_iceflx%cldes), ' (', TRIM(sn_rcv_iceflx%clcat), ')'
295         WRITE(numout,*)'      atm co2                         = ', TRIM(sn_rcv_co2%cldes   ), ' (', TRIM(sn_rcv_co2%clcat   ), ')'
296         WRITE(numout,*)'      significant wave heigth         = ', TRIM(sn_rcv_hsig%cldes  ), ' (', TRIM(sn_rcv_hsig%clcat  ), ')' 
297         WRITE(numout,*)'      wave to oce energy flux         = ', TRIM(sn_rcv_phioc%cldes ), ' (', TRIM(sn_rcv_phioc%clcat ), ')' 
298         WRITE(numout,*)'      Surface Stokes drift grid u     = ', TRIM(sn_rcv_sdrfx%cldes ), ' (', TRIM(sn_rcv_sdrfx%clcat ), ')' 
299         WRITE(numout,*)'      Surface Stokes drift grid v     = ', TRIM(sn_rcv_sdrfy%cldes ), ' (', TRIM(sn_rcv_sdrfy%clcat ), ')' 
300         WRITE(numout,*)'      Mean wave period                = ', TRIM(sn_rcv_wper%cldes  ), ' (', TRIM(sn_rcv_wper%clcat  ), ')' 
301         WRITE(numout,*)'      Mean wave number                = ', TRIM(sn_rcv_wnum%cldes  ), ' (', TRIM(sn_rcv_wnum%clcat  ), ')' 
302         WRITE(numout,*)'      Wave peak frequency             = ', TRIM(sn_rcv_wfreq%cldes ), ' (', TRIM(sn_rcv_wfreq%clcat ), ')'
303         WRITE(numout,*)'      Stress frac adsorbed by waves   = ', TRIM(sn_rcv_tauwoc%cldes), ' (', TRIM(sn_rcv_tauwoc%clcat ), ')' 
304         WRITE(numout,*)'      Stress components by waves      = ', TRIM(sn_rcv_tauw%cldes  ), ' (', TRIM(sn_rcv_tauw%clcat  ), ')'
305         WRITE(numout,*)'      Neutral surf drag coefficient   = ', TRIM(sn_rcv_wdrag%cldes ), ' (', TRIM(sn_rcv_wdrag%clcat ), ')' 
306         WRITE(numout,*)'      Sea ice surface skin temperature= ', TRIM(sn_rcv_ts_ice%cldes), ' (', TRIM(sn_rcv_ts_ice%clcat), ')' 
307         WRITE(numout,*)'  sent fields (multiple ice categories)'
308         WRITE(numout,*)'      surface temperature             = ', TRIM(sn_snd_temp%cldes  ), ' (', TRIM(sn_snd_temp%clcat  ), ')'
309         WRITE(numout,*)'      top ice layer temperature       = ', TRIM(sn_snd_ttilyr%cldes), ' (', TRIM(sn_snd_ttilyr%clcat), ')'
310         WRITE(numout,*)'      albedo                          = ', TRIM(sn_snd_alb%cldes   ), ' (', TRIM(sn_snd_alb%clcat   ), ')'
311         WRITE(numout,*)'      ice/snow thickness              = ', TRIM(sn_snd_thick%cldes ), ' (', TRIM(sn_snd_thick%clcat ), ')'
312         WRITE(numout,*)'      total ice fraction              = ', TRIM(sn_snd_ifrac%cldes ), ' (', TRIM(sn_snd_ifrac%clcat ), ')' 
313         WRITE(numout,*)'      surface current                 = ', TRIM(sn_snd_crt%cldes   ), ' (', TRIM(sn_snd_crt%clcat   ), ')'
314         WRITE(numout,*)'                      - referential   = ', sn_snd_crt%clvref 
315         WRITE(numout,*)'                      - orientation   = ', sn_snd_crt%clvor
316         WRITE(numout,*)'                      - mesh          = ', sn_snd_crt%clvgrd
317         WRITE(numout,*)'      oce co2 flux                    = ', TRIM(sn_snd_co2%cldes   ), ' (', TRIM(sn_snd_co2%clcat   ), ')'
318         WRITE(numout,*)'      ice effective conductivity      = ', TRIM(sn_snd_cond%cldes  ), ' (', TRIM(sn_snd_cond%clcat  ), ')'
319         WRITE(numout,*)'      meltponds fraction and depth    = ', TRIM(sn_snd_mpnd%cldes  ), ' (', TRIM(sn_snd_mpnd%clcat  ), ')'
320         WRITE(numout,*)'      sea surface freezing temp       = ', TRIM(sn_snd_sstfrz%cldes), ' (', TRIM(sn_snd_sstfrz%clcat), ')'
321         WRITE(numout,*)'      water level                     = ', TRIM(sn_snd_wlev%cldes  ), ' (', TRIM(sn_snd_wlev%clcat  ), ')' 
322         WRITE(numout,*)'      mean sea level pressure         = ', TRIM(sn_rcv_mslp%cldes  ), ' (', TRIM(sn_rcv_mslp%clcat  ), ')' 
323         WRITE(numout,*)'      surface current to waves        = ', TRIM(sn_snd_crtw%cldes  ), ' (', TRIM(sn_snd_crtw%clcat  ), ')' 
324         WRITE(numout,*)'                      - referential   = ', sn_snd_crtw%clvref 
325         WRITE(numout,*)'                      - orientation   = ', sn_snd_crtw%clvor 
326         WRITE(numout,*)'                      - mesh          = ', sn_snd_crtw%clvgrd 
327         WRITE(numout,*)'  nn_cplmodel                         = ', nn_cplmodel
328         WRITE(numout,*)'  ln_usecplmask                       = ', ln_usecplmask
329         WRITE(numout,*)'  nn_cats_cpl                         = ', nn_cats_cpl
330      ENDIF
331
332      !                                   ! allocate sbccpl arrays
333      IF( sbc_cpl_alloc() /= 0 )   CALL ctl_stop( 'STOP', 'sbc_cpl_alloc : unable to allocate arrays' )
334     
335      ! ================================ !
336      !   Define the receive interface   !
337      ! ================================ !
338      nrcvinfo(:) = OASIS_idle   ! needed by nrcvinfo(jpr_otx1) if we do not receive ocean stress
339
340      ! for each field: define the OASIS name                              (srcv(:)%clname)
341      !                 define receive or not from the namelist parameters (srcv(:)%laction)
342      !                 define the north fold type of lbc                  (srcv(:)%nsgn)
343
344      ! default definitions of srcv
345      srcv(:)%laction = .FALSE.   ;   srcv(:)%clgrid = 'T'   ;   srcv(:)%nsgn = 1.   ;   srcv(:)%nct = 1
346
347      !                                                      ! ------------------------- !
348      !                                                      ! ice and ocean wind stress !   
349      !                                                      ! ------------------------- !
350      !                                                           ! Name
351      srcv(jpr_otx1)%clname = 'O_OTaux1'      ! 1st ocean component on grid ONE (T or U)
352      srcv(jpr_oty1)%clname = 'O_OTauy1'      ! 2nd   -      -         -     -
353      srcv(jpr_otz1)%clname = 'O_OTauz1'      ! 3rd   -      -         -     -
354      srcv(jpr_otx2)%clname = 'O_OTaux2'      ! 1st ocean component on grid TWO (V)
355      srcv(jpr_oty2)%clname = 'O_OTauy2'      ! 2nd   -      -         -     -
356      srcv(jpr_otz2)%clname = 'O_OTauz2'      ! 3rd   -      -         -     -
357      !
358      srcv(jpr_itx1)%clname = 'O_ITaux1'      ! 1st  ice  component on grid ONE (T, F, I or U)
359      srcv(jpr_ity1)%clname = 'O_ITauy1'      ! 2nd   -      -         -     -
360      srcv(jpr_itz1)%clname = 'O_ITauz1'      ! 3rd   -      -         -     -
361      srcv(jpr_itx2)%clname = 'O_ITaux2'      ! 1st  ice  component on grid TWO (V)
362      srcv(jpr_ity2)%clname = 'O_ITauy2'      ! 2nd   -      -         -     -
363      srcv(jpr_itz2)%clname = 'O_ITauz2'      ! 3rd   -      -         -     -
364      !
365      ! Vectors: change of sign at north fold ONLY if on the local grid
366      IF( TRIM( sn_rcv_tau%cldes ) == 'oce only' .OR. TRIM(sn_rcv_tau%cldes ) == 'oce and ice') THEN ! avoid working with the atmospheric fields if they are not coupled
367      IF( TRIM( sn_rcv_tau%clvor ) == 'local grid' )   srcv(jpr_otx1:jpr_itz2)%nsgn = -1.
368     
369      !                                                           ! Set grid and action
370      SELECT CASE( TRIM( sn_rcv_tau%clvgrd ) )      !  'T', 'U,V', 'U,V,I', 'U,V,F', 'T,I', 'T,F', or 'T,U,V'
371      CASE( 'T' ) 
372         srcv(jpr_otx1:jpr_itz2)%clgrid  = 'T'        ! oce and ice components given at T-point
373         srcv(jpr_otx1:jpr_otz1)%laction = .TRUE.     ! receive oce components on grid 1
374         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1
375      CASE( 'U,V' ) 
376         srcv(jpr_otx1:jpr_otz1)%clgrid  = 'U'        ! oce components given at U-point
377         srcv(jpr_otx2:jpr_otz2)%clgrid  = 'V'        !           and           V-point
378         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'U'        ! ice components given at U-point
379         srcv(jpr_itx2:jpr_itz2)%clgrid  = 'V'        !           and           V-point
380         srcv(jpr_otx1:jpr_itz2)%laction = .TRUE.     ! receive oce and ice components on both grid 1 & 2
381      CASE( 'U,V,T' )
382         srcv(jpr_otx1:jpr_otz1)%clgrid  = 'U'        ! oce components given at U-point
383         srcv(jpr_otx2:jpr_otz2)%clgrid  = 'V'        !           and           V-point
384         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'T'        ! ice components given at T-point
385         srcv(jpr_otx1:jpr_otz2)%laction = .TRUE.     ! receive oce components on grid 1 & 2
386         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1 only
387      CASE( 'U,V,I' )
388         srcv(jpr_otx1:jpr_otz1)%clgrid  = 'U'        ! oce components given at U-point
389         srcv(jpr_otx2:jpr_otz2)%clgrid  = 'V'        !           and           V-point
390         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'I'        ! ice components given at I-point
391         srcv(jpr_otx1:jpr_otz2)%laction = .TRUE.     ! receive oce components on grid 1 & 2
392         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1 only
393      CASE( 'U,V,F' )
394         srcv(jpr_otx1:jpr_otz1)%clgrid  = 'U'        ! oce components given at U-point
395         srcv(jpr_otx2:jpr_otz2)%clgrid  = 'V'        !           and           V-point
396         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'F'        ! ice components given at F-point
397         srcv(jpr_otx1:jpr_otz2)%laction = .TRUE.     ! receive oce components on grid 1 & 2
398         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1 only
399      CASE( 'T,I' ) 
400         srcv(jpr_otx1:jpr_itz2)%clgrid  = 'T'        ! oce and ice components given at T-point
401         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'I'        ! ice components given at I-point
402         srcv(jpr_otx1:jpr_otz1)%laction = .TRUE.     ! receive oce components on grid 1
403         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1
404      CASE( 'T,F' ) 
405         srcv(jpr_otx1:jpr_itz2)%clgrid  = 'T'        ! oce and ice components given at T-point
406         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'F'        ! ice components given at F-point
407         srcv(jpr_otx1:jpr_otz1)%laction = .TRUE.     ! receive oce components on grid 1
408         srcv(jpr_itx1:jpr_itz1)%laction = .TRUE.     ! receive ice components on grid 1
409      CASE( 'T,U,V' )
410         srcv(jpr_otx1:jpr_otz1)%clgrid  = 'T'        ! oce components given at T-point
411         srcv(jpr_itx1:jpr_itz1)%clgrid  = 'U'        ! ice components given at U-point
412         srcv(jpr_itx2:jpr_itz2)%clgrid  = 'V'        !           and           V-point
413         srcv(jpr_otx1:jpr_otz1)%laction = .TRUE.     ! receive oce components on grid 1 only
414         srcv(jpr_itx1:jpr_itz2)%laction = .TRUE.     ! receive ice components on grid 1 & 2
415      CASE default   
416         CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_rcv_tau%clvgrd' )
417      END SELECT
418      !
419      IF( TRIM( sn_rcv_tau%clvref ) == 'spherical' )   &           ! spherical: 3rd component not received
420         &     srcv( (/jpr_otz1, jpr_otz2, jpr_itz1, jpr_itz2/) )%laction = .FALSE. 
421      !
422      IF( TRIM( sn_rcv_tau%clvor  ) == 'local grid' ) THEN        ! already on local grid -> no need of the second grid
423            srcv(jpr_otx2:jpr_otz2)%laction = .FALSE. 
424            srcv(jpr_itx2:jpr_itz2)%laction = .FALSE. 
425            srcv(jpr_oty1)%clgrid = srcv(jpr_oty2)%clgrid   ! not needed but cleaner...
426            srcv(jpr_ity1)%clgrid = srcv(jpr_ity2)%clgrid   ! not needed but cleaner...
427      ENDIF
428      !
429      IF( TRIM( sn_rcv_tau%cldes ) /= 'oce and ice' ) THEN        ! 'oce and ice' case ocean stress on ocean mesh used
430         srcv(jpr_itx1:jpr_itz2)%laction = .FALSE.    ! ice components not received
431         srcv(jpr_itx1)%clgrid = 'U'                  ! ocean stress used after its transformation
432         srcv(jpr_ity1)%clgrid = 'V'                  ! i.e. it is always at U- & V-points for i- & j-comp. resp.
433      ENDIF
434      ENDIF
435
436      !                                                      ! ------------------------- !
437      !                                                      !    freshwater budget      !   E-P
438      !                                                      ! ------------------------- !
439      ! we suppose that atmosphere modele do not make the difference between precipiration (liquide or solid)
440      ! over ice of free ocean within the same atmospheric cell.cd
441      srcv(jpr_rain)%clname = 'OTotRain'      ! Rain = liquid precipitation
442      srcv(jpr_snow)%clname = 'OTotSnow'      ! Snow = solid precipitation
443      srcv(jpr_tevp)%clname = 'OTotEvap'      ! total evaporation (over oce + ice sublimation)
444      srcv(jpr_ievp)%clname = 'OIceEvap'      ! evaporation over ice = sublimation
445      srcv(jpr_sbpr)%clname = 'OSubMPre'      ! sublimation - liquid precipitation - solid precipitation
446      srcv(jpr_semp)%clname = 'OISubMSn'      ! ice solid water budget = sublimation - solid precipitation
447      srcv(jpr_oemp)%clname = 'OOEvaMPr'      ! ocean water budget = ocean Evap - ocean precip
448      SELECT CASE( TRIM( sn_rcv_emp%cldes ) )
449      CASE( 'none'          )       ! nothing to do
450      CASE( 'oce only'      )   ;   srcv(jpr_oemp)%laction = .TRUE. 
451      CASE( 'conservative'  )
452         srcv( (/jpr_rain, jpr_snow, jpr_ievp, jpr_tevp/) )%laction = .TRUE.
453         IF( k_ice <= 1 )  srcv(jpr_ievp)%laction = .FALSE.
454      CASE( 'oce and ice'   )   ;   srcv( (/jpr_ievp, jpr_sbpr, jpr_semp, jpr_oemp/) )%laction = .TRUE.
455      CASE default              ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_rcv_emp%cldes' )
456      END SELECT
457      !
458      !                                                      ! ------------------------- !
459      !                                                      !     Runoffs & Calving     !   
460      !                                                      ! ------------------------- !
461      srcv(jpr_rnf   )%clname = 'O_Runoff'
462      IF( TRIM( sn_rcv_rnf%cldes ) == 'coupled' ) THEN
463         srcv(jpr_rnf)%laction = .TRUE.
464         l_rnfcpl              = .TRUE.                      ! -> no need to read runoffs in sbcrnf
465         ln_rnf                = nn_components /= jp_iam_sas ! -> force to go through sbcrnf if not sas
466         IF(lwp) WRITE(numout,*)
467         IF(lwp) WRITE(numout,*) '   runoffs received from oasis -> force ln_rnf = ', ln_rnf
468      ENDIF
469      !
470      srcv(jpr_cal)%clname = 'OCalving'   ;  IF( TRIM( sn_rcv_cal%cldes) == 'coupled' )   srcv(jpr_cal)%laction = .TRUE.
471      srcv(jpr_isf)%clname = 'OIcshelf'   ;  IF( TRIM( sn_rcv_isf%cldes) == 'coupled' )   srcv(jpr_isf)%laction = .TRUE.
472      srcv(jpr_icb)%clname = 'OIceberg'   ;  IF( TRIM( sn_rcv_icb%cldes) == 'coupled' )   srcv(jpr_icb)%laction = .TRUE.
473
474      IF( srcv(jpr_isf)%laction ) THEN
475         l_isfoasis = .TRUE.  ! -> isf fwf comes from oasis
476         IF(lwp) WRITE(numout,*)
477         IF(lwp) WRITE(numout,*) '   iceshelf received from oasis '
478         CALL ctl_stop('STOP','not coded')
479      ENDIF
480      !
481      !                                                      ! ------------------------- !
482      !                                                      !    non solar radiation    !   Qns
483      !                                                      ! ------------------------- !
484      srcv(jpr_qnsoce)%clname = 'O_QnsOce'
485      srcv(jpr_qnsice)%clname = 'O_QnsIce'
486      srcv(jpr_qnsmix)%clname = 'O_QnsMix'
487      SELECT CASE( TRIM( sn_rcv_qns%cldes ) )
488      CASE( 'none'          )       ! nothing to do
489      CASE( 'oce only'      )   ;   srcv(               jpr_qnsoce   )%laction = .TRUE.
490      CASE( 'conservative'  )   ;   srcv( (/jpr_qnsice, jpr_qnsmix/) )%laction = .TRUE.
491      CASE( 'oce and ice'   )   ;   srcv( (/jpr_qnsice, jpr_qnsoce/) )%laction = .TRUE.
492      CASE( 'mixed oce-ice' )   ;   srcv(               jpr_qnsmix   )%laction = .TRUE. 
493      CASE default              ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_rcv_qns%cldes' )
494      END SELECT
495      IF( TRIM( sn_rcv_qns%cldes ) == 'mixed oce-ice' .AND. nn_cats_cpl > 1 ) &
496         CALL ctl_stop( 'sbc_cpl_init: sn_rcv_qns%cldes not currently allowed to be mixed oce-ice for multi-category ice' )
497      !
498      !                                                      ! ------------------------- !
499      !                                                      !    solar radiation        !   Qsr
500      !                                                      ! ------------------------- !
501      srcv(jpr_qsroce)%clname = 'O_QsrOce'
502      srcv(jpr_qsrice)%clname = 'O_QsrIce'
503      srcv(jpr_qsrmix)%clname = 'O_QsrMix'
504      SELECT CASE( TRIM( sn_rcv_qsr%cldes ) )
505      CASE( 'none'          )       ! nothing to do
506      CASE( 'oce only'      )   ;   srcv(               jpr_qsroce   )%laction = .TRUE.
507      CASE( 'conservative'  )   ;   srcv( (/jpr_qsrice, jpr_qsrmix/) )%laction = .TRUE.
508      CASE( 'oce and ice'   )   ;   srcv( (/jpr_qsrice, jpr_qsroce/) )%laction = .TRUE.
509      CASE( 'mixed oce-ice' )   ;   srcv(               jpr_qsrmix   )%laction = .TRUE. 
510      CASE default              ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_rcv_qsr%cldes' )
511      END SELECT
512      IF( TRIM( sn_rcv_qsr%cldes ) == 'mixed oce-ice' .AND. nn_cats_cpl > 1 ) &
513         CALL ctl_stop( 'sbc_cpl_init: sn_rcv_qsr%cldes not currently allowed to be mixed oce-ice for multi-category ice' )
514      !
515      !                                                      ! ------------------------- !
516      !                                                      !   non solar sensitivity   !   d(Qns)/d(T)
517      !                                                      ! ------------------------- !
518      srcv(jpr_dqnsdt)%clname = 'O_dQnsdT'   
519      IF( TRIM( sn_rcv_dqnsdt%cldes ) == 'coupled' )   srcv(jpr_dqnsdt)%laction = .TRUE.
520      !
521      ! non solar sensitivity mandatory for mixed oce-ice solar radiation coupling technique
522      IF( TRIM( sn_rcv_dqnsdt%cldes ) == 'none' .AND. TRIM( sn_rcv_qns%cldes ) == 'mixed oce-ice' )  &
523         &   CALL ctl_stop( 'sbc_cpl_init: namsbc_cpl namelist mismatch between sn_rcv_qns%cldes and sn_rcv_dqnsdt%cldes' )
524      !
525      !                                                      ! ------------------------- !
526      !                                                      !      10m wind module      !   
527      !                                                      ! ------------------------- !
528      srcv(jpr_w10m)%clname = 'O_Wind10'   ;   IF( TRIM(sn_rcv_w10m%cldes  ) == 'coupled' )   srcv(jpr_w10m)%laction = .TRUE. 
529      !
530      !                                                      ! ------------------------- !
531      !                                                      !   wind stress module      !   
532      !                                                      ! ------------------------- !
533      srcv(jpr_taum)%clname = 'O_TauMod'   ;   IF( TRIM(sn_rcv_taumod%cldes) == 'coupled' )   srcv(jpr_taum)%laction = .TRUE.
534      !
535      !                                                      ! ------------------------- !
536      !                                                      !      Atmospheric CO2      !
537      !                                                      ! ------------------------- !
538      srcv(jpr_co2 )%clname = 'O_AtmCO2'   
539      IF( TRIM(sn_rcv_co2%cldes   ) == 'coupled' )  THEN
540         srcv(jpr_co2 )%laction = .TRUE.
541         l_co2cpl = .TRUE.
542         IF(lwp) WRITE(numout,*)
543         IF(lwp) WRITE(numout,*) '   Atmospheric pco2 received from oasis '
544         IF(lwp) WRITE(numout,*)
545      ENDIF
546      !
547      !                                                      ! ------------------------- !
548      !                                                      ! Mean Sea Level Pressure   !
549      !                                                      ! ------------------------- !
550      srcv(jpr_mslp)%clname = 'O_MSLP'     ;   IF( TRIM(sn_rcv_mslp%cldes  ) == 'coupled' )    srcv(jpr_mslp)%laction = .TRUE. 
551      !
552      !                                                      ! ------------------------- !
553      !                                                      !  ice topmelt and botmelt  !   
554      !                                                      ! ------------------------- !
555      srcv(jpr_topm )%clname = 'OTopMlt'
556      srcv(jpr_botm )%clname = 'OBotMlt'
557      IF( TRIM(sn_rcv_iceflx%cldes) == 'coupled' ) THEN
558         IF( TRIM( sn_rcv_iceflx%clcat ) == 'yes' ) THEN
559            srcv(jpr_topm:jpr_botm)%nct = nn_cats_cpl
560         ELSE
561            CALL ctl_stop( 'sbc_cpl_init: sn_rcv_iceflx%clcat should always be set to yes currently' )
562         ENDIF
563         srcv(jpr_topm:jpr_botm)%laction = .TRUE.
564      ENDIF
565      !                                                      ! ------------------------- !
566      !                                                      !    ice skin temperature   !   
567      !                                                      ! ------------------------- !
568      srcv(jpr_ts_ice)%clname = 'OTsfIce'    ! needed by Met Office
569      IF( TRIM( sn_rcv_ts_ice%cldes ) == 'ice' )   srcv(jpr_ts_ice)%laction = .TRUE.
570      IF( TRIM( sn_rcv_ts_ice%clcat ) == 'yes' )   srcv(jpr_ts_ice)%nct     = nn_cats_cpl
571      IF( TRIM( sn_rcv_emp%clcat    ) == 'yes' )   srcv(jpr_ievp)%nct       = nn_cats_cpl
572
573#if defined key_si3
574      IF( ln_cndflx .AND. .NOT.ln_cndemulate ) THEN
575         IF( .NOT.srcv(jpr_ts_ice)%laction )  &
576            &   CALL ctl_stop( 'sbc_cpl_init: srcv(jpr_ts_ice)%laction should be set to true when ln_cndflx=T' )     
577      ENDIF
578#endif
579      !                                                      ! ------------------------- !
580      !                                                      !      Wave breaking        !   
581      !                                                      ! ------------------------- !
582      srcv(jpr_hsig)%clname  = 'O_Hsigwa'    ! significant wave height
583      IF( TRIM(sn_rcv_hsig%cldes  ) == 'coupled' )  THEN
584         srcv(jpr_hsig)%laction = .TRUE.
585         cpl_hsig = .TRUE.
586      ENDIF
587      srcv(jpr_phioc)%clname = 'O_PhiOce'    ! wave to ocean energy
588      IF( TRIM(sn_rcv_phioc%cldes ) == 'coupled' )  THEN
589         srcv(jpr_phioc)%laction = .TRUE.
590         cpl_phioc = .TRUE.
591      ENDIF
592      srcv(jpr_sdrftx)%clname = 'O_Sdrfx'    ! Stokes drift in the u direction
593      IF( TRIM(sn_rcv_sdrfx%cldes ) == 'coupled' )  THEN
594         srcv(jpr_sdrftx)%laction = .TRUE.
595         cpl_sdrftx = .TRUE.
596      ENDIF
597      srcv(jpr_sdrfty)%clname = 'O_Sdrfy'    ! Stokes drift in the v direction
598      IF( TRIM(sn_rcv_sdrfy%cldes ) == 'coupled' )  THEN
599         srcv(jpr_sdrfty)%laction = .TRUE.
600         cpl_sdrfty = .TRUE.
601      ENDIF
602      srcv(jpr_wper)%clname = 'O_WPer'       ! mean wave period
603      IF( TRIM(sn_rcv_wper%cldes  ) == 'coupled' )  THEN
604         srcv(jpr_wper)%laction = .TRUE.
605         cpl_wper = .TRUE.
606      ENDIF
607      srcv(jpr_wfreq)%clname = 'O_WFreq'     ! wave peak frequency
608      IF( TRIM(sn_rcv_wfreq%cldes ) == 'coupled' )  THEN
609         srcv(jpr_wfreq)%laction = .TRUE.
610         cpl_wfreq = .TRUE.
611      ENDIF
612      srcv(jpr_wnum)%clname = 'O_WNum'       ! mean wave number
613      IF( TRIM(sn_rcv_wnum%cldes ) == 'coupled' )  THEN
614         srcv(jpr_wnum)%laction = .TRUE.
615         cpl_wnum = .TRUE.
616      ENDIF
617      srcv(jpr_tauwoc)%clname = 'O_TauOce'   ! stress fraction adsorbed by the wave
618      IF( TRIM(sn_rcv_tauwoc%cldes ) == 'coupled' )  THEN
619         srcv(jpr_tauwoc)%laction = .TRUE.
620         cpl_tauwoc = .TRUE.
621      ENDIF
622      srcv(jpr_tauwx)%clname = 'O_Tauwx'      ! ocean stress from wave in the x direction
623      srcv(jpr_tauwy)%clname = 'O_Tauwy'      ! ocean stress from wave in the y direction
624      IF( TRIM(sn_rcv_tauw%cldes ) == 'coupled' )  THEN
625         srcv(jpr_tauwx)%laction = .TRUE.
626         srcv(jpr_tauwy)%laction = .TRUE.
627         cpl_tauw = .TRUE.
628      ENDIF
629      srcv(jpr_wdrag)%clname = 'O_WDrag'     ! neutral surface drag coefficient
630      IF( TRIM(sn_rcv_wdrag%cldes ) == 'coupled' )  THEN
631         srcv(jpr_wdrag)%laction = .TRUE.
632         cpl_wdrag = .TRUE.
633      ENDIF
634      IF( srcv(jpr_tauwoc)%laction .AND. srcv(jpr_tauwx)%laction .AND. srcv(jpr_tauwy)%laction ) &
635            CALL ctl_stop( 'More than one method for modifying the ocean stress has been selected ', &
636                                     '(sn_rcv_tauwoc=coupled and sn_rcv_tauw=coupled)' )
637      !
638      !                                                      ! ------------------------------- !
639      !                                                      !   OPA-SAS coupling - rcv by opa !   
640      !                                                      ! ------------------------------- !
641      srcv(jpr_sflx)%clname = 'O_SFLX'
642      srcv(jpr_fice)%clname = 'RIceFrc'
643      !
644      IF( nn_components == jp_iam_opa ) THEN    ! OPA coupled to SAS via OASIS: force received field by OPA (sent by SAS)
645         srcv(:)%laction = .FALSE.   ! force default definition in case of opa <-> sas coupling
646         srcv(:)%clgrid  = 'T'       ! force default definition in case of opa <-> sas coupling
647         srcv(:)%nsgn    = 1.        ! force default definition in case of opa <-> sas coupling
648         srcv( (/jpr_qsroce, jpr_qnsoce, jpr_oemp, jpr_sflx, jpr_fice, jpr_otx1, jpr_oty1, jpr_taum/) )%laction = .TRUE.
649         srcv(jpr_otx1)%clgrid = 'U'        ! oce components given at U-point
650         srcv(jpr_oty1)%clgrid = 'V'        !           and           V-point
651         ! Vectors: change of sign at north fold ONLY if on the local grid
652         srcv( (/jpr_otx1,jpr_oty1/) )%nsgn = -1.
653         sn_rcv_tau%clvgrd = 'U,V'
654         sn_rcv_tau%clvor = 'local grid'
655         sn_rcv_tau%clvref = 'spherical'
656         sn_rcv_emp%cldes = 'oce only'
657         !
658         IF(lwp) THEN                        ! control print
659            WRITE(numout,*)
660            WRITE(numout,*)'               Special conditions for SAS-OPA coupling  '
661            WRITE(numout,*)'               OPA component  '
662            WRITE(numout,*)
663            WRITE(numout,*)'  received fields from SAS component '
664            WRITE(numout,*)'                  ice cover '
665            WRITE(numout,*)'                  oce only EMP  '
666            WRITE(numout,*)'                  salt flux  '
667            WRITE(numout,*)'                  mixed oce-ice solar flux  '
668            WRITE(numout,*)'                  mixed oce-ice non solar flux  '
669            WRITE(numout,*)'                  wind stress U,V on local grid and sperical coordinates '
670            WRITE(numout,*)'                  wind stress module'
671            WRITE(numout,*)
672         ENDIF
673      ENDIF
674      !                                                      ! -------------------------------- !
675      !                                                      !   OPA-SAS coupling - rcv by sas  !   
676      !                                                      ! -------------------------------- !
677      srcv(jpr_toce  )%clname = 'I_SSTSST'
678      srcv(jpr_soce  )%clname = 'I_SSSal'
679      srcv(jpr_ocx1  )%clname = 'I_OCurx1'
680      srcv(jpr_ocy1  )%clname = 'I_OCury1'
681      srcv(jpr_ssh   )%clname = 'I_SSHght'
682      srcv(jpr_e3t1st)%clname = 'I_E3T1st'   
683      srcv(jpr_fraqsr)%clname = 'I_FraQsr'   
684      !
685      IF( nn_components == jp_iam_sas ) THEN
686         IF( .NOT. ln_cpl ) srcv(:)%laction = .FALSE.   ! force default definition in case of opa <-> sas coupling
687         IF( .NOT. ln_cpl ) srcv(:)%clgrid  = 'T'       ! force default definition in case of opa <-> sas coupling
688         IF( .NOT. ln_cpl ) srcv(:)%nsgn    = 1.        ! force default definition in case of opa <-> sas coupling
689         srcv( (/jpr_toce, jpr_soce, jpr_ssh, jpr_fraqsr, jpr_ocx1, jpr_ocy1/) )%laction = .TRUE.
690         srcv( jpr_e3t1st )%laction = .NOT.ln_linssh
691         srcv(jpr_ocx1)%clgrid = 'U'        ! oce components given at U-point
692         srcv(jpr_ocy1)%clgrid = 'V'        !           and           V-point
693         ! Vectors: change of sign at north fold ONLY if on the local grid
694         srcv(jpr_ocx1:jpr_ocy1)%nsgn = -1.
695         ! Change first letter to couple with atmosphere if already coupled OPA
696         ! this is nedeed as each variable name used in the namcouple must be unique:
697         ! for example O_Runoff received by OPA from SAS and therefore O_Runoff received by SAS from the Atmosphere
698         DO jn = 1, jprcv
699            IF( srcv(jn)%clname(1:1) == "O" ) srcv(jn)%clname = "S"//srcv(jn)%clname(2:LEN(srcv(jn)%clname))
700         END DO
701         !
702         IF(lwp) THEN                        ! control print
703            WRITE(numout,*)
704            WRITE(numout,*)'               Special conditions for SAS-OPA coupling  '
705            WRITE(numout,*)'               SAS component  '
706            WRITE(numout,*)
707            IF( .NOT. ln_cpl ) THEN
708               WRITE(numout,*)'  received fields from OPA component '
709            ELSE
710               WRITE(numout,*)'  Additional received fields from OPA component : '
711            ENDIF
712            WRITE(numout,*)'               sea surface temperature (Celsius) '
713            WRITE(numout,*)'               sea surface salinity ' 
714            WRITE(numout,*)'               surface currents ' 
715            WRITE(numout,*)'               sea surface height ' 
716            WRITE(numout,*)'               thickness of first ocean T level '       
717            WRITE(numout,*)'               fraction of solar net radiation absorbed in the first ocean level'
718            WRITE(numout,*)
719         ENDIF
720      ENDIF
721     
722      ! =================================================== !
723      ! Allocate all parts of frcv used for received fields !
724      ! =================================================== !
725      DO jn = 1, jprcv
726         IF( srcv(jn)%laction ) ALLOCATE( frcv(jn)%z3(jpi,jpj,srcv(jn)%nct) )
727      END DO
728      ! Allocate taum part of frcv which is used even when not received as coupling field
729      IF( .NOT. srcv(jpr_taum)%laction ) ALLOCATE( frcv(jpr_taum)%z3(jpi,jpj,srcv(jpr_taum)%nct) )
730      ! Allocate w10m part of frcv which is used even when not received as coupling field
731      IF( .NOT. srcv(jpr_w10m)%laction ) ALLOCATE( frcv(jpr_w10m)%z3(jpi,jpj,srcv(jpr_w10m)%nct) )
732      ! Allocate jpr_otx1 part of frcv which is used even when not received as coupling field
733      IF( .NOT. srcv(jpr_otx1)%laction ) ALLOCATE( frcv(jpr_otx1)%z3(jpi,jpj,srcv(jpr_otx1)%nct) )
734      IF( .NOT. srcv(jpr_oty1)%laction ) ALLOCATE( frcv(jpr_oty1)%z3(jpi,jpj,srcv(jpr_oty1)%nct) )
735      ! Allocate itx1 and ity1 as they are used in sbc_cpl_ice_tau even if srcv(jpr_itx1)%laction = .FALSE.
736      IF( k_ice /= 0 ) THEN
737         IF( .NOT. srcv(jpr_itx1)%laction ) ALLOCATE( frcv(jpr_itx1)%z3(jpi,jpj,srcv(jpr_itx1)%nct) )
738         IF( .NOT. srcv(jpr_ity1)%laction ) ALLOCATE( frcv(jpr_ity1)%z3(jpi,jpj,srcv(jpr_ity1)%nct) )
739      ENDIF
740
741      ! ================================ !
742      !     Define the send interface    !
743      ! ================================ !
744      ! for each field: define the OASIS name                           (ssnd(:)%clname)
745      !                 define send or not from the namelist parameters (ssnd(:)%laction)
746      !                 define the north fold type of lbc               (ssnd(:)%nsgn)
747     
748      ! default definitions of nsnd
749      ssnd(:)%laction = .FALSE.   ;   ssnd(:)%clgrid = 'T'   ;   ssnd(:)%nsgn = 1.  ; ssnd(:)%nct = 1
750         
751      !                                                      ! ------------------------- !
752      !                                                      !    Surface temperature    !
753      !                                                      ! ------------------------- !
754      ssnd(jps_toce)%clname   = 'O_SSTSST'
755      ssnd(jps_tice)%clname   = 'O_TepIce'
756      ssnd(jps_ttilyr)%clname = 'O_TtiLyr'
757      ssnd(jps_tmix)%clname   = 'O_TepMix'
758      SELECT CASE( TRIM( sn_snd_temp%cldes ) )
759      CASE( 'none'                                 )       ! nothing to do
760      CASE( 'oce only'                             )   ;   ssnd( jps_toce )%laction = .TRUE.
761      CASE( 'oce and ice' , 'weighted oce and ice' , 'oce and weighted ice' )
762         ssnd( (/jps_toce, jps_tice/) )%laction = .TRUE.
763         IF( TRIM( sn_snd_temp%clcat ) == 'yes' )  ssnd(jps_tice)%nct = nn_cats_cpl
764      CASE( 'mixed oce-ice'                        )   ;   ssnd( jps_tmix )%laction = .TRUE.
765      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_temp%cldes' )
766      END SELECT
767           
768      !                                                      ! ------------------------- !
769      !                                                      !          Albedo           !
770      !                                                      ! ------------------------- !
771      ssnd(jps_albice)%clname = 'O_AlbIce' 
772      ssnd(jps_albmix)%clname = 'O_AlbMix'
773      SELECT CASE( TRIM( sn_snd_alb%cldes ) )
774      CASE( 'none'                 )     ! nothing to do
775      CASE( 'ice' , 'weighted ice' )   ; ssnd(jps_albice)%laction = .TRUE.
776      CASE( 'mixed oce-ice'        )   ; ssnd(jps_albmix)%laction = .TRUE.
777      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_alb%cldes' )
778      END SELECT
779      !
780      ! Need to calculate oceanic albedo if
781      !     1. sending mixed oce-ice albedo or
782      !     2. receiving mixed oce-ice solar radiation
783      IF( TRIM ( sn_snd_alb%cldes ) == 'mixed oce-ice' .OR. TRIM ( sn_rcv_qsr%cldes ) == 'mixed oce-ice' ) THEN
784         CALL oce_alb( zaos, zacs )
785         ! Due to lack of information on nebulosity : mean clear/overcast sky
786         alb_oce_mix(:,:) = ( zacs(:,:) + zaos(:,:) ) * 0.5
787      ENDIF
788      !                                                      ! ------------------------- !
789      !                                                      !  Ice fraction & Thickness !
790      !                                                      ! ------------------------- !
791      ssnd(jps_fice)%clname  = 'OIceFrc'
792      ssnd(jps_ficet)%clname = 'OIceFrcT' 
793      ssnd(jps_hice)%clname  = 'OIceTck'
794      ssnd(jps_a_p)%clname   = 'OPndFrc'
795      ssnd(jps_ht_p)%clname  = 'OPndTck'
796      ssnd(jps_hsnw)%clname  = 'OSnwTck'
797      ssnd(jps_fice1)%clname = 'OIceFrd'
798      IF( k_ice /= 0 ) THEN
799         ssnd(jps_fice)%laction  = .TRUE.                 ! if ice treated in the ocean (even in climato case)
800         ssnd(jps_fice1)%laction = .TRUE.                 ! First-order regridded ice concentration, to be used producing atmos-to-ice fluxes (Met Office requirement)
801! Currently no namelist entry to determine sending of multi-category ice fraction so use the thickness entry for now
802         IF( TRIM( sn_snd_thick%clcat  ) == 'yes' ) ssnd(jps_fice)%nct  = nn_cats_cpl
803         IF( TRIM( sn_snd_thick1%clcat ) == 'yes' ) ssnd(jps_fice1)%nct = nn_cats_cpl
804      ENDIF
805     
806      IF(TRIM( sn_snd_ifrac%cldes )  == 'coupled') ssnd(jps_ficet)%laction = .TRUE. 
807
808      SELECT CASE ( TRIM( sn_snd_thick%cldes ) )
809      CASE( 'none'         )       ! nothing to do
810      CASE( 'ice and snow' ) 
811         ssnd(jps_hice:jps_hsnw)%laction = .TRUE.
812         IF( TRIM( sn_snd_thick%clcat ) == 'yes' ) THEN
813            ssnd(jps_hice:jps_hsnw)%nct = nn_cats_cpl
814         ENDIF
815      CASE ( 'weighted ice and snow' ) 
816         ssnd(jps_hice:jps_hsnw)%laction = .TRUE.
817         IF( TRIM( sn_snd_thick%clcat ) == 'yes' ) ssnd(jps_hice:jps_hsnw)%nct = nn_cats_cpl
818      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_thick%cldes' )
819      END SELECT
820
821      !                                                      ! ------------------------- !
822      !                                                      !      Ice Meltponds        !
823      !                                                      ! ------------------------- !
824      ! Needed by Met Office
825      ssnd(jps_a_p)%clname  = 'OPndFrc'   
826      ssnd(jps_ht_p)%clname = 'OPndTck'   
827      SELECT CASE ( TRIM( sn_snd_mpnd%cldes ) ) 
828      CASE ( 'none' ) 
829         ssnd(jps_a_p)%laction  = .FALSE. 
830         ssnd(jps_ht_p)%laction = .FALSE. 
831      CASE ( 'ice only' ) 
832         ssnd(jps_a_p)%laction  = .TRUE. 
833         ssnd(jps_ht_p)%laction = .TRUE. 
834         IF( TRIM( sn_snd_mpnd%clcat ) == 'yes' ) THEN
835            ssnd(jps_a_p)%nct  = nn_cats_cpl 
836            ssnd(jps_ht_p)%nct = nn_cats_cpl 
837         ELSE
838            IF( nn_cats_cpl > 1 ) THEN
839               CALL ctl_stop( 'sbc_cpl_init: use weighted ice option for sn_snd_mpnd%cldes if not exchanging category fields' ) 
840            ENDIF
841         ENDIF
842      CASE ( 'weighted ice' ) 
843         ssnd(jps_a_p)%laction  = .TRUE. 
844         ssnd(jps_ht_p)%laction = .TRUE. 
845         IF( TRIM( sn_snd_mpnd%clcat ) == 'yes' ) THEN
846            ssnd(jps_a_p)%nct  = nn_cats_cpl 
847            ssnd(jps_ht_p)%nct = nn_cats_cpl 
848         ENDIF
849      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_mpnd%cldes; '//sn_snd_mpnd%cldes ) 
850      END SELECT 
851 
852      !                                                      ! ------------------------- !
853      !                                                      !      Surface current      !
854      !                                                      ! ------------------------- !
855      !        ocean currents              !            ice velocities
856      ssnd(jps_ocx1)%clname = 'O_OCurx1'   ;   ssnd(jps_ivx1)%clname = 'O_IVelx1'
857      ssnd(jps_ocy1)%clname = 'O_OCury1'   ;   ssnd(jps_ivy1)%clname = 'O_IVely1'
858      ssnd(jps_ocz1)%clname = 'O_OCurz1'   ;   ssnd(jps_ivz1)%clname = 'O_IVelz1'
859      ssnd(jps_ocxw)%clname = 'O_OCurxw' 
860      ssnd(jps_ocyw)%clname = 'O_OCuryw' 
861      !
862      ssnd(jps_ocx1:jps_ivz1)%nsgn = -1.   ! vectors: change of the sign at the north fold
863
864      IF( sn_snd_crt%clvgrd == 'U,V' ) THEN
865         ssnd(jps_ocx1)%clgrid = 'U' ; ssnd(jps_ocy1)%clgrid = 'V'
866      ELSE IF( sn_snd_crt%clvgrd /= 'T' ) THEN 
867         CALL ctl_stop( 'sn_snd_crt%clvgrd must be equal to T' )
868      ENDIF
869      ssnd(jps_ocx1:jps_ivz1)%laction = .TRUE.   ! default: all are send
870      IF( TRIM( sn_snd_crt%clvref ) == 'spherical' )   ssnd( (/jps_ocz1, jps_ivz1/) )%laction = .FALSE. 
871      IF( TRIM( sn_snd_crt%clvor ) == 'eastward-northward' ) ssnd(jps_ocx1:jps_ivz1)%nsgn = 1.
872      SELECT CASE( TRIM( sn_snd_crt%cldes ) )
873      CASE( 'none'                 )   ;   ssnd(jps_ocx1:jps_ivz1)%laction = .FALSE.
874      CASE( 'oce only'             )   ;   ssnd(jps_ivx1:jps_ivz1)%laction = .FALSE.
875      CASE( 'weighted oce and ice' )   !   nothing to do
876      CASE( 'mixed oce-ice'        )   ;   ssnd(jps_ivx1:jps_ivz1)%laction = .FALSE.
877      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_crt%cldes' )
878      END SELECT
879
880      ssnd(jps_ocxw:jps_ocyw)%nsgn = -1.   ! vectors: change of the sign at the north fold
881       
882      IF( sn_snd_crtw%clvgrd == 'U,V' ) THEN
883         ssnd(jps_ocxw)%clgrid = 'U' ; ssnd(jps_ocyw)%clgrid = 'V' 
884      ELSE IF( sn_snd_crtw%clvgrd /= 'T' ) THEN
885         CALL ctl_stop( 'sn_snd_crtw%clvgrd must be equal to T' ) 
886      ENDIF
887      IF( TRIM( sn_snd_crtw%clvor ) == 'eastward-northward' ) ssnd(jps_ocxw:jps_ocyw)%nsgn = 1. 
888      SELECT CASE( TRIM( sn_snd_crtw%cldes ) ) 
889         CASE( 'none'                 )   ; ssnd(jps_ocxw:jps_ocyw)%laction = .FALSE. 
890         CASE( 'oce only'             )   ; ssnd(jps_ocxw:jps_ocyw)%laction = .TRUE. 
891         CASE( 'weighted oce and ice' )   !   nothing to do
892         CASE( 'mixed oce-ice'        )   ; ssnd(jps_ivx1:jps_ivz1)%laction = .FALSE. 
893         CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_crtw%cldes' ) 
894      END SELECT 
895
896      !                                                      ! ------------------------- !
897      !                                                      !          CO2 flux         !
898      !                                                      ! ------------------------- !
899      ssnd(jps_co2)%clname = 'O_CO2FLX' ;  IF( TRIM(sn_snd_co2%cldes) == 'coupled' )    ssnd(jps_co2 )%laction = .TRUE.
900      !
901      !                                                      ! ------------------------- !
902      !                                                      ! Sea surface freezing temp !
903      !                                                      ! ------------------------- !
904      ! needed by Met Office
905      ssnd(jps_sstfrz)%clname = 'O_SSTFrz' ; IF( TRIM(sn_snd_sstfrz%cldes) == 'coupled' )  ssnd(jps_sstfrz)%laction = .TRUE. 
906      !
907      !                                                      ! ------------------------- !
908      !                                                      !    Ice conductivity       !
909      !                                                      ! ------------------------- !
910      ! needed by Met Office
911      ! Note that ultimately we will move to passing an ocean effective conductivity as well so there
912      ! will be some changes to the parts of the code which currently relate only to ice conductivity
913      ssnd(jps_ttilyr )%clname = 'O_TtiLyr' 
914      SELECT CASE ( TRIM( sn_snd_ttilyr%cldes ) ) 
915      CASE ( 'none' ) 
916         ssnd(jps_ttilyr)%laction = .FALSE. 
917      CASE ( 'ice only' ) 
918         ssnd(jps_ttilyr)%laction = .TRUE. 
919         IF( TRIM( sn_snd_ttilyr%clcat ) == 'yes' ) THEN
920            ssnd(jps_ttilyr)%nct = nn_cats_cpl 
921         ELSE
922            IF( nn_cats_cpl > 1 ) THEN
923               CALL ctl_stop( 'sbc_cpl_init: use weighted ice option for sn_snd_ttilyr%cldes if not exchanging category fields' ) 
924            ENDIF
925         ENDIF
926      CASE ( 'weighted ice' ) 
927         ssnd(jps_ttilyr)%laction = .TRUE. 
928         IF( TRIM( sn_snd_ttilyr%clcat ) == 'yes' ) ssnd(jps_ttilyr)%nct = nn_cats_cpl 
929      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_ttilyr%cldes;'//sn_snd_ttilyr%cldes ) 
930      END SELECT
931
932      ssnd(jps_kice )%clname = 'OIceKn' 
933      SELECT CASE ( TRIM( sn_snd_cond%cldes ) ) 
934      CASE ( 'none' ) 
935         ssnd(jps_kice)%laction = .FALSE. 
936      CASE ( 'ice only' ) 
937         ssnd(jps_kice)%laction = .TRUE. 
938         IF( TRIM( sn_snd_cond%clcat ) == 'yes' ) THEN
939            ssnd(jps_kice)%nct = nn_cats_cpl 
940         ELSE
941            IF( nn_cats_cpl > 1 ) THEN
942               CALL ctl_stop( 'sbc_cpl_init: use weighted ice option for sn_snd_cond%cldes if not exchanging category fields' ) 
943            ENDIF
944         ENDIF
945      CASE ( 'weighted ice' ) 
946         ssnd(jps_kice)%laction = .TRUE. 
947         IF( TRIM( sn_snd_cond%clcat ) == 'yes' ) ssnd(jps_kice)%nct = nn_cats_cpl 
948      CASE default   ;   CALL ctl_stop( 'sbc_cpl_init: wrong definition of sn_snd_cond%cldes;'//sn_snd_cond%cldes ) 
949      END SELECT 
950      !
951      !                                                      ! ------------------------- !
952      !                                                      !     Sea surface height    !
953      !                                                      ! ------------------------- !
954      ssnd(jps_wlev)%clname = 'O_Wlevel' ;  IF( TRIM(sn_snd_wlev%cldes) == 'coupled' )   ssnd(jps_wlev)%laction = .TRUE. 
955
956      !                                                      ! ------------------------------- !
957      !                                                      !   OPA-SAS coupling - snd by opa !   
958      !                                                      ! ------------------------------- !
959      ssnd(jps_ssh   )%clname = 'O_SSHght' 
960      ssnd(jps_soce  )%clname = 'O_SSSal' 
961      ssnd(jps_e3t1st)%clname = 'O_E3T1st'   
962      ssnd(jps_fraqsr)%clname = 'O_FraQsr'
963      !
964      IF( nn_components == jp_iam_opa ) THEN
965         ssnd(:)%laction = .FALSE.   ! force default definition in case of opa <-> sas coupling
966         ssnd( (/jps_toce, jps_soce, jps_ssh, jps_fraqsr, jps_ocx1, jps_ocy1/) )%laction = .TRUE.
967         ssnd( jps_e3t1st )%laction = .NOT.ln_linssh
968         ! vector definition: not used but cleaner...
969         ssnd(jps_ocx1)%clgrid  = 'U'        ! oce components given at U-point
970         ssnd(jps_ocy1)%clgrid  = 'V'        !           and           V-point
971         sn_snd_crt%clvgrd = 'U,V'
972         sn_snd_crt%clvor = 'local grid'
973         sn_snd_crt%clvref = 'spherical'
974         !
975         IF(lwp) THEN                        ! control print
976            WRITE(numout,*)
977            WRITE(numout,*)'  sent fields to SAS component '
978            WRITE(numout,*)'               sea surface temperature (T before, Celsius) '
979            WRITE(numout,*)'               sea surface salinity ' 
980            WRITE(numout,*)'               surface currents U,V on local grid and spherical coordinates' 
981            WRITE(numout,*)'               sea surface height ' 
982            WRITE(numout,*)'               thickness of first ocean T level '       
983            WRITE(numout,*)'               fraction of solar net radiation absorbed in the first ocean level'
984            WRITE(numout,*)
985         ENDIF
986      ENDIF
987      !                                                      ! ------------------------------- !
988      !                                                      !   OPA-SAS coupling - snd by sas !   
989      !                                                      ! ------------------------------- !
990      ssnd(jps_sflx  )%clname = 'I_SFLX'     
991      ssnd(jps_fice2 )%clname = 'IIceFrc'
992      ssnd(jps_qsroce)%clname = 'I_QsrOce'   
993      ssnd(jps_qnsoce)%clname = 'I_QnsOce'   
994      ssnd(jps_oemp  )%clname = 'IOEvaMPr' 
995      ssnd(jps_otx1  )%clname = 'I_OTaux1'   
996      ssnd(jps_oty1  )%clname = 'I_OTauy1'   
997      ssnd(jps_rnf   )%clname = 'I_Runoff'   
998      ssnd(jps_taum  )%clname = 'I_TauMod'   
999      !
1000      IF( nn_components == jp_iam_sas ) THEN
1001         IF( .NOT. ln_cpl ) ssnd(:)%laction = .FALSE.   ! force default definition in case of opa <-> sas coupling
1002         ssnd( (/jps_qsroce, jps_qnsoce, jps_oemp, jps_fice2, jps_sflx, jps_otx1, jps_oty1, jps_taum/) )%laction = .TRUE.
1003         !
1004         ! Change first letter to couple with atmosphere if already coupled with sea_ice
1005         ! this is nedeed as each variable name used in the namcouple must be unique:
1006         ! for example O_SSTSST sent by OPA to SAS and therefore S_SSTSST sent by SAS to the Atmosphere
1007         DO jn = 1, jpsnd
1008            IF( ssnd(jn)%clname(1:1) == "O" ) ssnd(jn)%clname = "S"//ssnd(jn)%clname(2:LEN(ssnd(jn)%clname))
1009         END DO
1010         !
1011         IF(lwp) THEN                        ! control print
1012            WRITE(numout,*)
1013            IF( .NOT. ln_cpl ) THEN
1014               WRITE(numout,*)'  sent fields to OPA component '
1015            ELSE
1016               WRITE(numout,*)'  Additional sent fields to OPA component : '
1017            ENDIF
1018            WRITE(numout,*)'                  ice cover '
1019            WRITE(numout,*)'                  oce only EMP  '
1020            WRITE(numout,*)'                  salt flux  '
1021            WRITE(numout,*)'                  mixed oce-ice solar flux  '
1022            WRITE(numout,*)'                  mixed oce-ice non solar flux  '
1023            WRITE(numout,*)'                  wind stress U,V components'
1024            WRITE(numout,*)'                  wind stress module'
1025         ENDIF
1026      ENDIF
1027
1028      !
1029      ! ================================ !
1030      !   initialisation of the coupler  !
1031      ! ================================ !
1032
1033      CALL cpl_define(jprcv, jpsnd, nn_cplmodel)
1034     
1035      IF(ln_usecplmask) THEN
1036         xcplmask(:,:,:) = 0.
1037         CALL iom_open( 'cplmask', inum )
1038         CALL iom_get( inum, jpdom_unknown, 'cplmask', xcplmask(1:nlci,1:nlcj,1:nn_cplmodel),   &
1039            &          kstart = (/ mig(1),mjg(1),1 /), kcount = (/ nlci,nlcj,nn_cplmodel /) )
1040         CALL iom_close( inum )
1041      ELSE
1042         xcplmask(:,:,:) = 1.
1043      ENDIF
1044      xcplmask(:,:,0) = 1. - SUM( xcplmask(:,:,1:nn_cplmodel), dim = 3 )
1045      !
1046   END SUBROUTINE sbc_cpl_init
1047
1048
1049   SUBROUTINE sbc_cpl_rcv( kt, k_fsbc, k_ice, Kbb, Kmm )     
1050      !!----------------------------------------------------------------------
1051      !!             ***  ROUTINE sbc_cpl_rcv  ***
1052      !!
1053      !! ** Purpose :   provide the stress over the ocean and, if no sea-ice,
1054      !!                provide the ocean heat and freshwater fluxes.
1055      !!
1056      !! ** Method  : - Receive all the atmospheric fields (stored in frcv array). called at each time step.
1057      !!                OASIS controls if there is something do receive or not. nrcvinfo contains the info
1058      !!                to know if the field was really received or not
1059      !!
1060      !!              --> If ocean stress was really received:
1061      !!
1062      !!                  - transform the received ocean stress vector from the received
1063      !!                 referential and grid into an atmosphere-ocean stress in
1064      !!                 the (i,j) ocean referencial and at the ocean velocity point.
1065      !!                    The received stress are :
1066      !!                     - defined by 3 components (if cartesian coordinate)
1067      !!                            or by 2 components (if spherical)
1068      !!                     - oriented along geographical   coordinate (if eastward-northward)
1069      !!                            or  along the local grid coordinate (if local grid)
1070      !!                     - given at U- and V-point, resp.   if received on 2 grids
1071      !!                            or at T-point               if received on 1 grid
1072      !!                    Therefore and if necessary, they are successively
1073      !!                  processed in order to obtain them
1074      !!                     first  as  2 components on the sphere
1075      !!                     second as  2 components oriented along the local grid
1076      !!                     third  as  2 components on the U,V grid
1077      !!
1078      !!              -->
1079      !!
1080      !!              - In 'ocean only' case, non solar and solar ocean heat fluxes
1081      !!             and total ocean freshwater fluxes 
1082      !!
1083      !! ** Method  :   receive all fields from the atmosphere and transform
1084      !!              them into ocean surface boundary condition fields
1085      !!
1086      !! ** Action  :   update  utau, vtau   ocean stress at U,V grid
1087      !!                        taum         wind stress module at T-point
1088      !!                        wndm         wind speed  module at T-point over free ocean or leads in presence of sea-ice
1089      !!                        qns          non solar heat fluxes including emp heat content    (ocean only case)
1090      !!                                     and the latent heat flux of solid precip. melting
1091      !!                        qsr          solar ocean heat fluxes   (ocean only case)
1092      !!                        emp          upward mass flux [evap. - precip. (- runoffs) (- calving)] (ocean only case)
1093      !!----------------------------------------------------------------------
1094      USE zdf_oce,  ONLY :   ln_zdfswm
1095      !
1096      INTEGER, INTENT(in) ::   kt          ! ocean model time step index
1097      INTEGER, INTENT(in) ::   k_fsbc      ! frequency of sbc (-> ice model) computation
1098      INTEGER, INTENT(in) ::   k_ice       ! ice management in the sbc (=0/1/2/3)
1099      INTEGER, INTENT(in) ::   Kbb, Kmm    ! ocean model time level indices
1100      !!
1101      LOGICAL  ::   llnewtx, llnewtau      ! update wind stress components and module??
1102      INTEGER  ::   ji, jj, jn             ! dummy loop indices
1103      INTEGER  ::   isec                   ! number of seconds since nit000 (assuming rdt did not change since nit000)
1104      REAL(wp) ::   zcumulneg, zcumulpos   ! temporary scalars     
1105      REAL(wp) ::   zcoef                  ! temporary scalar
1106      REAL(wp) ::   zrhoa  = 1.22          ! Air density kg/m3
1107      REAL(wp) ::   zcdrag = 1.5e-3        ! drag coefficient
1108      REAL(wp) ::   zzx, zzy               ! temporary variables
1109      REAL(wp), DIMENSION(jpi,jpj) ::   ztx, zty, zmsk, zemp, zqns, zqsr
1110      !!----------------------------------------------------------------------
1111      !
1112      IF( kt == nit000 ) THEN
1113      !   cannot be done in the init phase when we use agrif as cpl_freq requires that oasis_enddef is done
1114         ncpl_qsr_freq = cpl_freq( 'O_QsrOce' ) + cpl_freq( 'O_QsrMix' ) + cpl_freq( 'I_QsrOce' ) + cpl_freq( 'I_QsrMix' )
1115         IF( ln_dm2dc .AND. ncpl_qsr_freq /= 86400 )   &
1116            &   CALL ctl_stop( 'sbc_cpl_rcv: diurnal cycle reconstruction (ln_dm2dc) needs daily couping for solar radiation' )
1117         ncpl_qsr_freq = 86400 / ncpl_qsr_freq   ! used by top
1118      ENDIF
1119      !
1120      IF( ln_mixcpl )   zmsk(:,:) = 1. - xcplmask(:,:,0)
1121      !
1122      !                                                      ! ======================================================= !
1123      !                                                      ! Receive all the atmos. fields (including ice information)
1124      !                                                      ! ======================================================= !
1125      isec = ( kt - nit000 ) * NINT( rdt )                      ! date of exchanges
1126      DO jn = 1, jprcv                                          ! received fields sent by the atmosphere
1127         IF( srcv(jn)%laction )   CALL cpl_rcv( jn, isec, frcv(jn)%z3, xcplmask(:,:,1:nn_cplmodel), nrcvinfo(jn) )
1128      END DO
1129
1130      !                                                      ! ========================= !
1131      IF( srcv(jpr_otx1)%laction ) THEN                      !  ocean stress components  !
1132         !                                                   ! ========================= !
1133         ! define frcv(jpr_otx1)%z3(:,:,1) and frcv(jpr_oty1)%z3(:,:,1): stress at U/V point along model grid
1134         ! => need to be done only when we receive the field
1135         IF(  nrcvinfo(jpr_otx1) == OASIS_Rcv ) THEN
1136            !
1137            IF( TRIM( sn_rcv_tau%clvref ) == 'cartesian' ) THEN            ! 2 components on the sphere
1138               !                                                       ! (cartesian to spherical -> 3 to 2 components)
1139               !
1140               CALL geo2oce( frcv(jpr_otx1)%z3(:,:,1), frcv(jpr_oty1)%z3(:,:,1), frcv(jpr_otz1)%z3(:,:,1),   &
1141                  &          srcv(jpr_otx1)%clgrid, ztx, zty )
1142               frcv(jpr_otx1)%z3(:,:,1) = ztx(:,:)   ! overwrite 1st comp. on the 1st grid
1143               frcv(jpr_oty1)%z3(:,:,1) = zty(:,:)   ! overwrite 2nd comp. on the 1st grid
1144               !
1145               IF( srcv(jpr_otx2)%laction ) THEN
1146                  CALL geo2oce( frcv(jpr_otx2)%z3(:,:,1), frcv(jpr_oty2)%z3(:,:,1), frcv(jpr_otz2)%z3(:,:,1),   &
1147                     &          srcv(jpr_otx2)%clgrid, ztx, zty )
1148                  frcv(jpr_otx2)%z3(:,:,1) = ztx(:,:)   ! overwrite 1st comp. on the 2nd grid
1149                  frcv(jpr_oty2)%z3(:,:,1) = zty(:,:)   ! overwrite 2nd comp. on the 2nd grid
1150               ENDIF
1151               !
1152            ENDIF
1153            !
1154            IF( TRIM( sn_rcv_tau%clvor ) == 'eastward-northward' ) THEN   ! 2 components oriented along the local grid
1155               !                                                       ! (geographical to local grid -> rotate the components)
1156               CALL rot_rep( frcv(jpr_otx1)%z3(:,:,1), frcv(jpr_oty1)%z3(:,:,1), srcv(jpr_otx1)%clgrid, 'en->i', ztx )   
1157               IF( srcv(jpr_otx2)%laction ) THEN
1158                  CALL rot_rep( frcv(jpr_otx2)%z3(:,:,1), frcv(jpr_oty2)%z3(:,:,1), srcv(jpr_otx2)%clgrid, 'en->j', zty )   
1159               ELSE
1160                  CALL rot_rep( frcv(jpr_otx1)%z3(:,:,1), frcv(jpr_oty1)%z3(:,:,1), srcv(jpr_otx1)%clgrid, 'en->j', zty ) 
1161               ENDIF
1162               frcv(jpr_otx1)%z3(:,:,1) = ztx(:,:)      ! overwrite 1st component on the 1st grid
1163               frcv(jpr_oty1)%z3(:,:,1) = zty(:,:)      ! overwrite 2nd component on the 2nd grid
1164            ENDIF
1165            !                             
1166            IF( srcv(jpr_otx1)%clgrid == 'T' ) THEN
1167               DO jj = 2, jpjm1                                          ! T ==> (U,V)
1168                  DO ji = fs_2, fs_jpim1   ! vector opt.
1169                     frcv(jpr_otx1)%z3(ji,jj,1) = 0.5 * ( frcv(jpr_otx1)%z3(ji+1,jj  ,1) + frcv(jpr_otx1)%z3(ji,jj,1) )
1170                     frcv(jpr_oty1)%z3(ji,jj,1) = 0.5 * ( frcv(jpr_oty1)%z3(ji  ,jj+1,1) + frcv(jpr_oty1)%z3(ji,jj,1) )
1171                  END DO
1172               END DO
1173               CALL lbc_lnk_multi( 'sbccpl', frcv(jpr_otx1)%z3(:,:,1), 'U',  -1., frcv(jpr_oty1)%z3(:,:,1), 'V',  -1. )
1174            ENDIF
1175            llnewtx = .TRUE.
1176         ELSE
1177            llnewtx = .FALSE.
1178         ENDIF
1179         !                                                   ! ========================= !
1180      ELSE                                                   !   No dynamical coupling   !
1181         !                                                   ! ========================= !
1182         frcv(jpr_otx1)%z3(:,:,1) = 0.e0                               ! here simply set to zero
1183         frcv(jpr_oty1)%z3(:,:,1) = 0.e0                               ! an external read in a file can be added instead
1184         llnewtx = .TRUE.
1185         !
1186      ENDIF
1187      !                                                      ! ========================= !
1188      !                                                      !    wind stress module     !   (taum)
1189      !                                                      ! ========================= !
1190      IF( .NOT. srcv(jpr_taum)%laction ) THEN                    ! compute wind stress module from its components if not received
1191         ! => need to be done only when otx1 was changed
1192         IF( llnewtx ) THEN
1193            DO jj = 2, jpjm1
1194               DO ji = fs_2, fs_jpim1   ! vect. opt.
1195                  zzx = frcv(jpr_otx1)%z3(ji-1,jj  ,1) + frcv(jpr_otx1)%z3(ji,jj,1)
1196                  zzy = frcv(jpr_oty1)%z3(ji  ,jj-1,1) + frcv(jpr_oty1)%z3(ji,jj,1)
1197                  frcv(jpr_taum)%z3(ji,jj,1) = 0.5 * SQRT( zzx * zzx + zzy * zzy )
1198               END DO
1199            END DO
1200            CALL lbc_lnk( 'sbccpl', frcv(jpr_taum)%z3(:,:,1), 'T', 1. )
1201            llnewtau = .TRUE.
1202         ELSE
1203            llnewtau = .FALSE.
1204         ENDIF
1205      ELSE
1206         llnewtau = nrcvinfo(jpr_taum) == OASIS_Rcv
1207         ! Stress module can be negative when received (interpolation problem)
1208         IF( llnewtau ) THEN
1209            frcv(jpr_taum)%z3(:,:,1) = MAX( 0._wp, frcv(jpr_taum)%z3(:,:,1) )
1210         ENDIF
1211      ENDIF
1212      !
1213      !                                                      ! ========================= !
1214      !                                                      !      10 m wind speed      !   (wndm)
1215      !                                                      ! ========================= !
1216      IF( .NOT. srcv(jpr_w10m)%laction ) THEN                    ! compute wind spreed from wind stress module if not received 
1217         ! => need to be done only when taumod was changed
1218         IF( llnewtau ) THEN
1219            zcoef = 1. / ( zrhoa * zcdrag ) 
1220            DO jj = 1, jpj
1221               DO ji = 1, jpi 
1222                  frcv(jpr_w10m)%z3(ji,jj,1) = SQRT( frcv(jpr_taum)%z3(ji,jj,1) * zcoef )
1223               END DO
1224            END DO
1225         ENDIF
1226      ENDIF
1227
1228      ! u(v)tau and taum will be modified by ice model
1229      ! -> need to be reset before each call of the ice/fsbc     
1230      IF( MOD( kt-1, k_fsbc ) == 0 ) THEN
1231         !
1232         IF( ln_mixcpl ) THEN
1233            utau(:,:) = utau(:,:) * xcplmask(:,:,0) + frcv(jpr_otx1)%z3(:,:,1) * zmsk(:,:)
1234            vtau(:,:) = vtau(:,:) * xcplmask(:,:,0) + frcv(jpr_oty1)%z3(:,:,1) * zmsk(:,:)
1235            taum(:,:) = taum(:,:) * xcplmask(:,:,0) + frcv(jpr_taum)%z3(:,:,1) * zmsk(:,:)
1236            wndm(:,:) = wndm(:,:) * xcplmask(:,:,0) + frcv(jpr_w10m)%z3(:,:,1) * zmsk(:,:)
1237         ELSE
1238            utau(:,:) = frcv(jpr_otx1)%z3(:,:,1)
1239            vtau(:,:) = frcv(jpr_oty1)%z3(:,:,1)
1240            taum(:,:) = frcv(jpr_taum)%z3(:,:,1)
1241            wndm(:,:) = frcv(jpr_w10m)%z3(:,:,1)
1242         ENDIF
1243         CALL iom_put( "taum_oce", taum )   ! output wind stress module
1244         
1245      ENDIF
1246
1247      !                                                      ! ================== !
1248      !                                                      ! atmosph. CO2 (ppm) !
1249      !                                                      ! ================== !
1250      IF( srcv(jpr_co2)%laction )   atm_co2(:,:) = frcv(jpr_co2)%z3(:,:,1)
1251      !
1252      !                                                      ! ========================= !
1253      !                                                      ! Mean Sea Level Pressure   !   (taum)
1254      !                                                      ! ========================= !
1255      IF( srcv(jpr_mslp)%laction ) THEN                    ! UKMO SHELF effect of atmospheric pressure on SSH
1256          IF( kt /= nit000 )   ssh_ibb(:,:) = ssh_ib(:,:)    !* Swap of ssh_ib fields
1257
1258          r1_grau = 1.e0 / (grav * rau0)               !* constant for optimization
1259          ssh_ib(:,:) = - ( frcv(jpr_mslp)%z3(:,:,1) - rpref ) * r1_grau    ! equivalent ssh (inverse barometer)
1260          apr   (:,:) =     frcv(jpr_mslp)%z3(:,:,1)                         !atmospheric pressure
1261   
1262          IF( kt == nit000 ) ssh_ibb(:,:) = ssh_ib(:,:)  ! correct this later (read from restart if possible)
1263      ENDIF 
1264      !
1265      IF( ln_sdw ) THEN  ! Stokes Drift correction activated
1266      !                                                      ! ========================= !
1267      !                                                      !       Stokes drift u      !
1268      !                                                      ! ========================= !
1269         IF( srcv(jpr_sdrftx)%laction ) ut0sd(:,:) = frcv(jpr_sdrftx)%z3(:,:,1)
1270      !
1271      !                                                      ! ========================= !
1272      !                                                      !       Stokes drift v      !
1273      !                                                      ! ========================= !
1274         IF( srcv(jpr_sdrfty)%laction ) vt0sd(:,:) = frcv(jpr_sdrfty)%z3(:,:,1)
1275      !
1276      !                                                      ! ========================= !
1277      !                                                      !      Wave mean period     !
1278      !                                                      ! ========================= !
1279         IF( srcv(jpr_wper)%laction ) wmp(:,:) = frcv(jpr_wper)%z3(:,:,1)
1280      !
1281      !                                                      ! ========================= !
1282      !                                                      !  Significant wave height  !
1283      !                                                      ! ========================= !
1284         IF( srcv(jpr_hsig)%laction ) hsw(:,:) = frcv(jpr_hsig)%z3(:,:,1)
1285      !
1286      !                                                      ! ========================= ! 
1287      !                                                      !    Wave peak frequency    !
1288      !                                                      ! ========================= ! 
1289         IF( srcv(jpr_wfreq)%laction ) wfreq(:,:) = frcv(jpr_wfreq)%z3(:,:,1)
1290      !
1291      !                                                      ! ========================= !
1292      !                                                      !    Vertical mixing Qiao   !
1293      !                                                      ! ========================= !
1294         IF( srcv(jpr_wnum)%laction .AND. ln_zdfswm ) wnum(:,:) = frcv(jpr_wnum)%z3(:,:,1)
1295
1296         ! Calculate the 3D Stokes drift both in coupled and not fully uncoupled mode
1297         IF( srcv(jpr_sdrftx)%laction .OR. srcv(jpr_sdrfty)%laction .OR. srcv(jpr_wper)%laction &
1298                                      .OR. srcv(jpr_hsig)%laction   .OR. srcv(jpr_wfreq)%laction) THEN
1299            CALL sbc_stokes( Kmm )
1300         ENDIF
1301      ENDIF
1302      !                                                      ! ========================= !
1303      !                                                      ! Stress adsorbed by waves  !
1304      !                                                      ! ========================= !
1305      IF( srcv(jpr_tauwoc)%laction .AND. ln_tauwoc ) tauoc_wave(:,:) = frcv(jpr_tauwoc)%z3(:,:,1)
1306
1307      !                                                      ! ========================= ! 
1308      !                                                      ! Stress component by waves !
1309      !                                                      ! ========================= ! 
1310      IF( srcv(jpr_tauwx)%laction .AND. srcv(jpr_tauwy)%laction .AND. ln_tauw ) THEN
1311         tauw_x(:,:) = frcv(jpr_tauwx)%z3(:,:,1)
1312         tauw_y(:,:) = frcv(jpr_tauwy)%z3(:,:,1)
1313      ENDIF
1314
1315      !                                                      ! ========================= !
1316      !                                                      !   Wave drag coefficient   !
1317      !                                                      ! ========================= !
1318      IF( srcv(jpr_wdrag)%laction .AND. ln_cdgw )   cdn_wave(:,:) = frcv(jpr_wdrag)%z3(:,:,1)
1319
1320      !  Fields received by SAS when OASIS coupling
1321      !  (arrays no more filled at sbcssm stage)
1322      !                                                      ! ================== !
1323      !                                                      !        SSS         !
1324      !                                                      ! ================== !
1325      IF( srcv(jpr_soce)%laction ) THEN                      ! received by sas in case of opa <-> sas coupling
1326         sss_m(:,:) = frcv(jpr_soce)%z3(:,:,1)
1327         CALL iom_put( 'sss_m', sss_m )
1328      ENDIF
1329      !                                               
1330      !                                                      ! ================== !
1331      !                                                      !        SST         !
1332      !                                                      ! ================== !
1333      IF( srcv(jpr_toce)%laction ) THEN                      ! received by sas in case of opa <-> sas coupling
1334         sst_m(:,:) = frcv(jpr_toce)%z3(:,:,1)
1335         IF( srcv(jpr_soce)%laction .AND. l_useCT ) THEN    ! make sure that sst_m is the potential temperature
1336            sst_m(:,:) = eos_pt_from_ct( sst_m(:,:), sss_m(:,:) )
1337         ENDIF
1338      ENDIF
1339      !                                                      ! ================== !
1340      !                                                      !        SSH         !
1341      !                                                      ! ================== !
1342      IF( srcv(jpr_ssh )%laction ) THEN                      ! received by sas in case of opa <-> sas coupling
1343         ssh_m(:,:) = frcv(jpr_ssh )%z3(:,:,1)
1344         CALL iom_put( 'ssh_m', ssh_m )
1345      ENDIF
1346      !                                                      ! ================== !
1347      !                                                      !  surface currents  !
1348      !                                                      ! ================== !
1349      IF( srcv(jpr_ocx1)%laction ) THEN                      ! received by sas in case of opa <-> sas coupling
1350         ssu_m(:,:) = frcv(jpr_ocx1)%z3(:,:,1)
1351         uu(:,:,1,Kbb) = ssu_m(:,:)                          ! will be used in icestp in the call of ice_forcing_tau
1352         uu(:,:,1,Kmm) = ssu_m(:,:)                          ! will be used in sbc_cpl_snd if atmosphere coupling
1353         CALL iom_put( 'ssu_m', ssu_m )
1354      ENDIF
1355      IF( srcv(jpr_ocy1)%laction ) THEN
1356         ssv_m(:,:) = frcv(jpr_ocy1)%z3(:,:,1)
1357         vv(:,:,1,Kbb) = ssv_m(:,:)                          ! will be used in icestp in the call of ice_forcing_tau
1358         vv(:,:,1,Kmm) = ssv_m(:,:)                          ! will be used in sbc_cpl_snd if atmosphere coupling
1359         CALL iom_put( 'ssv_m', ssv_m )
1360      ENDIF
1361      !                                                      ! ======================== !
1362      !                                                      !  first T level thickness !
1363      !                                                      ! ======================== !
1364      IF( srcv(jpr_e3t1st )%laction ) THEN                   ! received by sas in case of opa <-> sas coupling
1365         e3t_m(:,:) = frcv(jpr_e3t1st )%z3(:,:,1)
1366         CALL iom_put( 'e3t_m', e3t_m(:,:) )
1367      ENDIF
1368      !                                                      ! ================================ !
1369      !                                                      !  fraction of solar net radiation !
1370      !                                                      ! ================================ !
1371      IF( srcv(jpr_fraqsr)%laction ) THEN                    ! received by sas in case of opa <-> sas coupling
1372         frq_m(:,:) = frcv(jpr_fraqsr)%z3(:,:,1)
1373         CALL iom_put( 'frq_m', frq_m )
1374      ENDIF
1375     
1376      !                                                      ! ========================= !
1377      IF( k_ice <= 1 .AND. MOD( kt-1, k_fsbc ) == 0 ) THEN   !  heat & freshwater fluxes ! (Ocean only case)
1378         !                                                   ! ========================= !
1379         !
1380         !                                                       ! total freshwater fluxes over the ocean (emp)
1381         IF( srcv(jpr_oemp)%laction .OR. srcv(jpr_rain)%laction ) THEN
1382            SELECT CASE( TRIM( sn_rcv_emp%cldes ) )                                    ! evaporation - precipitation
1383            CASE( 'conservative' )
1384               zemp(:,:) = frcv(jpr_tevp)%z3(:,:,1) - ( frcv(jpr_rain)%z3(:,:,1) + frcv(jpr_snow)%z3(:,:,1) )
1385            CASE( 'oce only', 'oce and ice' )
1386               zemp(:,:) = frcv(jpr_oemp)%z3(:,:,1)
1387            CASE default
1388               CALL ctl_stop( 'sbc_cpl_rcv: wrong definition of sn_rcv_emp%cldes' )
1389            END SELECT
1390         ELSE
1391            zemp(:,:) = 0._wp
1392         ENDIF
1393         !
1394         !                                                        ! runoffs and calving (added in emp)
1395         IF( srcv(jpr_rnf)%laction )     rnf(:,:) = frcv(jpr_rnf)%z3(:,:,1)
1396         IF( srcv(jpr_cal)%laction )     zemp(:,:) = zemp(:,:) - frcv(jpr_cal)%z3(:,:,1)
1397 
1398         IF( srcv(jpr_icb)%laction )  THEN
1399             fwficb(:,:) = frcv(jpr_icb)%z3(:,:,1)
1400             rnf(:,:)    = rnf(:,:) + fwficb(:,:)   ! iceberg added to runfofs
1401         ENDIF
1402         !
1403         ! ice shelf fwf
1404         IF( srcv(jpr_isf)%laction )  THEN
1405            fwfisf_oasis(:,:) = - frcv(jpr_isf)%z3(:,:,1)  ! fresh water flux from the isf (fwfisf <0 mean melting) 
1406         END IF
1407       
1408         IF( ln_mixcpl ) THEN   ;   emp(:,:) = emp(:,:) * xcplmask(:,:,0) + zemp(:,:) * zmsk(:,:)
1409         ELSE                   ;   emp(:,:) =                              zemp(:,:)
1410         ENDIF
1411         !
1412         !                                                       ! non solar heat flux over the ocean (qns)
1413         IF(      srcv(jpr_qnsoce)%laction ) THEN   ;   zqns(:,:) = frcv(jpr_qnsoce)%z3(:,:,1)
1414         ELSE IF( srcv(jpr_qnsmix)%laction ) THEN   ;   zqns(:,:) = frcv(jpr_qnsmix)%z3(:,:,1)
1415         ELSE                                       ;   zqns(:,:) = 0._wp
1416         ENDIF
1417         ! update qns over the free ocean with:
1418         IF( nn_components /= jp_iam_opa ) THEN
1419            zqns(:,:) =  zqns(:,:) - zemp(:,:) * sst_m(:,:) * rcp         ! remove heat content due to mass flux (assumed to be at SST)
1420            IF( srcv(jpr_snow  )%laction ) THEN
1421               zqns(:,:) = zqns(:,:) - frcv(jpr_snow)%z3(:,:,1) * rLfus   ! energy for melting solid precipitation over the free ocean
1422            ENDIF
1423         ENDIF
1424         !
1425         IF( srcv(jpr_icb)%laction )  zqns(:,:) = zqns(:,:) - frcv(jpr_icb)%z3(:,:,1) * rLfus ! remove heat content associated to iceberg melting
1426         !
1427         IF( ln_mixcpl ) THEN   ;   qns(:,:) = qns(:,:) * xcplmask(:,:,0) + zqns(:,:) * zmsk(:,:)
1428         ELSE                   ;   qns(:,:) =                              zqns(:,:)
1429         ENDIF
1430
1431         !                                                       ! solar flux over the ocean          (qsr)
1432         IF     ( srcv(jpr_qsroce)%laction ) THEN   ;   zqsr(:,:) = frcv(jpr_qsroce)%z3(:,:,1)
1433         ELSE IF( srcv(jpr_qsrmix)%laction ) then   ;   zqsr(:,:) = frcv(jpr_qsrmix)%z3(:,:,1)
1434         ELSE                                       ;   zqsr(:,:) = 0._wp
1435         ENDIF
1436         IF( ln_dm2dc .AND. ln_cpl )   zqsr(:,:) = sbc_dcy( zqsr )   ! modify qsr to include the diurnal cycle
1437         IF( ln_mixcpl ) THEN   ;   qsr(:,:) = qsr(:,:) * xcplmask(:,:,0) + zqsr(:,:) * zmsk(:,:)
1438         ELSE                   ;   qsr(:,:) =                              zqsr(:,:)
1439         ENDIF
1440         !
1441         ! salt flux over the ocean (received by opa in case of opa <-> sas coupling)
1442         IF( srcv(jpr_sflx )%laction )   sfx(:,:) = frcv(jpr_sflx  )%z3(:,:,1)
1443         ! Ice cover  (received by opa in case of opa <-> sas coupling)
1444         IF( srcv(jpr_fice )%laction )   fr_i(:,:) = frcv(jpr_fice )%z3(:,:,1)
1445         !
1446      ENDIF
1447      !
1448   END SUBROUTINE sbc_cpl_rcv
1449   
1450
1451   SUBROUTINE sbc_cpl_ice_tau( p_taui, p_tauj )     
1452      !!----------------------------------------------------------------------
1453      !!             ***  ROUTINE sbc_cpl_ice_tau  ***
1454      !!
1455      !! ** Purpose :   provide the stress over sea-ice in coupled mode
1456      !!
1457      !! ** Method  :   transform the received stress from the atmosphere into
1458      !!             an atmosphere-ice stress in the (i,j) ocean referencial
1459      !!             and at the velocity point of the sea-ice model:
1460      !!                'C'-grid : i- (j-) components given at U- (V-) point
1461      !!
1462      !!                The received stress are :
1463      !!                 - defined by 3 components (if cartesian coordinate)
1464      !!                        or by 2 components (if spherical)
1465      !!                 - oriented along geographical   coordinate (if eastward-northward)
1466      !!                        or  along the local grid coordinate (if local grid)
1467      !!                 - given at U- and V-point, resp.   if received on 2 grids
1468      !!                        or at a same point (T or I) if received on 1 grid
1469      !!                Therefore and if necessary, they are successively
1470      !!             processed in order to obtain them
1471      !!                 first  as  2 components on the sphere
1472      !!                 second as  2 components oriented along the local grid
1473      !!                 third  as  2 components on the ice grid point
1474      !!
1475      !!                Except in 'oce and ice' case, only one vector stress field
1476      !!             is received. It has already been processed in sbc_cpl_rcv
1477      !!             so that it is now defined as (i,j) components given at U-
1478      !!             and V-points, respectively. 
1479      !!
1480      !! ** Action  :   return ptau_i, ptau_j, the stress over the ice
1481      !!----------------------------------------------------------------------
1482      REAL(wp), INTENT(out), DIMENSION(:,:) ::   p_taui   ! i- & j-components of atmos-ice stress [N/m2]
1483      REAL(wp), INTENT(out), DIMENSION(:,:) ::   p_tauj   ! at I-point (B-grid) or U & V-point (C-grid)
1484      !!
1485      INTEGER ::   ji, jj   ! dummy loop indices
1486      INTEGER ::   itx      ! index of taux over ice
1487      REAL(wp), DIMENSION(jpi,jpj) ::   ztx, zty 
1488      !!----------------------------------------------------------------------
1489      !
1490      IF( srcv(jpr_itx1)%laction ) THEN   ;   itx =  jpr_itx1   
1491      ELSE                                ;   itx =  jpr_otx1
1492      ENDIF
1493
1494      ! do something only if we just received the stress from atmosphere
1495      IF(  nrcvinfo(itx) == OASIS_Rcv ) THEN
1496         !                                                      ! ======================= !
1497         IF( srcv(jpr_itx1)%laction ) THEN                      !   ice stress received   !
1498            !                                                   ! ======================= !
1499           
1500            IF( TRIM( sn_rcv_tau%clvref ) == 'cartesian' ) THEN            ! 2 components on the sphere
1501               !                                                       ! (cartesian to spherical -> 3 to 2 components)
1502               CALL geo2oce(  frcv(jpr_itx1)%z3(:,:,1), frcv(jpr_ity1)%z3(:,:,1), frcv(jpr_itz1)%z3(:,:,1),   &
1503                  &          srcv(jpr_itx1)%clgrid, ztx, zty )
1504               frcv(jpr_itx1)%z3(:,:,1) = ztx(:,:)   ! overwrite 1st comp. on the 1st grid
1505               frcv(jpr_ity1)%z3(:,:,1) = zty(:,:)   ! overwrite 2nd comp. on the 1st grid
1506               !
1507               IF( srcv(jpr_itx2)%laction ) THEN
1508                  CALL geo2oce( frcv(jpr_itx2)%z3(:,:,1), frcv(jpr_ity2)%z3(:,:,1), frcv(jpr_itz2)%z3(:,:,1),   &
1509                     &          srcv(jpr_itx2)%clgrid, ztx, zty )
1510                  frcv(jpr_itx2)%z3(:,:,1) = ztx(:,:)   ! overwrite 1st comp. on the 2nd grid
1511                  frcv(jpr_ity2)%z3(:,:,1) = zty(:,:)   ! overwrite 2nd comp. on the 2nd grid
1512               ENDIF
1513               !
1514            ENDIF
1515            !
1516            IF( TRIM( sn_rcv_tau%clvor ) == 'eastward-northward' ) THEN   ! 2 components oriented along the local grid
1517               !                                                       ! (geographical to local grid -> rotate the components)
1518               CALL rot_rep( frcv(jpr_itx1)%z3(:,:,1), frcv(jpr_ity1)%z3(:,:,1), srcv(jpr_itx1)%clgrid, 'en->i', ztx )   
1519               IF( srcv(jpr_itx2)%laction ) THEN
1520                  CALL rot_rep( frcv(jpr_itx2)%z3(:,:,1), frcv(jpr_ity2)%z3(:,:,1), srcv(jpr_itx2)%clgrid, 'en->j', zty )   
1521               ELSE
1522                  CALL rot_rep( frcv(jpr_itx1)%z3(:,:,1), frcv(jpr_ity1)%z3(:,:,1), srcv(jpr_itx1)%clgrid, 'en->j', zty ) 
1523               ENDIF
1524               frcv(jpr_itx1)%z3(:,:,1) = ztx(:,:)      ! overwrite 1st component on the 1st grid
1525               frcv(jpr_ity1)%z3(:,:,1) = zty(:,:)      ! overwrite 2nd component on the 1st grid
1526            ENDIF
1527            !                                                   ! ======================= !
1528         ELSE                                                   !     use ocean stress    !
1529            !                                                   ! ======================= !
1530            frcv(jpr_itx1)%z3(:,:,1) = frcv(jpr_otx1)%z3(:,:,1)
1531            frcv(jpr_ity1)%z3(:,:,1) = frcv(jpr_oty1)%z3(:,:,1)
1532            !
1533         ENDIF
1534         !                                                      ! ======================= !
1535         !                                                      !     put on ice grid     !
1536         !                                                      ! ======================= !
1537         !   
1538         !                                                  j+1   j     -----V---F
1539         ! ice stress on ice velocity point                              !       |
1540         ! (C-grid ==>(U,V))                                      j      |   T   U
1541         !                                                               |       |
1542         !                                                   j    j-1   -I-------|
1543         !                                               (for I)         |       |
1544         !                                                              i-1  i   i
1545         !                                                               i      i+1 (for I)
1546         SELECT CASE ( srcv(jpr_itx1)%clgrid )
1547         CASE( 'U' )
1548            p_taui(:,:) = frcv(jpr_itx1)%z3(:,:,1)                   ! (U,V) ==> (U,V)
1549            p_tauj(:,:) = frcv(jpr_ity1)%z3(:,:,1)
1550         CASE( 'F' )
1551            DO jj = 2, jpjm1                                   ! F ==> (U,V)
1552               DO ji = fs_2, fs_jpim1   ! vector opt.
1553                  p_taui(ji,jj) = 0.5 * ( frcv(jpr_itx1)%z3(ji,jj,1) + frcv(jpr_itx1)%z3(ji  ,jj-1,1) )
1554                  p_tauj(ji,jj) = 0.5 * ( frcv(jpr_ity1)%z3(ji,jj,1) + frcv(jpr_ity1)%z3(ji-1,jj  ,1) )
1555               END DO
1556            END DO
1557         CASE( 'T' )
1558            DO jj = 2, jpjm1                                   ! T ==> (U,V)
1559               DO ji = fs_2, fs_jpim1   ! vector opt.
1560                  p_taui(ji,jj) = 0.5 * ( frcv(jpr_itx1)%z3(ji+1,jj  ,1) + frcv(jpr_itx1)%z3(ji,jj,1) )
1561                  p_tauj(ji,jj) = 0.5 * ( frcv(jpr_ity1)%z3(ji  ,jj+1,1) + frcv(jpr_ity1)%z3(ji,jj,1) )
1562               END DO
1563            END DO
1564         CASE( 'I' )
1565            DO jj = 2, jpjm1                                   ! I ==> (U,V)
1566               DO ji = 2, jpim1   ! NO vector opt.
1567                  p_taui(ji,jj) = 0.5 * ( frcv(jpr_itx1)%z3(ji+1,jj+1,1) + frcv(jpr_itx1)%z3(ji+1,jj  ,1) )
1568                  p_tauj(ji,jj) = 0.5 * ( frcv(jpr_ity1)%z3(ji+1,jj+1,1) + frcv(jpr_ity1)%z3(ji  ,jj+1,1) )
1569               END DO
1570            END DO
1571         END SELECT
1572         IF( srcv(jpr_itx1)%clgrid /= 'U' ) THEN
1573            CALL lbc_lnk_multi( 'sbccpl', p_taui, 'U',  -1., p_tauj, 'V',  -1. )
1574         ENDIF
1575         
1576      ENDIF
1577      !
1578   END SUBROUTINE sbc_cpl_ice_tau
1579   
1580
1581   SUBROUTINE sbc_cpl_ice_flx( picefr, palbi, psst, pist, phs, phi )
1582      !!----------------------------------------------------------------------
1583      !!             ***  ROUTINE sbc_cpl_ice_flx  ***
1584      !!
1585      !! ** Purpose :   provide the heat and freshwater fluxes of the ocean-ice system
1586      !!
1587      !! ** Method  :   transform the fields received from the atmosphere into
1588      !!             surface heat and fresh water boundary condition for the
1589      !!             ice-ocean system. The following fields are provided:
1590      !!               * total non solar, solar and freshwater fluxes (qns_tot,
1591      !!             qsr_tot and emp_tot) (total means weighted ice-ocean flux)
1592      !!             NB: emp_tot include runoffs and calving.
1593      !!               * fluxes over ice (qns_ice, qsr_ice, emp_ice) where
1594      !!             emp_ice = sublimation - solid precipitation as liquid
1595      !!             precipitation are re-routed directly to the ocean and
1596      !!             calving directly enter the ocean (runoffs are read but included in trasbc.F90)
1597      !!               * solid precipitation (sprecip), used to add to qns_tot
1598      !!             the heat lost associated to melting solid precipitation
1599      !!             over the ocean fraction.
1600      !!               * heat content of rain, snow and evap can also be provided,
1601      !!             otherwise heat flux associated with these mass flux are
1602      !!             guessed (qemp_oce, qemp_ice)
1603      !!
1604      !!             - the fluxes have been separated from the stress as
1605      !!               (a) they are updated at each ice time step compare to
1606      !!               an update at each coupled time step for the stress, and
1607      !!               (b) the conservative computation of the fluxes over the
1608      !!               sea-ice area requires the knowledge of the ice fraction
1609      !!               after the ice advection and before the ice thermodynamics,
1610      !!               so that the stress is updated before the ice dynamics
1611      !!               while the fluxes are updated after it.
1612      !!
1613      !! ** Details
1614      !!             qns_tot = (1-a) * qns_oce + a * qns_ice               => provided
1615      !!                     + qemp_oce + qemp_ice                         => recalculated and added up to qns
1616      !!
1617      !!             qsr_tot = (1-a) * qsr_oce + a * qsr_ice               => provided
1618      !!
1619      !!             emp_tot = emp_oce + emp_ice                           => calving is provided and added to emp_tot (and emp_oce).
1620      !!                                                                      runoff (which includes rivers+icebergs) and iceshelf
1621      !!                                                                      are provided but not included in emp here. Only runoff will
1622      !!                                                                      be included in emp in other parts of NEMO code
1623      !! ** Action  :   update at each nf_ice time step:
1624      !!                   qns_tot, qsr_tot  non-solar and solar total heat fluxes
1625      !!                   qns_ice, qsr_ice  non-solar and solar heat fluxes over the ice
1626      !!                   emp_tot           total evaporation - precipitation(liquid and solid) (-calving)
1627      !!                   emp_ice           ice sublimation - solid precipitation over the ice
1628      !!                   dqns_ice          d(non-solar heat flux)/d(Temperature) over the ice
1629      !!                   sprecip           solid precipitation over the ocean 
1630      !!----------------------------------------------------------------------
1631      REAL(wp), INTENT(in)   , DIMENSION(:,:)             ::   picefr     ! ice fraction                [0 to 1]
1632      !                                                   !!           ! optional arguments, used only in 'mixed oce-ice' case or for Met-Office coupling
1633      REAL(wp), INTENT(in)   , DIMENSION(:,:,:), OPTIONAL ::   palbi      ! all skies ice albedo
1634      REAL(wp), INTENT(in)   , DIMENSION(:,:  ), OPTIONAL ::   psst       ! sea surface temperature     [Celsius]
1635      REAL(wp), INTENT(inout), DIMENSION(:,:,:), OPTIONAL ::   pist       ! ice surface temperature     [Kelvin] => inout for Met-Office
1636      REAL(wp), INTENT(in)   , DIMENSION(:,:,:), OPTIONAL ::   phs        ! snow depth                  [m]
1637      REAL(wp), INTENT(in)   , DIMENSION(:,:,:), OPTIONAL ::   phi        ! ice thickness               [m]
1638      !
1639      INTEGER  ::   ji, jj, jl   ! dummy loop index
1640      REAL(wp) ::   ztri         ! local scalar
1641      REAL(wp), DIMENSION(jpi,jpj)     ::   zcptn, zcptrain, zcptsnw, ziceld, zmsk, zsnw
1642      REAL(wp), DIMENSION(jpi,jpj)     ::   zemp_tot, zemp_ice, zemp_oce, ztprecip, zsprecip  , zevap_oce, zdevap_ice
1643      REAL(wp), DIMENSION(jpi,jpj)     ::   zqns_tot, zqns_oce, zqsr_tot, zqsr_oce, zqprec_ice, zqemp_oce, zqemp_ice
1644      REAL(wp), DIMENSION(jpi,jpj,jpl) ::   zqns_ice, zqsr_ice, zdqns_ice, zqevap_ice, zevap_ice, zqtr_ice_top, ztsu
1645      !!----------------------------------------------------------------------
1646      !
1647      IF( ln_mixcpl )   zmsk(:,:) = 1. - xcplmask(:,:,0)
1648      ziceld(:,:) = 1._wp - picefr(:,:)
1649      zcptn (:,:) = rcp * sst_m(:,:)
1650      !
1651      !                                                      ! ========================= !
1652      !                                                      !    freshwater budget      !   (emp_tot)
1653      !                                                      ! ========================= !
1654      !
1655      !                                                           ! solid Precipitation                                (sprecip)
1656      !                                                           ! liquid + solid Precipitation                       (tprecip)
1657      !                                                           ! total Evaporation - total Precipitation            (emp_tot)
1658      !                                                           ! sublimation - solid precipitation (cell average)   (emp_ice)
1659      SELECT CASE( TRIM( sn_rcv_emp%cldes ) )
1660      CASE( 'conservative' )   ! received fields: jpr_rain, jpr_snow, jpr_ievp, jpr_tevp
1661         zsprecip(:,:) =   frcv(jpr_snow)%z3(:,:,1)                  ! May need to ensure positive here
1662         ztprecip(:,:) =   frcv(jpr_rain)%z3(:,:,1) + zsprecip(:,:)  ! May need to ensure positive here
1663         zemp_tot(:,:) =   frcv(jpr_tevp)%z3(:,:,1) - ztprecip(:,:)
1664         zemp_ice(:,:) = ( frcv(jpr_ievp)%z3(:,:,1) - frcv(jpr_snow)%z3(:,:,1) ) * picefr(:,:)
1665      CASE( 'oce and ice'   )   ! received fields: jpr_sbpr, jpr_semp, jpr_oemp, jpr_ievp
1666         zemp_tot(:,:) = ziceld(:,:) * frcv(jpr_oemp)%z3(:,:,1) + picefr(:,:) * frcv(jpr_sbpr)%z3(:,:,1)
1667         zemp_ice(:,:) = frcv(jpr_semp)%z3(:,:,1) * picefr(:,:)
1668         zsprecip(:,:) = frcv(jpr_ievp)%z3(:,:,1) - frcv(jpr_semp)%z3(:,:,1)
1669         ztprecip(:,:) = frcv(jpr_semp)%z3(:,:,1) - frcv(jpr_sbpr)%z3(:,:,1) + zsprecip(:,:)
1670      CASE( 'none'      )       ! Not available as for now: needs additional coding below when computing zevap_oce
1671      !                         ! since fields received are not defined with none option
1672         CALL ctl_stop( 'STOP', 'sbccpl/sbc_cpl_ice_flx: some fields are not defined. Change sn_rcv_emp value in namelist namsbc_cpl' )
1673      END SELECT
1674
1675#if defined key_si3
1676      ! zsnw = snow fraction over ice after wind blowing (=picefr if no blowing)
1677      zsnw(:,:) = 0._wp   ;   CALL ice_thd_snwblow( ziceld, zsnw )
1678     
1679      ! --- evaporation minus precipitation corrected (because of wind blowing on snow) --- !
1680      zemp_ice(:,:) = zemp_ice(:,:) + zsprecip(:,:) * ( picefr(:,:) - zsnw(:,:) )  ! emp_ice = A * sublimation - zsnw * sprecip
1681      zemp_oce(:,:) = zemp_tot(:,:) - zemp_ice(:,:)                                ! emp_oce = emp_tot - emp_ice
1682
1683      ! --- evaporation over ocean (used later for qemp) --- !
1684      zevap_oce(:,:) = frcv(jpr_tevp)%z3(:,:,1) - frcv(jpr_ievp)%z3(:,:,1) * picefr(:,:)
1685
1686      ! --- evaporation over ice (kg/m2/s) --- !
1687      DO jl=1,jpl
1688         IF(sn_rcv_emp%clcat == 'yes') THEN   ;   zevap_ice(:,:,jl) = frcv(jpr_ievp)%z3(:,:,jl)
1689         ELSE                                  ;   zevap_ice(:,:,jl) = frcv(jpr_ievp)%z3(:,:,1 )   ;   ENDIF
1690      ENDDO
1691
1692      ! since the sensitivity of evap to temperature (devap/dT) is not prescribed by the atmosphere, we set it to 0
1693      ! therefore, sublimation is not redistributed over the ice categories when no subgrid scale fluxes are provided by atm.
1694      zdevap_ice(:,:) = 0._wp
1695     
1696      ! --- Continental fluxes --- !
1697      IF( srcv(jpr_rnf)%laction ) THEN   ! runoffs (included in emp later on)
1698         rnf(:,:) = frcv(jpr_rnf)%z3(:,:,1)
1699      ENDIF
1700      IF( srcv(jpr_cal)%laction ) THEN   ! calving (put in emp_tot and emp_oce)
1701         zemp_tot(:,:) = zemp_tot(:,:) - frcv(jpr_cal)%z3(:,:,1)
1702         zemp_oce(:,:) = zemp_oce(:,:) - frcv(jpr_cal)%z3(:,:,1)
1703      ENDIF
1704      IF( srcv(jpr_icb)%laction ) THEN   ! iceberg added to runoffs
1705         fwficb(:,:) = frcv(jpr_icb)%z3(:,:,1)
1706         rnf(:,:)    = rnf(:,:) + fwficb(:,:)
1707      ENDIF
1708      IF( srcv(jpr_isf)%laction ) THEN   ! iceshelf (fwfisf <0 mean melting)
1709        fwfisf_oasis(:,:) = - frcv(jpr_isf)%z3(:,:,1) 
1710      ENDIF
1711
1712      IF( ln_mixcpl ) THEN
1713         emp_tot(:,:) = emp_tot(:,:) * xcplmask(:,:,0) + zemp_tot(:,:) * zmsk(:,:)
1714         emp_ice(:,:) = emp_ice(:,:) * xcplmask(:,:,0) + zemp_ice(:,:) * zmsk(:,:)
1715         emp_oce(:,:) = emp_oce(:,:) * xcplmask(:,:,0) + zemp_oce(:,:) * zmsk(:,:)
1716         sprecip(:,:) = sprecip(:,:) * xcplmask(:,:,0) + zsprecip(:,:) * zmsk(:,:)
1717         tprecip(:,:) = tprecip(:,:) * xcplmask(:,:,0) + ztprecip(:,:) * zmsk(:,:)
1718         DO jl = 1, jpl
1719            evap_ice (:,:,jl) = evap_ice (:,:,jl) * xcplmask(:,:,0) + zevap_ice (:,:,jl) * zmsk(:,:)
1720            devap_ice(:,:,jl) = devap_ice(:,:,jl) * xcplmask(:,:,0) + zdevap_ice(:,:)    * zmsk(:,:)
1721         END DO
1722      ELSE
1723         emp_tot (:,:)   = zemp_tot (:,:)
1724         emp_ice (:,:)   = zemp_ice (:,:)
1725         emp_oce (:,:)   = zemp_oce (:,:)     
1726         sprecip (:,:)   = zsprecip (:,:)
1727         tprecip (:,:)   = ztprecip (:,:)
1728         evap_ice(:,:,:) = zevap_ice(:,:,:)
1729         DO jl = 1, jpl
1730            devap_ice(:,:,jl) = zdevap_ice(:,:)
1731         END DO
1732      ENDIF
1733
1734#else
1735      zsnw(:,:) = picefr(:,:)
1736      ! --- Continental fluxes --- !
1737      IF( srcv(jpr_rnf)%laction ) THEN   ! runoffs (included in emp later on)
1738         rnf(:,:) = frcv(jpr_rnf)%z3(:,:,1)
1739      ENDIF
1740      IF( srcv(jpr_cal)%laction ) THEN   ! calving (put in emp_tot)
1741         zemp_tot(:,:) = zemp_tot(:,:) - frcv(jpr_cal)%z3(:,:,1)
1742      ENDIF
1743      IF( srcv(jpr_icb)%laction ) THEN   ! iceberg added to runoffs
1744         fwficb(:,:) = frcv(jpr_icb)%z3(:,:,1)
1745         rnf(:,:)    = rnf(:,:) + fwficb(:,:)
1746      ENDIF
1747      IF( srcv(jpr_isf)%laction ) THEN   ! iceshelf (fwfisf <0 mean melting)
1748        fwfisf_oasis(:,:) = - frcv(jpr_isf)%z3(:,:,1)
1749      ENDIF
1750      !
1751      IF( ln_mixcpl ) THEN
1752         emp_tot(:,:) = emp_tot(:,:) * xcplmask(:,:,0) + zemp_tot(:,:) * zmsk(:,:)
1753         emp_ice(:,:) = emp_ice(:,:) * xcplmask(:,:,0) + zemp_ice(:,:) * zmsk(:,:)
1754         sprecip(:,:) = sprecip(:,:) * xcplmask(:,:,0) + zsprecip(:,:) * zmsk(:,:)
1755         tprecip(:,:) = tprecip(:,:) * xcplmask(:,:,0) + ztprecip(:,:) * zmsk(:,:)
1756      ELSE
1757         emp_tot(:,:) =                                  zemp_tot(:,:)
1758         emp_ice(:,:) =                                  zemp_ice(:,:)
1759         sprecip(:,:) =                                  zsprecip(:,:)
1760         tprecip(:,:) =                                  ztprecip(:,:)
1761      ENDIF
1762      !
1763#endif
1764
1765      ! outputs
1766!!      IF( srcv(jpr_rnf)%laction )   CALL iom_put( 'runoffs' , rnf(:,:) * tmask(:,:,1)                                 )  ! runoff
1767!!      IF( srcv(jpr_isf)%laction )   CALL iom_put( 'iceshelf_cea', -fwfisf(:,:) * tmask(:,:,1)                         )  ! iceshelf
1768      IF( srcv(jpr_cal)%laction )   CALL iom_put( 'calving_cea' , frcv(jpr_cal)%z3(:,:,1) * tmask(:,:,1)                )  ! calving
1769      IF( srcv(jpr_icb)%laction )   CALL iom_put( 'iceberg_cea' , frcv(jpr_icb)%z3(:,:,1) * tmask(:,:,1)                )  ! icebergs
1770      IF( iom_use('snowpre') )      CALL iom_put( 'snowpre'     , sprecip(:,:)                                          )  ! Snow
1771      IF( iom_use('precip') )       CALL iom_put( 'precip'      , tprecip(:,:)                                          )  ! total  precipitation
1772      IF( iom_use('rain') )         CALL iom_put( 'rain'        , tprecip(:,:) - sprecip(:,:)                           )  ! liquid precipitation
1773      IF( iom_use('snow_ao_cea') )  CALL iom_put( 'snow_ao_cea' , sprecip(:,:) * ( 1._wp - zsnw(:,:) )                  )  ! Snow over ice-free ocean  (cell average)
1774      IF( iom_use('snow_ai_cea') )  CALL iom_put( 'snow_ai_cea' , sprecip(:,:) *           zsnw(:,:)                    )  ! Snow over sea-ice         (cell average)
1775      IF( iom_use('rain_ao_cea') )  CALL iom_put( 'rain_ao_cea' , ( tprecip(:,:) - sprecip(:,:) ) * picefr(:,:)         )  ! liquid precipitation over ocean (cell average)
1776      IF( iom_use('subl_ai_cea') )  CALL iom_put( 'subl_ai_cea' , frcv(jpr_ievp)%z3(:,:,1) * picefr(:,:) * tmask(:,:,1) )  ! Sublimation over sea-ice (cell average)
1777      IF( iom_use('evap_ao_cea') )  CALL iom_put( 'evap_ao_cea' , ( frcv(jpr_tevp)%z3(:,:,1)  &
1778         &                                                        - frcv(jpr_ievp)%z3(:,:,1) * picefr(:,:) ) * tmask(:,:,1) )  ! ice-free oce evap (cell average)
1779      ! note: runoff output is done in sbcrnf (which includes icebergs too) and iceshelf output is done in sbcisf
1780      !
1781      !                                                      ! ========================= !
1782      SELECT CASE( TRIM( sn_rcv_qns%cldes ) )                !   non solar heat fluxes   !   (qns)
1783      !                                                      ! ========================= !
1784      CASE( 'oce only' )         ! the required field is directly provided
1785         zqns_tot(:,:) = frcv(jpr_qnsoce)%z3(:,:,1)
1786      CASE( 'conservative' )     ! the required fields are directly provided
1787         zqns_tot(:,:) = frcv(jpr_qnsmix)%z3(:,:,1)
1788         IF( TRIM(sn_rcv_qns%clcat) == 'yes' ) THEN
1789            zqns_ice(:,:,1:jpl) = frcv(jpr_qnsice)%z3(:,:,1:jpl)
1790         ELSE
1791            DO jl = 1, jpl
1792               zqns_ice(:,:,jl) = frcv(jpr_qnsice)%z3(:,:,1) ! Set all category values equal
1793            END DO
1794         ENDIF
1795      CASE( 'oce and ice' )      ! the total flux is computed from ocean and ice fluxes
1796         zqns_tot(:,:) =  ziceld(:,:) * frcv(jpr_qnsoce)%z3(:,:,1)
1797         IF( TRIM(sn_rcv_qns%clcat) == 'yes' ) THEN
1798            DO jl=1,jpl
1799               zqns_tot(:,:   ) = zqns_tot(:,:) + a_i(:,:,jl) * frcv(jpr_qnsice)%z3(:,:,jl)   
1800               zqns_ice(:,:,jl) = frcv(jpr_qnsice)%z3(:,:,jl)
1801            ENDDO
1802         ELSE
1803            qns_tot(:,:) = qns_tot(:,:) + picefr(:,:) * frcv(jpr_qnsice)%z3(:,:,1)
1804            DO jl = 1, jpl
1805               zqns_tot(:,:   ) = zqns_tot(:,:) + picefr(:,:) * frcv(jpr_qnsice)%z3(:,:,1)
1806               zqns_ice(:,:,jl) = frcv(jpr_qnsice)%z3(:,:,1)
1807            END DO
1808         ENDIF
1809      CASE( 'mixed oce-ice' )    ! the ice flux is cumputed from the total flux, the SST and ice informations
1810! ** NEED TO SORT OUT HOW THIS SHOULD WORK IN THE MULTI-CATEGORY CASE - CURRENTLY NOT ALLOWED WHEN INTERFACE INITIALISED **
1811         zqns_tot(:,:  ) = frcv(jpr_qnsmix)%z3(:,:,1)
1812         IF ( TRIM(sn_rcv_qsr%clcat) == 'yes' ) THEN
1813            DO jl = 1, jpl
1814               zqns_ice(:,:,jl) = frcv(jpr_qnsmix)%z3(:,:,jl)    &
1815                  &             + frcv(jpr_dqnsdt)%z3(:,:,jl) * ( pist(:,:,jl) - ( ( rt0 + psst(:,:) ) * ziceld(:,:)   &
1816                  &                                                                + pist(:,:,jl) * picefr(:,:) ) )
1817            END DO
1818         ELSE
1819            DO jl = 1, jpl
1820               zqns_ice(:,:,jl) = frcv(jpr_qnsmix)%z3(:,:, 1)    &
1821                  &             + frcv(jpr_dqnsdt)%z3(:,:, 1) * ( pist(:,:,jl) - ( ( rt0 + psst(:,:) ) * ziceld(:,:)   &
1822                  &                                                                + pist(:,:,jl) * picefr(:,:) ) )
1823            END DO
1824         ENDIF
1825      END SELECT
1826      !                                     
1827      ! --- calving (removed from qns_tot) --- !
1828      IF( srcv(jpr_cal)%laction )   zqns_tot(:,:) = zqns_tot(:,:) - frcv(jpr_cal)%z3(:,:,1) * rLfus  ! remove latent heat of calving
1829                                                                                                     ! we suppose it melts at 0deg, though it should be temp. of surrounding ocean
1830      ! --- iceberg (removed from qns_tot) --- !
1831      IF( srcv(jpr_icb)%laction )   zqns_tot(:,:) = zqns_tot(:,:) - frcv(jpr_icb)%z3(:,:,1) * rLfus  ! remove latent heat of iceberg melting
1832
1833#if defined key_si3     
1834      ! --- non solar flux over ocean --- !
1835      !         note: ziceld cannot be = 0 since we limit the ice concentration to amax
1836      zqns_oce = 0._wp
1837      WHERE( ziceld /= 0._wp )   zqns_oce(:,:) = ( zqns_tot(:,:) - SUM( a_i * zqns_ice, dim=3 ) ) / ziceld(:,:)
1838
1839      ! Heat content per unit mass of snow (J/kg)
1840      WHERE( SUM( a_i, dim=3 ) > 1.e-10 )   ;   zcptsnw(:,:) = rcpi * SUM( (tn_ice - rt0) * a_i, dim=3 ) / SUM( a_i, dim=3 )
1841      ELSEWHERE                             ;   zcptsnw(:,:) = zcptn(:,:)
1842      ENDWHERE
1843      ! Heat content per unit mass of rain (J/kg)
1844      zcptrain(:,:) = rcp * ( SUM( (tn_ice(:,:,:) - rt0) * a_i(:,:,:), dim=3 ) + sst_m(:,:) * ziceld(:,:) ) 
1845
1846      ! --- enthalpy of snow precip over ice in J/m3 (to be used in 1D-thermo) --- !
1847      zqprec_ice(:,:) = rhos * ( zcptsnw(:,:) - rLfus )
1848
1849      ! --- heat content of evap over ice in W/m2 (to be used in 1D-thermo) --- !
1850      DO jl = 1, jpl
1851         zqevap_ice(:,:,jl) = 0._wp ! should be -evap * ( ( Tice - rt0 ) * rcpi ) but atm. does not take it into account
1852      END DO
1853
1854      ! --- heat flux associated with emp (W/m2) --- !
1855      zqemp_oce(:,:) = -  zevap_oce(:,:)                                      *   zcptn   (:,:)   &        ! evap
1856         &             + ( ztprecip(:,:) - zsprecip(:,:) )                    *   zcptrain(:,:)   &        ! liquid precip
1857         &             +   zsprecip(:,:)                   * ( 1._wp - zsnw ) * ( zcptsnw (:,:) - rLfus )  ! solid precip over ocean + snow melting
1858      zqemp_ice(:,:) =     zsprecip(:,:)                   * zsnw             * ( zcptsnw (:,:) - rLfus )  ! solid precip over ice (qevap_ice=0 since atm. does not take it into account)
1859!!    zqemp_ice(:,:) = -   frcv(jpr_ievp)%z3(:,:,1)        * picefr(:,:)      *   zcptsnw (:,:)   &        ! ice evap
1860!!       &             +   zsprecip(:,:)                   * zsnw             * zqprec_ice(:,:) * r1_rhos  ! solid precip over ice
1861     
1862      ! --- total non solar flux (including evap/precip) --- !
1863      zqns_tot(:,:) = zqns_tot(:,:) + zqemp_ice(:,:) + zqemp_oce(:,:)
1864
1865      ! --- in case both coupled/forced are active, we must mix values --- !
1866      IF( ln_mixcpl ) THEN
1867         qns_tot(:,:) = qns_tot(:,:) * xcplmask(:,:,0) + zqns_tot(:,:)* zmsk(:,:)
1868         qns_oce(:,:) = qns_oce(:,:) * xcplmask(:,:,0) + zqns_oce(:,:)* zmsk(:,:)
1869         DO jl=1,jpl
1870            qns_ice  (:,:,jl) = qns_ice  (:,:,jl) * xcplmask(:,:,0) +  zqns_ice  (:,:,jl)* zmsk(:,:)
1871            qevap_ice(:,:,jl) = qevap_ice(:,:,jl) * xcplmask(:,:,0) +  zqevap_ice(:,:,jl)* zmsk(:,:)
1872         ENDDO
1873         qprec_ice(:,:) = qprec_ice(:,:) * xcplmask(:,:,0) + zqprec_ice(:,:)* zmsk(:,:)
1874         qemp_oce (:,:) =  qemp_oce(:,:) * xcplmask(:,:,0) +  zqemp_oce(:,:)* zmsk(:,:)
1875         qemp_ice (:,:) =  qemp_ice(:,:) * xcplmask(:,:,0) +  zqemp_ice(:,:)* zmsk(:,:)
1876      ELSE
1877         qns_tot  (:,:  ) = zqns_tot  (:,:  )
1878         qns_oce  (:,:  ) = zqns_oce  (:,:  )
1879         qns_ice  (:,:,:) = zqns_ice  (:,:,:)
1880         qevap_ice(:,:,:) = zqevap_ice(:,:,:)
1881         qprec_ice(:,:  ) = zqprec_ice(:,:  )
1882         qemp_oce (:,:  ) = zqemp_oce (:,:  )
1883         qemp_ice (:,:  ) = zqemp_ice (:,:  )
1884      ENDIF
1885
1886#else
1887      zcptsnw (:,:) = zcptn(:,:)
1888      zcptrain(:,:) = zcptn(:,:)
1889     
1890      ! clem: this formulation is certainly wrong... but better than it was...
1891      zqns_tot(:,:) = zqns_tot(:,:)                             &          ! zqns_tot update over free ocean with:
1892         &          - (  ziceld(:,:) * zsprecip(:,:) * rLfus )  &          ! remove the latent heat flux of solid precip. melting
1893         &          - (  zemp_tot(:,:)                          &          ! remove the heat content of mass flux (assumed to be at SST)
1894         &             - zemp_ice(:,:) ) * zcptn(:,:) 
1895
1896     IF( ln_mixcpl ) THEN
1897         qns_tot(:,:) = qns(:,:) * ziceld(:,:) + SUM( qns_ice(:,:,:) * a_i(:,:,:), dim=3 )   ! total flux from blk
1898         qns_tot(:,:) = qns_tot(:,:) * xcplmask(:,:,0) +  zqns_tot(:,:)* zmsk(:,:)
1899         DO jl=1,jpl
1900            qns_ice(:,:,jl) = qns_ice(:,:,jl) * xcplmask(:,:,0) +  zqns_ice(:,:,jl)* zmsk(:,:)
1901         ENDDO
1902      ELSE
1903         qns_tot(:,:  ) = zqns_tot(:,:  )
1904         qns_ice(:,:,:) = zqns_ice(:,:,:)
1905      ENDIF
1906
1907#endif
1908      ! outputs
1909      IF( srcv(jpr_cal)%laction       ) CALL iom_put('hflx_cal_cea'    , - frcv(jpr_cal)%z3(:,:,1) * rLfus )                      ! latent heat from calving
1910      IF( srcv(jpr_icb)%laction       ) CALL iom_put('hflx_icb_cea'    , - frcv(jpr_icb)%z3(:,:,1) * rLfus )                      ! latent heat from icebergs melting
1911      IF( iom_use('hflx_rain_cea')    ) CALL iom_put('hflx_rain_cea'   , ( tprecip(:,:) - sprecip(:,:) ) * zcptrain(:,:) )        ! heat flux from rain (cell average)
1912      IF( iom_use('hflx_evap_cea')    ) CALL iom_put('hflx_evap_cea'   , ( frcv(jpr_tevp)%z3(:,:,1) - frcv(jpr_ievp)%z3(:,:,1) &
1913           &                                                              * picefr(:,:) ) * zcptn(:,:) * tmask(:,:,1) )            ! heat flux from evap (cell average)
1914      IF( iom_use('hflx_prec_cea')    ) CALL iom_put('hflx_prec_cea'   ,  sprecip(:,:) * ( zcptsnw(:,:) - rLfus ) +  &                    ! heat flux from all precip (cell avg)
1915         &                                                               ( tprecip(:,:) - sprecip(:,:) ) * zcptrain(:,:) )
1916      IF( iom_use('hflx_snow_cea')    ) CALL iom_put('hflx_snow_cea'   , sprecip(:,:) * ( zcptsnw(:,:) - rLfus )  )               ! heat flux from snow (cell average)
1917      IF( iom_use('hflx_snow_ao_cea') ) CALL iom_put('hflx_snow_ao_cea', sprecip(:,:) * ( zcptsnw(:,:) - rLfus ) &
1918           &                                                              * ( 1._wp - zsnw(:,:) )                  )               ! heat flux from snow (over ocean)
1919      IF( iom_use('hflx_snow_ai_cea') ) CALL iom_put('hflx_snow_ai_cea', sprecip(:,:) * ( zcptsnw(:,:) - rLfus ) & 
1920           &                                                              *           zsnw(:,:)                    )               ! heat flux from snow (over ice)
1921      ! note: hflx for runoff and iceshelf are done in sbcrnf and sbcisf resp.
1922      !
1923      !                                                      ! ========================= !
1924      SELECT CASE( TRIM( sn_rcv_qsr%cldes ) )                !      solar heat fluxes    !   (qsr)
1925      !                                                      ! ========================= !
1926      CASE( 'oce only' )
1927         zqsr_tot(:,:  ) = MAX( 0._wp , frcv(jpr_qsroce)%z3(:,:,1) )
1928      CASE( 'conservative' )
1929         zqsr_tot(:,:  ) = frcv(jpr_qsrmix)%z3(:,:,1)
1930         IF( TRIM(sn_rcv_qsr%clcat) == 'yes' ) THEN
1931            zqsr_ice(:,:,1:jpl) = frcv(jpr_qsrice)%z3(:,:,1:jpl)
1932         ELSE
1933            ! Set all category values equal for the moment
1934            DO jl = 1, jpl
1935               zqsr_ice(:,:,jl) = frcv(jpr_qsrice)%z3(:,:,1)
1936            END DO
1937         ENDIF
1938      CASE( 'oce and ice' )
1939         zqsr_tot(:,:  ) =  ziceld(:,:) * frcv(jpr_qsroce)%z3(:,:,1)
1940         IF( TRIM(sn_rcv_qsr%clcat) == 'yes' ) THEN
1941            DO jl = 1, jpl
1942               zqsr_tot(:,:   ) = zqsr_tot(:,:) + a_i(:,:,jl) * frcv(jpr_qsrice)%z3(:,:,jl)   
1943               zqsr_ice(:,:,jl) = frcv(jpr_qsrice)%z3(:,:,jl)
1944            END DO
1945         ELSE
1946            qsr_tot(:,:   ) = qsr_tot(:,:) + picefr(:,:) * frcv(jpr_qsrice)%z3(:,:,1)
1947            DO jl = 1, jpl
1948               zqsr_tot(:,:   ) = zqsr_tot(:,:) + picefr(:,:) * frcv(jpr_qsrice)%z3(:,:,1)
1949               zqsr_ice(:,:,jl) = frcv(jpr_qsrice)%z3(:,:,1)
1950            END DO
1951         ENDIF
1952      CASE( 'mixed oce-ice' )
1953         zqsr_tot(:,:  ) = frcv(jpr_qsrmix)%z3(:,:,1)
1954! ** NEED TO SORT OUT HOW THIS SHOULD WORK IN THE MULTI-CATEGORY CASE - CURRENTLY NOT ALLOWED WHEN INTERFACE INITIALISED **
1955!       Create solar heat flux over ice using incoming solar heat flux and albedos
1956!       ( see OASIS3 user guide, 5th edition, p39 )
1957         IF ( TRIM(sn_rcv_qsr%clcat) == 'yes' ) THEN
1958            DO jl = 1, jpl
1959               zqsr_ice(:,:,jl) = frcv(jpr_qsrmix)%z3(:,:,jl) * ( 1.- palbi(:,:,jl) )   &
1960                  &            / (  1.- ( alb_oce_mix(:,:   ) * ziceld(:,:)       &
1961                  &                     + palbi      (:,:,jl) * picefr(:,:) ) )
1962            END DO
1963         ELSE
1964            DO jl = 1, jpl
1965               zqsr_ice(:,:,jl) = frcv(jpr_qsrmix)%z3(:,:, 1) * ( 1.- palbi(:,:,jl) )   &
1966                  &            / (  1.- ( alb_oce_mix(:,:   ) * ziceld(:,:)       &
1967                  &                     + palbi      (:,:,jl) * picefr(:,:) ) )
1968            END DO
1969         ENDIF
1970      CASE( 'none'      )       ! Not available as for now: needs additional coding 
1971      !                         ! since fields received, here zqsr_tot,  are not defined with none option
1972         CALL ctl_stop( 'STOP', 'sbccpl/sbc_cpl_ice_flx: some fields are not defined. Change sn_rcv_qsr value in namelist namsbc_cpl' )
1973      END SELECT
1974      IF( ln_dm2dc .AND. ln_cpl ) THEN   ! modify qsr to include the diurnal cycle
1975         zqsr_tot(:,:  ) = sbc_dcy( zqsr_tot(:,:  ) )
1976         DO jl = 1, jpl
1977            zqsr_ice(:,:,jl) = sbc_dcy( zqsr_ice(:,:,jl) )
1978         END DO
1979      ENDIF
1980
1981#if defined key_si3
1982      ! --- solar flux over ocean --- !
1983      !         note: ziceld cannot be = 0 since we limit the ice concentration to amax
1984      zqsr_oce = 0._wp
1985      WHERE( ziceld /= 0._wp )  zqsr_oce(:,:) = ( zqsr_tot(:,:) - SUM( a_i * zqsr_ice, dim=3 ) ) / ziceld(:,:)
1986
1987      IF( ln_mixcpl ) THEN   ;   qsr_oce(:,:) = qsr_oce(:,:) * xcplmask(:,:,0) +  zqsr_oce(:,:)* zmsk(:,:)
1988      ELSE                   ;   qsr_oce(:,:) = zqsr_oce(:,:)   ;   ENDIF
1989#endif
1990
1991      IF( ln_mixcpl ) THEN
1992         qsr_tot(:,:) = qsr(:,:) * ziceld(:,:) + SUM( qsr_ice(:,:,:) * a_i(:,:,:), dim=3 )   ! total flux from blk
1993         qsr_tot(:,:) = qsr_tot(:,:) * xcplmask(:,:,0) +  zqsr_tot(:,:)* zmsk(:,:)
1994         DO jl = 1, jpl
1995            qsr_ice(:,:,jl) = qsr_ice(:,:,jl) * xcplmask(:,:,0) +  zqsr_ice(:,:,jl)* zmsk(:,:)
1996         END DO
1997      ELSE
1998         qsr_tot(:,:  ) = zqsr_tot(:,:  )
1999         qsr_ice(:,:,:) = zqsr_ice(:,:,:)
2000      ENDIF
2001
2002      !                                                      ! ========================= !
2003      SELECT CASE( TRIM( sn_rcv_dqnsdt%cldes ) )             !          d(qns)/dt        !
2004      !                                                      ! ========================= !
2005      CASE ('coupled')
2006         IF( TRIM(sn_rcv_dqnsdt%clcat) == 'yes' ) THEN
2007            zdqns_ice(:,:,1:jpl) = frcv(jpr_dqnsdt)%z3(:,:,1:jpl)
2008         ELSE
2009            ! Set all category values equal for the moment
2010            DO jl=1,jpl
2011               zdqns_ice(:,:,jl) = frcv(jpr_dqnsdt)%z3(:,:,1)
2012            ENDDO
2013         ENDIF
2014      END SELECT
2015     
2016      IF( ln_mixcpl ) THEN
2017         DO jl=1,jpl
2018            dqns_ice(:,:,jl) = dqns_ice(:,:,jl) * xcplmask(:,:,0) + zdqns_ice(:,:,jl) * zmsk(:,:)
2019         ENDDO
2020      ELSE
2021         dqns_ice(:,:,:) = zdqns_ice(:,:,:)
2022      ENDIF
2023
2024#if defined key_si3     
2025      !                                                      ! ========================= !
2026      SELECT CASE( TRIM( sn_rcv_iceflx%cldes ) )             !  ice topmelt and botmelt  !
2027      !                                                      ! ========================= !
2028      CASE ('coupled')
2029         IF( ln_mixcpl ) THEN
2030            DO jl=1,jpl
2031               qml_ice(:,:,jl) = qml_ice(:,:,jl) * xcplmask(:,:,0) + frcv(jpr_topm)%z3(:,:,jl) * zmsk(:,:)
2032               qcn_ice(:,:,jl) = qcn_ice(:,:,jl) * xcplmask(:,:,0) + frcv(jpr_botm)%z3(:,:,jl) * zmsk(:,:)
2033            ENDDO
2034         ELSE
2035            qml_ice(:,:,:) = frcv(jpr_topm)%z3(:,:,:)
2036            qcn_ice(:,:,:) = frcv(jpr_botm)%z3(:,:,:)
2037         ENDIF
2038      END SELECT
2039      !                                                      ! ========================= !
2040      !                                                      !      Transmitted Qsr      !   [W/m2]
2041      !                                                      ! ========================= !
2042      IF( .NOT.ln_cndflx ) THEN                              !==  No conduction flux as surface forcing  ==!
2043         !
2044         !                    ! ===> used prescribed cloud fraction representative for polar oceans in summer (0.81)
2045         ztri = 0.18 * ( 1.0 - cldf_ice ) + 0.35 * cldf_ice    ! surface transmission when hi>10cm (Grenfell Maykut 77)
2046         !
2047         WHERE    ( phs(:,:,:) <= 0._wp .AND. phi(:,:,:) <  0.1_wp )       ! linear decrease from hi=0 to 10cm 
2048            zqtr_ice_top(:,:,:) = qsr_ice(:,:,:) * ( ztri + ( 1._wp - ztri ) * ( 1._wp - phi(:,:,:) * 10._wp ) )
2049         ELSEWHERE( phs(:,:,:) <= 0._wp .AND. phi(:,:,:) >= 0.1_wp )       ! constant (ztri) when hi>10cm
2050            zqtr_ice_top(:,:,:) = qsr_ice(:,:,:) * ztri
2051         ELSEWHERE                                                         ! zero when hs>0
2052            zqtr_ice_top(:,:,:) = 0._wp
2053         END WHERE
2054         !     
2055      ELSEIF( ln_cndflx .AND. .NOT.ln_cndemulate ) THEN      !==  conduction flux as surface forcing  ==!
2056         !
2057         !                    ! ===> here we must receive the qtr_ice_top array from the coupler
2058         !                           for now just assume zero (fully opaque ice)
2059         zqtr_ice_top(:,:,:) = 0._wp
2060         !
2061      ENDIF
2062      !
2063      IF( ln_mixcpl ) THEN
2064         DO jl=1,jpl
2065            qtr_ice_top(:,:,jl) = qtr_ice_top(:,:,jl) * xcplmask(:,:,0) + zqtr_ice_top(:,:,jl) * zmsk(:,:)
2066         ENDDO
2067      ELSE
2068         qtr_ice_top(:,:,:) = zqtr_ice_top(:,:,:)
2069      ENDIF
2070      !                                                      ! ================== !
2071      !                                                      !   ice skin temp.   !
2072      !                                                      ! ================== !
2073      ! needed by Met Office
2074      IF( srcv(jpr_ts_ice)%laction ) THEN
2075         WHERE    ( frcv(jpr_ts_ice)%z3(:,:,:) > 0.0  )   ;   ztsu(:,:,:) =   0. + rt0 
2076         ELSEWHERE( frcv(jpr_ts_ice)%z3(:,:,:) < -60. )   ;   ztsu(:,:,:) = -60. + rt0
2077         ELSEWHERE                                        ;   ztsu(:,:,:) = frcv(jpr_ts_ice)%z3(:,:,:) + rt0
2078         END WHERE
2079         !
2080         IF( ln_mixcpl ) THEN
2081            DO jl=1,jpl
2082               pist(:,:,jl) = pist(:,:,jl) * xcplmask(:,:,0) + ztsu(:,:,jl) * zmsk(:,:)
2083            ENDDO
2084         ELSE
2085            pist(:,:,:) = ztsu(:,:,:)
2086         ENDIF
2087         !
2088      ENDIF
2089      !
2090#endif
2091      !
2092   END SUBROUTINE sbc_cpl_ice_flx
2093   
2094   
2095   SUBROUTINE sbc_cpl_snd( kt, Kbb, Kmm )
2096      !!----------------------------------------------------------------------
2097      !!             ***  ROUTINE sbc_cpl_snd  ***
2098      !!
2099      !! ** Purpose :   provide the ocean-ice informations to the atmosphere
2100      !!
2101      !! ** Method  :   send to the atmosphere through a call to cpl_snd
2102      !!              all the needed fields (as defined in sbc_cpl_init)
2103      !!----------------------------------------------------------------------
2104      INTEGER, INTENT(in) ::   kt
2105      INTEGER, INTENT(in) ::   Kbb, Kmm    ! ocean model time level index
2106      !
2107      INTEGER ::   ji, jj, jl   ! dummy loop indices
2108      INTEGER ::   isec, info   ! local integer
2109      REAL(wp) ::   zumax, zvmax
2110      REAL(wp), DIMENSION(jpi,jpj)     ::   zfr_l, ztmp1, ztmp2, zotx1, zoty1, zotz1, zitx1, zity1, zitz1
2111      REAL(wp), DIMENSION(jpi,jpj,jpl) ::   ztmp3, ztmp4   
2112      !!----------------------------------------------------------------------
2113      !
2114      isec = ( kt - nit000 ) * NINT( rdt )        ! date of exchanges
2115
2116      zfr_l(:,:) = 1.- fr_i(:,:)
2117      !                                                      ! ------------------------- !
2118      !                                                      !    Surface temperature    !   in Kelvin
2119      !                                                      ! ------------------------- !
2120      IF( ssnd(jps_toce)%laction .OR. ssnd(jps_tice)%laction .OR. ssnd(jps_tmix)%laction ) THEN
2121         
2122         IF( nn_components == jp_iam_opa ) THEN
2123            ztmp1(:,:) = ts(:,:,1,jp_tem,Kmm)   ! send temperature as it is (potential or conservative) -> use of l_useCT on the received part
2124         ELSE
2125            ! we must send the surface potential temperature
2126            IF( l_useCT )  THEN    ;   ztmp1(:,:) = eos_pt_from_ct( ts(:,:,1,jp_tem,Kmm), ts(:,:,1,jp_sal,Kmm) )
2127            ELSE                   ;   ztmp1(:,:) = ts(:,:,1,jp_tem,Kmm)
2128            ENDIF
2129            !
2130            SELECT CASE( sn_snd_temp%cldes)
2131            CASE( 'oce only'             )   ;   ztmp1(:,:) =   ztmp1(:,:) + rt0
2132            CASE( 'oce and ice'          )   ;   ztmp1(:,:) =   ztmp1(:,:) + rt0
2133               SELECT CASE( sn_snd_temp%clcat )
2134               CASE( 'yes' )   
2135                  ztmp3(:,:,1:jpl) = tn_ice(:,:,1:jpl)
2136               CASE( 'no' )
2137                  WHERE( SUM( a_i, dim=3 ) /= 0. )
2138                     ztmp3(:,:,1) = SUM( tn_ice * a_i, dim=3 ) / SUM( a_i, dim=3 )
2139                  ELSEWHERE
2140                     ztmp3(:,:,1) = rt0
2141                  END WHERE
2142               CASE default   ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_temp%clcat' )
2143               END SELECT
2144            CASE( 'weighted oce and ice' )   ;   ztmp1(:,:) = ( ztmp1(:,:) + rt0 ) * zfr_l(:,:)   
2145               SELECT CASE( sn_snd_temp%clcat )
2146               CASE( 'yes' )   
2147                  ztmp3(:,:,1:jpl) = tn_ice(:,:,1:jpl) * a_i(:,:,1:jpl)
2148               CASE( 'no' )
2149                  ztmp3(:,:,:) = 0.0
2150                  DO jl=1,jpl
2151                     ztmp3(:,:,1) = ztmp3(:,:,1) + tn_ice(:,:,jl) * a_i(:,:,jl)
2152                  ENDDO
2153               CASE default                  ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_temp%clcat' )
2154               END SELECT
2155            CASE( 'oce and weighted ice')    ;   ztmp1(:,:) =   ts(:,:,1,jp_tem,Kmm) + rt0 
2156               SELECT CASE( sn_snd_temp%clcat ) 
2157               CASE( 'yes' )   
2158                  ztmp3(:,:,1:jpl) = tn_ice(:,:,1:jpl) * a_i(:,:,1:jpl) 
2159               CASE( 'no' ) 
2160                  ztmp3(:,:,:) = 0.0 
2161                  DO jl=1,jpl 
2162                     ztmp3(:,:,1) = ztmp3(:,:,1) + tn_ice(:,:,jl) * a_i(:,:,jl) 
2163                  ENDDO 
2164               CASE default                  ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_temp%clcat' ) 
2165               END SELECT
2166            CASE( 'mixed oce-ice'        )   
2167               ztmp1(:,:) = ( ztmp1(:,:) + rt0 ) * zfr_l(:,:) 
2168               DO jl=1,jpl
2169                  ztmp1(:,:) = ztmp1(:,:) + tn_ice(:,:,jl) * a_i(:,:,jl)
2170               ENDDO
2171            CASE default                     ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_temp%cldes' )
2172            END SELECT
2173         ENDIF
2174         IF( ssnd(jps_toce)%laction )   CALL cpl_snd( jps_toce, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info )
2175         IF( ssnd(jps_tice)%laction )   CALL cpl_snd( jps_tice, isec, ztmp3, info )
2176         IF( ssnd(jps_tmix)%laction )   CALL cpl_snd( jps_tmix, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info )
2177      ENDIF
2178      !
2179      !                                                      ! ------------------------- !
2180      !                                                      ! 1st layer ice/snow temp.  !
2181      !                                                      ! ------------------------- !
2182#if defined key_si3
2183      ! needed by  Met Office
2184      IF( ssnd(jps_ttilyr)%laction) THEN
2185         SELECT CASE( sn_snd_ttilyr%cldes)
2186         CASE ('weighted ice')
2187            ztmp3(:,:,1:jpl) = t1_ice(:,:,1:jpl) * a_i(:,:,1:jpl) 
2188         CASE default                     ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_ttilyr%cldes' )
2189         END SELECT
2190         IF( ssnd(jps_ttilyr)%laction )   CALL cpl_snd( jps_ttilyr, isec, ztmp3, info )
2191      ENDIF
2192#endif
2193      !                                                      ! ------------------------- !
2194      !                                                      !           Albedo          !
2195      !                                                      ! ------------------------- !
2196      IF( ssnd(jps_albice)%laction ) THEN                         ! ice
2197          SELECT CASE( sn_snd_alb%cldes )
2198          CASE( 'ice' )
2199             SELECT CASE( sn_snd_alb%clcat )
2200             CASE( 'yes' )   
2201                ztmp3(:,:,1:jpl) = alb_ice(:,:,1:jpl)
2202             CASE( 'no' )
2203                WHERE( SUM( a_i, dim=3 ) /= 0. )
2204                   ztmp1(:,:) = SUM( alb_ice (:,:,1:jpl) * a_i(:,:,1:jpl), dim=3 ) / SUM( a_i(:,:,1:jpl), dim=3 )
2205                ELSEWHERE
2206                   ztmp1(:,:) = alb_oce_mix(:,:)
2207                END WHERE
2208             CASE default   ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_alb%clcat' )
2209             END SELECT
2210          CASE( 'weighted ice' )   ;
2211             SELECT CASE( sn_snd_alb%clcat )
2212             CASE( 'yes' )   
2213                ztmp3(:,:,1:jpl) =  alb_ice(:,:,1:jpl) * a_i(:,:,1:jpl)
2214             CASE( 'no' )
2215                WHERE( fr_i (:,:) > 0. )
2216                   ztmp1(:,:) = SUM (  alb_ice(:,:,1:jpl) * a_i(:,:,1:jpl), dim=3 )
2217                ELSEWHERE
2218                   ztmp1(:,:) = 0.
2219                END WHERE
2220             CASE default   ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_ice%clcat' )
2221             END SELECT
2222          CASE default      ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_alb%cldes' )
2223         END SELECT
2224
2225         SELECT CASE( sn_snd_alb%clcat )
2226            CASE( 'yes' )   
2227               CALL cpl_snd( jps_albice, isec, ztmp3, info )      !-> MV this has never been checked in coupled mode
2228            CASE( 'no'  )   
2229               CALL cpl_snd( jps_albice, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info ) 
2230         END SELECT
2231      ENDIF
2232
2233      IF( ssnd(jps_albmix)%laction ) THEN                         ! mixed ice-ocean
2234         ztmp1(:,:) = alb_oce_mix(:,:) * zfr_l(:,:)
2235         DO jl = 1, jpl
2236            ztmp1(:,:) = ztmp1(:,:) + alb_ice(:,:,jl) * a_i(:,:,jl)
2237         END DO
2238         CALL cpl_snd( jps_albmix, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info )
2239      ENDIF
2240      !                                                      ! ------------------------- !
2241      !                                                      !  Ice fraction & Thickness !
2242      !                                                      ! ------------------------- !
2243      ! Send ice fraction field to atmosphere
2244      IF( ssnd(jps_fice)%laction ) THEN
2245         SELECT CASE( sn_snd_thick%clcat )
2246         CASE( 'yes' )   ;   ztmp3(:,:,1:jpl) =  a_i(:,:,1:jpl)
2247         CASE( 'no'  )   ;   ztmp3(:,:,1    ) = fr_i(:,:      )
2248         CASE default    ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_thick%clcat' )
2249         END SELECT
2250         CALL cpl_snd( jps_fice, isec, ztmp3, info )
2251      ENDIF
2252
2253      IF( ssnd(jps_fice1)%laction ) THEN
2254         SELECT CASE( sn_snd_thick1%clcat )
2255         CASE( 'yes' )   ;   ztmp3(:,:,1:jpl) =  a_i(:,:,1:jpl)
2256         CASE( 'no'  )   ;   ztmp3(:,:,1    ) = fr_i(:,:      )
2257         CASE default    ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_thick1%clcat' )
2258         END SELECT
2259         CALL cpl_snd( jps_fice1, isec, ztmp3, info )
2260      ENDIF
2261     
2262      ! Send ice fraction field to OPA (sent by SAS in SAS-OPA coupling)
2263      IF( ssnd(jps_fice2)%laction ) THEN
2264         ztmp3(:,:,1) = fr_i(:,:)
2265         IF( ssnd(jps_fice2)%laction )   CALL cpl_snd( jps_fice2, isec, ztmp3, info )
2266      ENDIF
2267
2268      ! Send ice and snow thickness field
2269      IF( ssnd(jps_hice)%laction .OR. ssnd(jps_hsnw)%laction ) THEN
2270         SELECT CASE( sn_snd_thick%cldes)
2271         CASE( 'none'                  )       ! nothing to do
2272         CASE( 'weighted ice and snow' )   
2273            SELECT CASE( sn_snd_thick%clcat )
2274            CASE( 'yes' )   
2275               ztmp3(:,:,1:jpl) =  h_i(:,:,1:jpl) * a_i(:,:,1:jpl)
2276               ztmp4(:,:,1:jpl) =  h_s(:,:,1:jpl) * a_i(:,:,1:jpl)
2277            CASE( 'no' )
2278               ztmp3(:,:,:) = 0.0   ;  ztmp4(:,:,:) = 0.0
2279               DO jl=1,jpl
2280                  ztmp3(:,:,1) = ztmp3(:,:,1) + h_i(:,:,jl) * a_i(:,:,jl)
2281                  ztmp4(:,:,1) = ztmp4(:,:,1) + h_s(:,:,jl) * a_i(:,:,jl)
2282               ENDDO
2283            CASE default                  ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_thick%clcat' )
2284            END SELECT
2285         CASE( 'ice and snow'         )   
2286            SELECT CASE( sn_snd_thick%clcat )
2287            CASE( 'yes' )
2288               ztmp3(:,:,1:jpl) = h_i(:,:,1:jpl)
2289               ztmp4(:,:,1:jpl) = h_s(:,:,1:jpl)
2290            CASE( 'no' )
2291               WHERE( SUM( a_i, dim=3 ) /= 0. )
2292                  ztmp3(:,:,1) = SUM( h_i * a_i, dim=3 ) / SUM( a_i, dim=3 )
2293                  ztmp4(:,:,1) = SUM( h_s * a_i, dim=3 ) / SUM( a_i, dim=3 )
2294               ELSEWHERE
2295                 ztmp3(:,:,1) = 0.
2296                 ztmp4(:,:,1) = 0.
2297               END WHERE
2298            CASE default                  ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_thick%clcat' )
2299            END SELECT
2300         CASE default                     ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_thick%cldes' )
2301         END SELECT
2302         IF( ssnd(jps_hice)%laction )   CALL cpl_snd( jps_hice, isec, ztmp3, info )
2303         IF( ssnd(jps_hsnw)%laction )   CALL cpl_snd( jps_hsnw, isec, ztmp4, info )
2304      ENDIF
2305
2306#if defined key_si3
2307      !                                                      ! ------------------------- !
2308      !                                                      !      Ice melt ponds       !
2309      !                                                      ! ------------------------- !
2310      ! needed by Met Office: 1) fraction of ponded ice 2) local/actual pond depth
2311      IF( ssnd(jps_a_p)%laction .OR. ssnd(jps_ht_p)%laction ) THEN
2312         SELECT CASE( sn_snd_mpnd%cldes) 
2313         CASE( 'ice only' ) 
2314            SELECT CASE( sn_snd_mpnd%clcat ) 
2315            CASE( 'yes' ) 
2316               ztmp3(:,:,1:jpl) =  a_ip_frac(:,:,1:jpl)
2317               ztmp4(:,:,1:jpl) =  h_ip(:,:,1:jpl) 
2318            CASE( 'no' ) 
2319               ztmp3(:,:,:) = 0.0 
2320               ztmp4(:,:,:) = 0.0 
2321               DO jl=1,jpl 
2322                 ztmp3(:,:,1) = ztmp3(:,:,1) + a_ip_frac(:,:,jpl) 
2323                 ztmp4(:,:,1) = ztmp4(:,:,1) + h_ip(:,:,jpl) 
2324               ENDDO 
2325            CASE default   ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_mpnd%clcat' ) 
2326            END SELECT 
2327         CASE default      ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_mpnd%cldes' )     
2328         END SELECT 
2329         IF( ssnd(jps_a_p)%laction  )   CALL cpl_snd( jps_a_p , isec, ztmp3, info )     
2330         IF( ssnd(jps_ht_p)%laction )   CALL cpl_snd( jps_ht_p, isec, ztmp4, info )     
2331      ENDIF 
2332      !
2333      !                                                      ! ------------------------- !
2334      !                                                      !     Ice conductivity      !
2335      !                                                      ! ------------------------- !
2336      ! needed by Met Office
2337      IF( ssnd(jps_kice)%laction ) THEN
2338         SELECT CASE( sn_snd_cond%cldes) 
2339         CASE( 'weighted ice' )   
2340            SELECT CASE( sn_snd_cond%clcat ) 
2341            CASE( 'yes' )   
2342          ztmp3(:,:,1:jpl) =  cnd_ice(:,:,1:jpl) * a_i(:,:,1:jpl) 
2343            CASE( 'no' ) 
2344               ztmp3(:,:,:) = 0.0 
2345               DO jl=1,jpl 
2346                 ztmp3(:,:,1) = ztmp3(:,:,1) + cnd_ice(:,:,jl) * a_i(:,:,jl) 
2347               ENDDO 
2348            CASE default   ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_cond%clcat' ) 
2349            END SELECT
2350         CASE( 'ice only' )   
2351           ztmp3(:,:,1:jpl) = cnd_ice(:,:,1:jpl) 
2352         CASE default      ;   CALL ctl_stop( 'sbc_cpl_snd: wrong definition of sn_snd_cond%cldes' )     
2353         END SELECT
2354         IF( ssnd(jps_kice)%laction )   CALL cpl_snd( jps_kice, isec, ztmp3, info ) 
2355      ENDIF 
2356#endif
2357
2358      !                                                      ! ------------------------- !
2359      !                                                      !  CO2 flux from PISCES     !
2360      !                                                      ! ------------------------- !
2361      IF( ssnd(jps_co2)%laction .AND. l_co2cpl )   THEN
2362         ztmp1(:,:) = oce_co2(:,:) * 1000.  ! conversion in molC/m2/s
2363         CALL cpl_snd( jps_co2, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ) , info )
2364      ENDIF
2365      !
2366      !                                                      ! ------------------------- !
2367      IF( ssnd(jps_ocx1)%laction ) THEN                      !      Surface current      !
2368         !                                                   ! ------------------------- !
2369         !   
2370         !                                                  j+1   j     -----V---F
2371         ! surface velocity always sent from T point                     !       |
2372         !                                                        j      |   T   U
2373         !                                                               |       |
2374         !                                                   j    j-1   -I-------|
2375         !                                               (for I)         |       |
2376         !                                                              i-1  i   i
2377         !                                                               i      i+1 (for I)
2378         IF( nn_components == jp_iam_opa ) THEN
2379            zotx1(:,:) = uu(:,:,1,Kmm) 
2380            zoty1(:,:) = vv(:,:,1,Kmm) 
2381         ELSE       
2382            SELECT CASE( TRIM( sn_snd_crt%cldes ) )
2383            CASE( 'oce only'             )      ! C-grid ==> T
2384               DO jj = 2, jpjm1
2385                  DO ji = fs_2, fs_jpim1   ! vector opt.
2386                     zotx1(ji,jj) = 0.5 * ( uu(ji,jj,1,Kmm) + uu(ji-1,jj  ,1,Kmm) )
2387                     zoty1(ji,jj) = 0.5 * ( vv(ji,jj,1,Kmm) + vv(ji  ,jj-1,1,Kmm) ) 
2388                  END DO
2389               END DO
2390            CASE( 'weighted oce and ice' )      ! Ocean and Ice on C-grid ==> T 
2391               DO jj = 2, jpjm1
2392                  DO ji = fs_2, fs_jpim1   ! vector opt.
2393                     zotx1(ji,jj) = 0.5 * ( uu   (ji,jj,1,Kmm) + uu   (ji-1,jj  ,1,Kmm) ) * zfr_l(ji,jj) 
2394                     zoty1(ji,jj) = 0.5 * ( vv   (ji,jj,1,Kmm) + vv   (ji  ,jj-1,1,Kmm) ) * zfr_l(ji,jj)
2395                     zitx1(ji,jj) = 0.5 * ( u_ice(ji,jj  )     + u_ice(ji-1,jj    )     ) *  fr_i(ji,jj)
2396                     zity1(ji,jj) = 0.5 * ( v_ice(ji,jj  )     + v_ice(ji  ,jj-1  )     ) *  fr_i(ji,jj)
2397                  END DO
2398               END DO
2399               CALL lbc_lnk_multi( 'sbccpl', zitx1, 'T', -1., zity1, 'T', -1. )
2400            CASE( 'mixed oce-ice'        )      ! Ocean and Ice on C-grid ==> T
2401               DO jj = 2, jpjm1
2402                  DO ji = fs_2, fs_jpim1   ! vector opt.
2403                     zotx1(ji,jj) = 0.5 * ( uu   (ji,jj,1,Kmm) + uu   (ji-1,jj  ,1,Kmm) ) * zfr_l(ji,jj)   &
2404                        &         + 0.5 * ( u_ice(ji,jj  )     + u_ice(ji-1,jj    )     ) *  fr_i(ji,jj)
2405                     zoty1(ji,jj) = 0.5 * ( vv   (ji,jj,1,Kmm) + vv   (ji  ,jj-1,1,Kmm) ) * zfr_l(ji,jj)   &
2406                        &         + 0.5 * ( v_ice(ji,jj  )     + v_ice(ji  ,jj-1  )     ) *  fr_i(ji,jj)
2407                  END DO
2408               END DO
2409            END SELECT
2410            CALL lbc_lnk_multi( 'sbccpl', zotx1, ssnd(jps_ocx1)%clgrid, -1.,  zoty1, ssnd(jps_ocy1)%clgrid, -1. )
2411            !
2412         ENDIF
2413         !
2414         !
2415         IF( TRIM( sn_snd_crt%clvor ) == 'eastward-northward' ) THEN             ! Rotation of the components
2416            !                                                                     ! Ocean component
2417            CALL rot_rep( zotx1, zoty1, ssnd(jps_ocx1)%clgrid, 'ij->e', ztmp1 )       ! 1st component
2418            CALL rot_rep( zotx1, zoty1, ssnd(jps_ocx1)%clgrid, 'ij->n', ztmp2 )       ! 2nd component
2419            zotx1(:,:) = ztmp1(:,:)                                                   ! overwrite the components
2420            zoty1(:,:) = ztmp2(:,:)
2421            IF( ssnd(jps_ivx1)%laction ) THEN                                     ! Ice component
2422               CALL rot_rep( zitx1, zity1, ssnd(jps_ivx1)%clgrid, 'ij->e', ztmp1 )    ! 1st component
2423               CALL rot_rep( zitx1, zity1, ssnd(jps_ivx1)%clgrid, 'ij->n', ztmp2 )    ! 2nd component
2424               zitx1(:,:) = ztmp1(:,:)                                                ! overwrite the components
2425               zity1(:,:) = ztmp2(:,:)
2426            ENDIF
2427         ENDIF
2428         !
2429         ! spherical coordinates to cartesian -> 2 components to 3 components
2430         IF( TRIM( sn_snd_crt%clvref ) == 'cartesian' ) THEN
2431            ztmp1(:,:) = zotx1(:,:)                     ! ocean currents
2432            ztmp2(:,:) = zoty1(:,:)
2433            CALL oce2geo ( ztmp1, ztmp2, 'T', zotx1, zoty1, zotz1 )
2434            !
2435            IF( ssnd(jps_ivx1)%laction ) THEN           ! ice velocities
2436               ztmp1(:,:) = zitx1(:,:)
2437               ztmp1(:,:) = zity1(:,:)
2438               CALL oce2geo ( ztmp1, ztmp2, 'T', zitx1, zity1, zitz1 )
2439            ENDIF
2440         ENDIF
2441         !
2442         IF( ssnd(jps_ocx1)%laction )   CALL cpl_snd( jps_ocx1, isec, RESHAPE ( zotx1, (/jpi,jpj,1/) ), info )   ! ocean x current 1st grid
2443         IF( ssnd(jps_ocy1)%laction )   CALL cpl_snd( jps_ocy1, isec, RESHAPE ( zoty1, (/jpi,jpj,1/) ), info )   ! ocean y current 1st grid
2444         IF( ssnd(jps_ocz1)%laction )   CALL cpl_snd( jps_ocz1, isec, RESHAPE ( zotz1, (/jpi,jpj,1/) ), info )   ! ocean z current 1st grid
2445         !
2446         IF( ssnd(jps_ivx1)%laction )   CALL cpl_snd( jps_ivx1, isec, RESHAPE ( zitx1, (/jpi,jpj,1/) ), info )   ! ice   x current 1st grid
2447         IF( ssnd(jps_ivy1)%laction )   CALL cpl_snd( jps_ivy1, isec, RESHAPE ( zity1, (/jpi,jpj,1/) ), info )   ! ice   y current 1st grid
2448         IF( ssnd(jps_ivz1)%laction )   CALL cpl_snd( jps_ivz1, isec, RESHAPE ( zitz1, (/jpi,jpj,1/) ), info )   ! ice   z current 1st grid
2449         !
2450      ENDIF
2451      !
2452      !                                                      ! ------------------------- !
2453      !                                                      !  Surface current to waves !
2454      !                                                      ! ------------------------- !
2455      IF( ssnd(jps_ocxw)%laction .OR. ssnd(jps_ocyw)%laction ) THEN 
2456          !     
2457          !                                                  j+1  j     -----V---F
2458          ! surface velocity always sent from T point                    !       |
2459          !                                                       j      |   T   U
2460          !                                                              |       |
2461          !                                                   j   j-1   -I-------|
2462          !                                               (for I)        |       |
2463          !                                                             i-1  i   i
2464          !                                                              i      i+1 (for I)
2465          SELECT CASE( TRIM( sn_snd_crtw%cldes ) ) 
2466          CASE( 'oce only'             )      ! C-grid ==> T
2467             DO jj = 2, jpjm1 
2468                DO ji = fs_2, fs_jpim1   ! vector opt.
2469                   zotx1(ji,jj) = 0.5 * ( uu(ji,jj,1,Kmm) + uu(ji-1,jj  ,1,Kmm) ) 
2470                   zoty1(ji,jj) = 0.5 * ( vv(ji,jj,1,Kmm) + vv(ji , jj-1,1,Kmm) ) 
2471                END DO
2472             END DO
2473          CASE( 'weighted oce and ice' )      ! Ocean and Ice on C-grid ==> T   
2474             DO jj = 2, jpjm1 
2475                DO ji = fs_2, fs_jpim1   ! vector opt.
2476                   zotx1(ji,jj) = 0.5 * ( uu   (ji,jj,1,Kmm) + uu   (ji-1,jj  ,1,Kmm) ) * zfr_l(ji,jj)   
2477                   zoty1(ji,jj) = 0.5 * ( vv   (ji,jj,1,Kmm) + vv   (ji  ,jj-1,1,Kmm) ) * zfr_l(ji,jj) 
2478                   zitx1(ji,jj) = 0.5 * ( u_ice(ji,jj  ) + u_ice(ji-1,jj    ) ) *  fr_i(ji,jj) 
2479                   zity1(ji,jj) = 0.5 * ( v_ice(ji,jj  ) + v_ice(ji  ,jj-1  ) ) *  fr_i(ji,jj) 
2480                END DO
2481             END DO
2482             CALL lbc_lnk_multi( 'sbccpl', zitx1, 'T', -1.,  zity1, 'T', -1. ) 
2483          CASE( 'mixed oce-ice'        )      ! Ocean and Ice on C-grid ==> T 
2484             DO jj = 2, jpjm1 
2485                DO ji = fs_2, fs_jpim1   ! vector opt.
2486                   zotx1(ji,jj) = 0.5 * ( uu   (ji,jj,1,Kmm) + uu   (ji-1,jj  ,1,Kmm) ) * zfr_l(ji,jj)   & 
2487                      &         + 0.5 * ( u_ice(ji,jj  ) + u_ice(ji-1,jj    ) ) *  fr_i(ji,jj) 
2488                   zoty1(ji,jj) = 0.5 * ( vv   (ji,jj,1,Kmm) + vv   (ji  ,jj-1,1,Kmm) ) * zfr_l(ji,jj)   & 
2489                      &         + 0.5 * ( v_ice(ji,jj  ) + v_ice(ji  ,jj-1  ) ) *  fr_i(ji,jj) 
2490                END DO
2491             END DO
2492          END SELECT
2493         CALL lbc_lnk_multi( 'sbccpl', zotx1, ssnd(jps_ocxw)%clgrid, -1., zoty1, ssnd(jps_ocyw)%clgrid, -1. ) 
2494         !
2495         !
2496         IF( TRIM( sn_snd_crtw%clvor ) == 'eastward-northward' ) THEN             ! Rotation of the components
2497         !                                                                        ! Ocean component
2498            CALL rot_rep( zotx1, zoty1, ssnd(jps_ocxw)%clgrid, 'ij->e', ztmp1 )       ! 1st component 
2499            CALL rot_rep( zotx1, zoty1, ssnd(jps_ocxw)%clgrid, 'ij->n', ztmp2 )       ! 2nd component 
2500            zotx1(:,:) = ztmp1(:,:)                                                   ! overwrite the components 
2501            zoty1(:,:) = ztmp2(:,:) 
2502            IF( ssnd(jps_ivx1)%laction ) THEN                                     ! Ice component
2503               CALL rot_rep( zitx1, zity1, ssnd(jps_ivx1)%clgrid, 'ij->e', ztmp1 )    ! 1st component 
2504               CALL rot_rep( zitx1, zity1, ssnd(jps_ivx1)%clgrid, 'ij->n', ztmp2 )    ! 2nd component 
2505               zitx1(:,:) = ztmp1(:,:)                                                ! overwrite the components 
2506               zity1(:,:) = ztmp2(:,:) 
2507            ENDIF
2508         ENDIF 
2509         !
2510!         ! spherical coordinates to cartesian -> 2 components to 3 components
2511!         IF( TRIM( sn_snd_crtw%clvref ) == 'cartesian' ) THEN
2512!            ztmp1(:,:) = zotx1(:,:)                     ! ocean currents
2513!            ztmp2(:,:) = zoty1(:,:)
2514!            CALL oce2geo ( ztmp1, ztmp2, 'T', zotx1, zoty1, zotz1 )
2515!            !
2516!            IF( ssnd(jps_ivx1)%laction ) THEN           ! ice velocities
2517!               ztmp1(:,:) = zitx1(:,:)
2518!               ztmp1(:,:) = zity1(:,:)
2519!               CALL oce2geo ( ztmp1, ztmp2, 'T', zitx1, zity1, zitz1 )
2520!            ENDIF
2521!         ENDIF
2522         !
2523         IF( ssnd(jps_ocxw)%laction )   CALL cpl_snd( jps_ocxw, isec, RESHAPE ( zotx1, (/jpi,jpj,1/) ), info )   ! ocean x current 1st grid
2524         IF( ssnd(jps_ocyw)%laction )   CALL cpl_snd( jps_ocyw, isec, RESHAPE ( zoty1, (/jpi,jpj,1/) ), info )   ! ocean y current 1st grid
2525         
2526      ENDIF 
2527      !
2528      IF( ssnd(jps_ficet)%laction ) THEN
2529         CALL cpl_snd( jps_ficet, isec, RESHAPE ( fr_i, (/jpi,jpj,1/) ), info ) 
2530      ENDIF 
2531      !                                                      ! ------------------------- !
2532      !                                                      !   Water levels to waves   !
2533      !                                                      ! ------------------------- !
2534      IF( ssnd(jps_wlev)%laction ) THEN
2535         IF( ln_apr_dyn ) THEN 
2536            IF( kt /= nit000 ) THEN 
2537               ztmp1(:,:) = ssh(:,:,Kbb) - 0.5 * ( ssh_ib(:,:) + ssh_ibb(:,:) ) 
2538            ELSE 
2539               ztmp1(:,:) = ssh(:,:,Kbb) 
2540            ENDIF 
2541         ELSE 
2542            ztmp1(:,:) = ssh(:,:,Kmm) 
2543         ENDIF 
2544         CALL cpl_snd( jps_wlev  , isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info ) 
2545      ENDIF 
2546      !
2547      !  Fields sent by OPA to SAS when doing OPA<->SAS coupling
2548      !                                                        ! SSH
2549      IF( ssnd(jps_ssh )%laction )  THEN
2550         !                          ! removed inverse barometer ssh when Patm
2551         !                          forcing is used (for sea-ice dynamics)
2552         IF( ln_apr_dyn ) THEN   ;   ztmp1(:,:) = ssh(:,:,Kbb) - 0.5 * ( ssh_ib(:,:) + ssh_ibb(:,:) )
2553         ELSE                    ;   ztmp1(:,:) = ssh(:,:,Kmm)
2554         ENDIF
2555         CALL cpl_snd( jps_ssh   , isec, RESHAPE ( ztmp1            , (/jpi,jpj,1/) ), info )
2556
2557      ENDIF
2558      !                                                        ! SSS
2559      IF( ssnd(jps_soce  )%laction )  THEN
2560         CALL cpl_snd( jps_soce  , isec, RESHAPE ( ts(:,:,1,jp_sal,Kmm), (/jpi,jpj,1/) ), info )
2561      ENDIF
2562      !                                                        ! first T level thickness
2563      IF( ssnd(jps_e3t1st )%laction )  THEN
2564         CALL cpl_snd( jps_e3t1st, isec, RESHAPE ( e3t(:,:,1,Kmm)   , (/jpi,jpj,1/) ), info )
2565      ENDIF
2566      !                                                        ! Qsr fraction
2567      IF( ssnd(jps_fraqsr)%laction )  THEN
2568         CALL cpl_snd( jps_fraqsr, isec, RESHAPE ( fraqsr_1lev(:,:) , (/jpi,jpj,1/) ), info )
2569      ENDIF
2570      !
2571      !  Fields sent by SAS to OPA when OASIS coupling
2572      !                                                        ! Solar heat flux
2573      IF( ssnd(jps_qsroce)%laction )  CALL cpl_snd( jps_qsroce, isec, RESHAPE ( qsr , (/jpi,jpj,1/) ), info )
2574      IF( ssnd(jps_qnsoce)%laction )  CALL cpl_snd( jps_qnsoce, isec, RESHAPE ( qns , (/jpi,jpj,1/) ), info )
2575      IF( ssnd(jps_oemp  )%laction )  CALL cpl_snd( jps_oemp  , isec, RESHAPE ( emp , (/jpi,jpj,1/) ), info )
2576      IF( ssnd(jps_sflx  )%laction )  CALL cpl_snd( jps_sflx  , isec, RESHAPE ( sfx , (/jpi,jpj,1/) ), info )
2577      IF( ssnd(jps_otx1  )%laction )  CALL cpl_snd( jps_otx1  , isec, RESHAPE ( utau, (/jpi,jpj,1/) ), info )
2578      IF( ssnd(jps_oty1  )%laction )  CALL cpl_snd( jps_oty1  , isec, RESHAPE ( vtau, (/jpi,jpj,1/) ), info )
2579      IF( ssnd(jps_rnf   )%laction )  CALL cpl_snd( jps_rnf   , isec, RESHAPE ( rnf , (/jpi,jpj,1/) ), info )
2580      IF( ssnd(jps_taum  )%laction )  CALL cpl_snd( jps_taum  , isec, RESHAPE ( taum, (/jpi,jpj,1/) ), info )
2581
2582#if defined key_si3
2583      !                                                      ! ------------------------- !
2584      !                                                      ! Sea surface freezing temp !
2585      !                                                      ! ------------------------- !
2586      ! needed by Met Office
2587      CALL eos_fzp(ts(:,:,1,jp_sal,Kmm), sstfrz)
2588      ztmp1(:,:) = sstfrz(:,:) + rt0
2589      IF( ssnd(jps_sstfrz)%laction )  CALL cpl_snd( jps_sstfrz, isec, RESHAPE ( ztmp1, (/jpi,jpj,1/) ), info)
2590#endif
2591      !
2592   END SUBROUTINE sbc_cpl_snd
2593   
2594   !!======================================================================
2595END MODULE sbccpl
Note: See TracBrowser for help on using the repository browser.