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.
limthd.F90 in branches/2015/dev_r5836_NOC3_vvl_by_default/NEMOGCM/NEMO/LIM_SRC_3 – NEMO

source: branches/2015/dev_r5836_NOC3_vvl_by_default/NEMOGCM/NEMO/LIM_SRC_3/limthd.F90 @ 5845

Last change on this file since 5845 was 5845, checked in by gm, 8 years ago

#1613: vvl by default: suppression of domzgr_substitute.h90

  • Property svn:keywords set to Id
File size: 36.6 KB
Line 
1MODULE limthd
2   !!======================================================================
3   !!                  ***  MODULE limthd   ***
4   !!  LIM-3 :   ice thermodynamic
5   !!======================================================================
6   !! History :  LIM  ! 2000-01 (M.A. Morales Maqueda, H. Goosse, T. Fichefet) LIM-1
7   !!            2.0  ! 2002-07 (C. Ethe, G. Madec)  LIM-2 (F90 rewriting)
8   !!            3.0  ! 2005-11 (M. Vancoppenolle)  LIM-3 : Multi-layer thermodynamics + salinity variations
9   !!             -   ! 2007-04 (M. Vancoppenolle) add lim_thd_glohec, lim_thd_con_dh and lim_thd_con_dif
10   !!            3.2  ! 2009-07 (M. Vancoppenolle, Y. Aksenov, G. Madec) bug correction in wfx_snw
11   !!            3.3  ! 2010-11 (G. Madec) corrected snow melting heat (due to factor betas)
12   !!            4.0  ! 2011-02 (G. Madec) dynamical allocation
13   !!             -   ! 2012-05 (C. Rousset) add penetration solar flux
14   !!----------------------------------------------------------------------
15#if defined key_lim3
16   !!----------------------------------------------------------------------
17   !!   'key_lim3'                                      LIM3 sea-ice model
18   !!----------------------------------------------------------------------
19   !!   lim_thd       : thermodynamic of sea ice
20   !!   lim_thd_init  : initialisation of sea-ice thermodynamic
21   !!----------------------------------------------------------------------
22   USE phycst         ! physical constants
23   USE dom_oce        ! ocean space and time domain variables
24   USE ice            ! LIM: sea-ice variables
25   USE sbc_oce        ! Surface boundary condition: ocean fields
26   USE sbc_ice        ! Surface boundary condition: ice fields
27   USE thd_ice        ! LIM thermodynamic sea-ice variables
28   USE dom_ice        ! LIM sea-ice domain
29   USE limthd_dif     ! LIM: thermodynamics, vertical diffusion
30   USE limthd_dh      ! LIM: thermodynamics, ice and snow thickness variation
31   USE limthd_sal     ! LIM: thermodynamics, ice salinity
32   USE limthd_ent     ! LIM: thermodynamics, ice enthalpy redistribution
33   USE limthd_lac     ! LIM-3 lateral accretion
34   USE limitd_th      ! remapping thickness distribution
35   USE limtab         ! LIM: 1D <==> 2D transformation
36   USE limvar         ! LIM: sea-ice variables
37   USE lbclnk         ! lateral boundary condition - MPP links
38   USE lib_mpp        ! MPP library
39   USE wrk_nemo       ! work arrays
40   USE in_out_manager ! I/O manager
41   USE prtctl         ! Print control
42   USE lib_fortran    ! Fortran utilities (allows no signed zero when 'key_nosignedzero' defined) 
43   USE timing         ! Timing
44   USE limcons        ! conservation tests
45   USE limctl
46
47   IMPLICIT NONE
48   PRIVATE
49
50   PUBLIC   lim_thd         ! called by limstp module
51   PUBLIC   lim_thd_init    ! called by sbc_lim_init
52
53   !! * Substitutions
54#  include "vectopt_loop_substitute.h90"
55   !!----------------------------------------------------------------------
56   !! NEMO/LIM3 3.3 , UCL - NEMO Consortium (2010)
57   !! $Id$
58   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
59   !!----------------------------------------------------------------------
60CONTAINS
61
62   SUBROUTINE lim_thd( kt )
63      !!-------------------------------------------------------------------
64      !!                ***  ROUTINE lim_thd  ***       
65      !! 
66      !! ** Purpose : This routine manages ice thermodynamics
67      !!         
68      !! ** Action : - Initialisation of some variables
69      !!             - Some preliminary computation (oceanic heat flux
70      !!               at the ice base, snow acc.,heat budget of the leads)
71      !!             - selection of the icy points and put them in an array
72      !!             - call lim_thd_dif  for vertical heat diffusion
73      !!             - call lim_thd_dh   for vertical ice growth and melt
74      !!             - call lim_thd_ent  for enthalpy remapping
75      !!             - call lim_thd_sal  for ice desalination
76      !!             - call lim_thd_temp to  retrieve temperature from ice enthalpy
77      !!             - back to the geographic grid
78      !!     
79      !! ** References :
80      !!---------------------------------------------------------------------
81      INTEGER, INTENT(in) :: kt    ! number of iteration
82      !!
83      INTEGER  :: ji, jj, jk, jl   ! dummy loop indices
84      INTEGER  :: nbpb             ! nb of icy pts for vertical thermo calculations
85      INTEGER  :: ii, ij           ! temporary dummy loop index
86      REAL(wp) :: zfric_u, zqld, zqfr
87      REAL(wp) :: zvi_b, zsmv_b, zei_b, zfs_b, zfw_b, zft_b 
88      REAL(wp), PARAMETER :: zfric_umin = 0._wp           ! lower bound for the friction velocity (cice value=5.e-04)
89      REAL(wp), PARAMETER :: zch        = 0.0057_wp       ! heat transfer coefficient
90      !
91      !!-------------------------------------------------------------------
92
93      IF( nn_timing == 1 )  CALL timing_start('limthd')
94
95      ! conservation test
96      IF( ln_limdiahsb ) CALL lim_cons_hsm(0, 'limthd', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
97
98      CALL lim_var_glo2eqv
99      !------------------------------------------------------------------------!
100      ! 1) Initialization of some variables                                    !
101      !------------------------------------------------------------------------!
102      ftr_ice(:,:,:) = 0._wp  ! part of solar radiation transmitted through the ice
103
104      !--------------------
105      ! 1.2) Heat content   
106      !--------------------
107      ! Change the units of heat content; from J/m2 to J/m3
108      DO jl = 1, jpl
109         DO jk = 1, nlay_i
110            DO jj = 1, jpj
111               DO ji = 1, jpi
112                  !0 if no ice and 1 if yes
113                  rswitch = MAX(  0._wp , SIGN( 1._wp , v_i(ji,jj,jl) - epsi20 )  )
114                  !Energy of melting q(S,T) [J.m-3]
115                  e_i(ji,jj,jk,jl) = rswitch * e_i(ji,jj,jk,jl) / MAX( v_i(ji,jj,jl) , epsi20 ) * REAL( nlay_i )
116               END DO
117            END DO
118         END DO
119         DO jk = 1, nlay_s
120            DO jj = 1, jpj
121               DO ji = 1, jpi
122                  !0 if no ice and 1 if yes
123                  rswitch = MAX(  0._wp , SIGN( 1._wp , v_s(ji,jj,jl) - epsi20 )  )
124                  !Energy of melting q(S,T) [J.m-3]
125                  e_s(ji,jj,jk,jl) = rswitch * e_s(ji,jj,jk,jl) / MAX( v_s(ji,jj,jl) , epsi20 ) * REAL( nlay_s )
126               END DO
127            END DO
128         END DO
129      END DO
130
131      ! 2) Partial computation of forcing for the thermodynamic sea ice model.      !
132      !-----------------------------------------------------------------------------!
133      DO jj = 1, jpj
134         DO ji = 1, jpi
135            rswitch  = tmask(ji,jj,1) * MAX( 0._wp , SIGN( 1._wp , at_i(ji,jj) - epsi10 ) ) ! 0 if no ice
136            !
137            !           !  solar irradiance transmission at the mixed layer bottom and used in the lead heat budget
138            !           !  practically no "direct lateral ablation"
139            !           
140            !           !  net downward heat flux from the ice to the ocean, expressed as a function of ocean
141            !           !  temperature and turbulent mixing (McPhee, 1992)
142            !
143            ! --- Energy received in the lead, zqld is defined everywhere (J.m-2) --- !
144            zqld =  tmask(ji,jj,1) * rdt_ice *  &
145               &    ( pfrld(ji,jj) * qsr_oce(ji,jj) * frq_m(ji,jj) + pfrld(ji,jj) * qns_oce(ji,jj) + qemp_oce(ji,jj) )
146
147            ! --- Energy needed to bring ocean surface layer until its freezing (<0, J.m-2) --- !
148            zqfr = tmask(ji,jj,1) * rau0 * rcp * e3t_m(ji,jj) * ( t_bo(ji,jj) - ( sst_m(ji,jj) + rt0 ) )
149
150            ! --- Energy from the turbulent oceanic heat flux (W/m2) --- !
151            zfric_u      = MAX( SQRT( ust2s(ji,jj) ), zfric_umin ) 
152            fhtur(ji,jj) = MAX( 0._wp, rswitch * rau0 * rcp * zch  * zfric_u * ( ( sst_m(ji,jj) + rt0 ) - t_bo(ji,jj) ) ) ! W.m-2
153            fhtur(ji,jj) = rswitch * MIN( fhtur(ji,jj), - zqfr * r1_rdtice / MAX( at_i(ji,jj), epsi10 ) )
154            ! upper bound for fhtur: the heat retrieved from the ocean must be smaller than the heat necessary to reach
155            !                        the freezing point, so that we do not have SST < T_freeze
156            !                        This implies: - ( fhtur(ji,jj) * at_i(ji,jj) * rtdice ) - zqfr >= 0
157
158            !-- Energy Budget of the leads (J.m-2). Must be < 0 to form ice
159            qlead(ji,jj) = MIN( 0._wp , zqld - ( fhtur(ji,jj) * at_i(ji,jj) * rdt_ice ) - zqfr )
160
161            ! If there is ice and leads are warming, then transfer energy from the lead budget and use it for bottom melting
162            IF( zqld > 0._wp ) THEN
163               fhld (ji,jj) = rswitch * zqld * r1_rdtice / MAX( at_i(ji,jj), epsi10 ) ! divided by at_i since this is (re)multiplied by a_i in limthd_dh.F90
164               qlead(ji,jj) = 0._wp
165            ELSE
166               fhld (ji,jj) = 0._wp
167            ENDIF
168            !
169            ! -----------------------------------------
170            ! Net heat flux on top of ice-ocean [W.m-2]
171            ! -----------------------------------------
172            hfx_in(ji,jj) = qns_tot(ji,jj) + qsr_tot(ji,jj) 
173
174            ! -----------------------------------------------------------------------------
175            ! Net heat flux on top of the ocean after ice thermo (1st step) [W.m-2]
176            ! -----------------------------------------------------------------------------
177            !     First  step here              :  non solar + precip - qlead - qturb
178            !     Second step in limthd_dh      :  heat remaining if total melt (zq_rema)
179            !     Third  step in limsbc         :  heat from ice-ocean mass exchange (zf_mass) + solar
180            hfx_out(ji,jj) =   pfrld(ji,jj) * qns_oce(ji,jj) + qemp_oce(ji,jj)  &  ! Non solar heat flux received by the ocean               
181               &             - qlead(ji,jj) * r1_rdtice                         &  ! heat flux taken from the ocean where there is open water ice formation
182               &             - at_i(ji,jj) * fhtur(ji,jj)                       &  ! heat flux taken by turbulence
183               &             - at_i(ji,jj) *  fhld(ji,jj)                          ! heat flux taken during bottom growth/melt
184                                                                                   !    (fhld should be 0 while bott growth)
185         END DO
186      END DO
187
188      !------------------------------------------------------------------------------!
189      ! 3) Select icy points and fulfill arrays for the vectorial grid.           
190      !------------------------------------------------------------------------------!
191
192      DO jl = 1, jpl      !loop over ice categories
193
194         IF( kt == nit000 .AND. lwp ) THEN
195            WRITE(numout,*) ' lim_thd : transfer to 1D vectors. Category no : ', jl 
196            WRITE(numout,*) ' ~~~~~~~~'
197         ENDIF
198
199         nbpb = 0
200         DO jj = 1, jpj
201            DO ji = 1, jpi
202               IF ( a_i(ji,jj,jl) > epsi10 ) THEN     
203                  nbpb      = nbpb  + 1
204                  npb(nbpb) = (jj - 1) * jpi + ji
205               ENDIF
206            END DO
207         END DO
208
209         ! debug point to follow
210         jiindex_1d = 0
211         IF( ln_icectl ) THEN
212            DO ji = mi0(iiceprt), mi1(iiceprt)
213               DO jj = mj0(jiceprt), mj1(jiceprt)
214                  jiindex_1d = (jj - 1) * jpi + ji
215                  WRITE(numout,*) ' lim_thd : Category no : ', jl 
216               END DO
217            END DO
218         ENDIF
219
220         !------------------------------------------------------------------------------!
221         ! 4) Thermodynamic computation
222         !------------------------------------------------------------------------------!
223
224         IF( lk_mpp )   CALL mpp_ini_ice( nbpb , numout )
225
226         IF( nbpb > 0 ) THEN  ! If there is no ice, do nothing.
227
228            !-------------------------!
229            ! --- Move to 1D arrays ---
230            !-------------------------!
231            CALL lim_thd_1d2d( nbpb, jl, 1 )
232
233            !--------------------------------------!
234            ! --- Ice/Snow Temperature profile --- !
235            !--------------------------------------!
236            CALL lim_thd_dif( 1, nbpb )
237
238            !---------------------------------!
239            ! --- Ice/Snow thickness ---      !
240            !---------------------------------!
241            CALL lim_thd_dh( 1, nbpb )   
242
243            ! --- Ice enthalpy remapping --- !
244            CALL lim_thd_ent( 1, nbpb, q_i_1d(1:nbpb,:) ) 
245                                           
246            !---------------------------------!
247            ! --- Ice salinity ---            !
248            !---------------------------------!
249            CALL lim_thd_sal( 1, nbpb )   
250
251            !---------------------------------!
252            ! --- temperature update ---      !
253            !---------------------------------!
254            CALL lim_thd_temp( 1, nbpb )
255
256            !------------------------------------!
257            ! --- lateral melting if monocat --- !
258            !------------------------------------!
259            IF ( ( nn_monocat == 1 .OR. nn_monocat == 4 ) .AND. jpl == 1 ) THEN
260               CALL lim_thd_lam( 1, nbpb )
261            END IF
262
263            !-------------------------!
264            ! --- Move to 2D arrays ---
265            !-------------------------!
266            CALL lim_thd_1d2d( nbpb, jl, 2 )
267
268            !
269            IF( lk_mpp )   CALL mpp_comm_free( ncomm_ice ) !RB necessary ??
270         ENDIF
271         !
272      END DO !jl
273
274      !------------------------------------------------------------------------------!
275      ! 5) Global variables, diagnostics
276      !------------------------------------------------------------------------------!
277
278      !------------------------
279      ! Ice heat content             
280      !------------------------
281      ! Enthalpies are global variables we have to readjust the units (heat content in J/m2)
282      DO jl = 1, jpl
283         DO jk = 1, nlay_i
284            e_i(:,:,jk,jl) = e_i(:,:,jk,jl) * a_i(:,:,jl) * ht_i(:,:,jl) * r1_nlay_i
285         END DO
286      END DO
287
288      !------------------------
289      ! Snow heat content             
290      !------------------------
291      ! Enthalpies are global variables we have to readjust the units (heat content in J/m2)
292      DO jl = 1, jpl
293         DO jk = 1, nlay_s
294            e_s(:,:,jk,jl) = e_s(:,:,jk,jl) * a_i(:,:,jl) * ht_s(:,:,jl) * r1_nlay_s
295         END DO
296      END DO
297 
298      !----------------------------------
299      ! Change thickness to volume
300      !----------------------------------
301      v_i(:,:,:)   = ht_i(:,:,:) * a_i(:,:,:)
302      v_s(:,:,:)   = ht_s(:,:,:) * a_i(:,:,:)
303      smv_i(:,:,:) = sm_i(:,:,:) * v_i(:,:,:)
304
305      ! update ice age (in case a_i changed, i.e. becomes 0 or lateral melting in monocat)
306      DO jl  = 1, jpl
307         DO jj = 1, jpj
308            DO ji = 1, jpi
309               rswitch = MAX( 0._wp , SIGN( 1._wp, a_i_b(ji,jj,jl) - epsi10 ) )
310               oa_i(ji,jj,jl) = rswitch * oa_i(ji,jj,jl) * a_i(ji,jj,jl) / MAX( a_i_b(ji,jj,jl), epsi10 )
311            END DO
312         END DO
313      END DO
314
315      CALL lim_var_zapsmall
316
317      !--------------------------------------------
318      ! Diagnostic thermodynamic growth rates
319      !--------------------------------------------
320      IF( ln_icectl )   CALL lim_prt( kt, iiceprt, jiceprt, 1, ' - ice thermodyn. - ' )   ! control print
321
322      IF(ln_ctl) THEN            ! Control print
323         CALL prt_ctl_info(' ')
324         CALL prt_ctl_info(' - Cell values : ')
325         CALL prt_ctl_info('   ~~~~~~~~~~~~~ ')
326         CALL prt_ctl(tab2d_1=e1e2t, clinfo1=' lim_thd  : cell area :')
327         CALL prt_ctl(tab2d_1=at_i , clinfo1=' lim_thd  : at_i      :')
328         CALL prt_ctl(tab2d_1=vt_i , clinfo1=' lim_thd  : vt_i      :')
329         CALL prt_ctl(tab2d_1=vt_s , clinfo1=' lim_thd  : vt_s      :')
330         DO jl = 1, jpl
331            CALL prt_ctl_info(' ')
332            CALL prt_ctl_info(' - Category : ', ivar1=jl)
333            CALL prt_ctl_info('   ~~~~~~~~~~')
334            CALL prt_ctl(tab2d_1=a_i   (:,:,jl)   , clinfo1= ' lim_thd  : a_i      : ')
335            CALL prt_ctl(tab2d_1=ht_i  (:,:,jl)   , clinfo1= ' lim_thd  : ht_i     : ')
336            CALL prt_ctl(tab2d_1=ht_s  (:,:,jl)   , clinfo1= ' lim_thd  : ht_s     : ')
337            CALL prt_ctl(tab2d_1=v_i   (:,:,jl)   , clinfo1= ' lim_thd  : v_i      : ')
338            CALL prt_ctl(tab2d_1=v_s   (:,:,jl)   , clinfo1= ' lim_thd  : v_s      : ')
339            CALL prt_ctl(tab2d_1=e_s   (:,:,1,jl) , clinfo1= ' lim_thd  : e_s      : ')
340            CALL prt_ctl(tab2d_1=t_su  (:,:,jl)   , clinfo1= ' lim_thd  : t_su     : ')
341            CALL prt_ctl(tab2d_1=t_s   (:,:,1,jl) , clinfo1= ' lim_thd  : t_snow   : ')
342            CALL prt_ctl(tab2d_1=sm_i  (:,:,jl)   , clinfo1= ' lim_thd  : sm_i     : ')
343            CALL prt_ctl(tab2d_1=smv_i (:,:,jl)   , clinfo1= ' lim_thd  : smv_i    : ')
344            DO jk = 1, nlay_i
345               CALL prt_ctl_info(' ')
346               CALL prt_ctl_info(' - Layer : ', ivar1=jk)
347               CALL prt_ctl_info('   ~~~~~~~')
348               CALL prt_ctl(tab2d_1=t_i(:,:,jk,jl) , clinfo1= ' lim_thd  : t_i      : ')
349               CALL prt_ctl(tab2d_1=e_i(:,:,jk,jl) , clinfo1= ' lim_thd  : e_i      : ')
350            END DO
351         END DO
352      ENDIF
353      !
354      !
355      IF( ln_limdiahsb ) CALL lim_cons_hsm(1, 'limthd', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
356
357      !------------------------------------------------------------------------------|
358      !  6) Transport of ice between thickness categories.                           |
359      !------------------------------------------------------------------------------|
360      ! Given thermodynamic growth rates, transport ice between thickness categories.
361      IF( ln_limdiahsb ) CALL lim_cons_hsm(0, 'limitd_th_rem', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
362
363      IF( jpl > 1 )      CALL lim_itd_th_rem( 1, jpl, kt )
364
365      IF( ln_limdiahsb ) CALL lim_cons_hsm(1, 'limitd_th_rem', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
366
367      !------------------------------------------------------------------------------|
368      !  7) Add frazil ice growing in leads.
369      !------------------------------------------------------------------------------|
370      IF( ln_limdiahsb ) CALL lim_cons_hsm(0, 'limthd_lac', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
371
372      CALL lim_thd_lac
373     
374      IF( ln_limdiahsb ) CALL lim_cons_hsm(1, 'limthd_lac', zvi_b, zsmv_b, zei_b, zfw_b, zfs_b, zft_b)
375
376      ! Control print
377      IF(ln_ctl) THEN
378         CALL lim_var_glo2eqv
379
380         CALL prt_ctl_info(' ')
381         CALL prt_ctl_info(' - Cell values : ')
382         CALL prt_ctl_info('   ~~~~~~~~~~~~~ ')
383         CALL prt_ctl(tab2d_1=e1e2t, clinfo1=' lim_itd_th  : cell area :')
384         CALL prt_ctl(tab2d_1=at_i , clinfo1=' lim_itd_th  : at_i      :')
385         CALL prt_ctl(tab2d_1=vt_i , clinfo1=' lim_itd_th  : vt_i      :')
386         CALL prt_ctl(tab2d_1=vt_s , clinfo1=' lim_itd_th  : vt_s      :')
387         DO jl = 1, jpl
388            CALL prt_ctl_info(' ')
389            CALL prt_ctl_info(' - Category : ', ivar1=jl)
390            CALL prt_ctl_info('   ~~~~~~~~~~')
391            CALL prt_ctl(tab2d_1=a_i   (:,:,jl)   , clinfo1= ' lim_itd_th  : a_i      : ')
392            CALL prt_ctl(tab2d_1=ht_i  (:,:,jl)   , clinfo1= ' lim_itd_th  : ht_i     : ')
393            CALL prt_ctl(tab2d_1=ht_s  (:,:,jl)   , clinfo1= ' lim_itd_th  : ht_s     : ')
394            CALL prt_ctl(tab2d_1=v_i   (:,:,jl)   , clinfo1= ' lim_itd_th  : v_i      : ')
395            CALL prt_ctl(tab2d_1=v_s   (:,:,jl)   , clinfo1= ' lim_itd_th  : v_s      : ')
396            CALL prt_ctl(tab2d_1=e_s   (:,:,1,jl) , clinfo1= ' lim_itd_th  : e_s      : ')
397            CALL prt_ctl(tab2d_1=t_su  (:,:,jl)   , clinfo1= ' lim_itd_th  : t_su     : ')
398            CALL prt_ctl(tab2d_1=t_s   (:,:,1,jl) , clinfo1= ' lim_itd_th  : t_snow   : ')
399            CALL prt_ctl(tab2d_1=sm_i  (:,:,jl)   , clinfo1= ' lim_itd_th  : sm_i     : ')
400            CALL prt_ctl(tab2d_1=smv_i (:,:,jl)   , clinfo1= ' lim_itd_th  : smv_i    : ')
401            DO jk = 1, nlay_i
402               CALL prt_ctl_info(' ')
403               CALL prt_ctl_info(' - Layer : ', ivar1=jk)
404               CALL prt_ctl_info('   ~~~~~~~')
405               CALL prt_ctl(tab2d_1=t_i(:,:,jk,jl) , clinfo1= ' lim_itd_th  : t_i      : ')
406               CALL prt_ctl(tab2d_1=e_i(:,:,jk,jl) , clinfo1= ' lim_itd_th  : e_i      : ')
407            END DO
408         END DO
409      ENDIF
410      !
411      IF( nn_timing == 1 )  CALL timing_stop('limthd')
412
413   END SUBROUTINE lim_thd 
414
415 
416   SUBROUTINE lim_thd_temp( kideb, kiut )
417      !!-----------------------------------------------------------------------
418      !!                   ***  ROUTINE lim_thd_temp ***
419      !!                 
420      !! ** Purpose :   Computes sea ice temperature (Kelvin) from enthalpy
421      !!
422      !! ** Method  :   Formula (Bitz and Lipscomb, 1999)
423      !!-------------------------------------------------------------------
424      INTEGER, INTENT(in) ::   kideb, kiut   ! bounds for the spatial loop
425      !!
426      INTEGER  ::   ji, jk   ! dummy loop indices
427      REAL(wp) ::   ztmelts, zaaa, zbbb, zccc, zdiscrim  ! local scalar
428      !!-------------------------------------------------------------------
429      ! Recover ice temperature
430      DO jk = 1, nlay_i
431         DO ji = kideb, kiut
432            ztmelts       =  -tmut * s_i_1d(ji,jk) + rt0
433            ! Conversion q(S,T) -> T (second order equation)
434            zaaa          =  cpic
435            zbbb          =  ( rcp - cpic ) * ( ztmelts - rt0 ) + q_i_1d(ji,jk) * r1_rhoic - lfus
436            zccc          =  lfus * ( ztmelts - rt0 )
437            zdiscrim      =  SQRT( MAX( zbbb * zbbb - 4._wp * zaaa * zccc, 0._wp ) )
438            t_i_1d(ji,jk) =  rt0 - ( zbbb + zdiscrim ) / ( 2._wp * zaaa )
439           
440            ! mask temperature
441            rswitch       =  1._wp - MAX( 0._wp , SIGN( 1._wp , - ht_i_1d(ji) ) ) 
442            t_i_1d(ji,jk) =  rswitch * t_i_1d(ji,jk) + ( 1._wp - rswitch ) * rt0
443         END DO
444      END DO
445
446   END SUBROUTINE lim_thd_temp
447
448   SUBROUTINE lim_thd_lam( kideb, kiut )
449      !!-----------------------------------------------------------------------
450      !!                   ***  ROUTINE lim_thd_lam ***
451      !!                 
452      !! ** Purpose :   Lateral melting in case monocategory
453      !!                          ( dA = A/2h dh )
454      !!-----------------------------------------------------------------------
455      INTEGER, INTENT(in) ::   kideb, kiut        ! bounds for the spatial loop
456      INTEGER             ::   ji                 ! dummy loop indices
457      REAL(wp)            ::   zhi_bef            ! ice thickness before thermo
458      REAL(wp)            ::   zdh_mel, zda_mel   ! net melting
459      REAL(wp)            ::   zvi, zvs           ! ice/snow volumes
460
461      DO ji = kideb, kiut
462         zdh_mel = MIN( 0._wp, dh_i_surf(ji) + dh_i_bott(ji) + dh_snowice(ji) )
463         IF( zdh_mel < 0._wp .AND. a_i_1d(ji) > 0._wp )  THEN
464            zvi          = a_i_1d(ji) * ht_i_1d(ji)
465            zvs          = a_i_1d(ji) * ht_s_1d(ji)
466            ! lateral melting = concentration change
467            zhi_bef     = ht_i_1d(ji) - zdh_mel
468            rswitch     = MAX( 0._wp , SIGN( 1._wp , zhi_bef - epsi20 ) )
469            zda_mel     = rswitch * a_i_1d(ji) * zdh_mel / ( 2._wp * MAX( zhi_bef, epsi20 ) )
470            a_i_1d(ji)  = MAX( epsi20, a_i_1d(ji) + zda_mel ) 
471             ! adjust thickness
472            ht_i_1d(ji) = zvi / a_i_1d(ji)           
473            ht_s_1d(ji) = zvs / a_i_1d(ji)           
474            ! retrieve total concentration
475            at_i_1d(ji) = a_i_1d(ji)
476         END IF
477      END DO
478     
479   END SUBROUTINE lim_thd_lam
480
481   SUBROUTINE lim_thd_1d2d( nbpb, jl, kn )
482      !!-----------------------------------------------------------------------
483      !!                   ***  ROUTINE lim_thd_1d2d ***
484      !!                 
485      !! ** Purpose :   move arrays from 1d to 2d and the reverse
486      !!-----------------------------------------------------------------------
487      INTEGER, INTENT(in) ::   kn       ! 1= from 2D to 1D
488                                        ! 2= from 1D to 2D
489      INTEGER, INTENT(in) ::   nbpb     ! size of 1D arrays
490      INTEGER, INTENT(in) ::   jl       ! ice cat
491      INTEGER             ::   jk       ! dummy loop indices
492
493      SELECT CASE( kn )
494
495      CASE( 1 )
496
497         CALL tab_2d_1d( nbpb, at_i_1d     (1:nbpb), at_i            , jpi, jpj, npb(1:nbpb) )
498         CALL tab_2d_1d( nbpb, a_i_1d      (1:nbpb), a_i(:,:,jl)     , jpi, jpj, npb(1:nbpb) )
499         CALL tab_2d_1d( nbpb, ht_i_1d     (1:nbpb), ht_i(:,:,jl)    , jpi, jpj, npb(1:nbpb) )
500         CALL tab_2d_1d( nbpb, ht_s_1d     (1:nbpb), ht_s(:,:,jl)    , jpi, jpj, npb(1:nbpb) )
501         
502         CALL tab_2d_1d( nbpb, t_su_1d     (1:nbpb), t_su(:,:,jl)    , jpi, jpj, npb(1:nbpb) )
503         CALL tab_2d_1d( nbpb, sm_i_1d     (1:nbpb), sm_i(:,:,jl)    , jpi, jpj, npb(1:nbpb) )
504         DO jk = 1, nlay_s
505            CALL tab_2d_1d( nbpb, t_s_1d(1:nbpb,jk), t_s(:,:,jk,jl)  , jpi, jpj, npb(1:nbpb) )
506            CALL tab_2d_1d( nbpb, q_s_1d(1:nbpb,jk), e_s(:,:,jk,jl)  , jpi, jpj, npb(1:nbpb) )
507         END DO
508         DO jk = 1, nlay_i
509            CALL tab_2d_1d( nbpb, t_i_1d(1:nbpb,jk), t_i(:,:,jk,jl)  , jpi, jpj, npb(1:nbpb) )
510            CALL tab_2d_1d( nbpb, q_i_1d(1:nbpb,jk), e_i(:,:,jk,jl)  , jpi, jpj, npb(1:nbpb) )
511            CALL tab_2d_1d( nbpb, s_i_1d(1:nbpb,jk), s_i(:,:,jk,jl)  , jpi, jpj, npb(1:nbpb) )
512         END DO
513         
514         CALL tab_2d_1d( nbpb, qprec_ice_1d(1:nbpb), qprec_ice(:,:) , jpi, jpj, npb(1:nbpb) )
515         CALL tab_2d_1d( nbpb, qsr_ice_1d (1:nbpb), qsr_ice(:,:,jl) , jpi, jpj, npb(1:nbpb) )
516         CALL tab_2d_1d( nbpb, fr1_i0_1d  (1:nbpb), fr1_i0          , jpi, jpj, npb(1:nbpb) )
517         CALL tab_2d_1d( nbpb, fr2_i0_1d  (1:nbpb), fr2_i0          , jpi, jpj, npb(1:nbpb) )
518         CALL tab_2d_1d( nbpb, qns_ice_1d (1:nbpb), qns_ice(:,:,jl) , jpi, jpj, npb(1:nbpb) )
519         CALL tab_2d_1d( nbpb, ftr_ice_1d (1:nbpb), ftr_ice(:,:,jl) , jpi, jpj, npb(1:nbpb) )
520         CALL tab_2d_1d( nbpb, evap_ice_1d (1:nbpb), evap_ice(:,:,jl), jpi, jpj, npb(1:nbpb) )
521         CALL tab_2d_1d( nbpb, dqns_ice_1d(1:nbpb), dqns_ice(:,:,jl), jpi, jpj, npb(1:nbpb) )
522         CALL tab_2d_1d( nbpb, t_bo_1d     (1:nbpb), t_bo            , jpi, jpj, npb(1:nbpb) )
523         CALL tab_2d_1d( nbpb, sprecip_1d (1:nbpb), sprecip         , jpi, jpj, npb(1:nbpb) ) 
524         CALL tab_2d_1d( nbpb, fhtur_1d   (1:nbpb), fhtur           , jpi, jpj, npb(1:nbpb) )
525         CALL tab_2d_1d( nbpb, qlead_1d   (1:nbpb), qlead           , jpi, jpj, npb(1:nbpb) )
526         CALL tab_2d_1d( nbpb, fhld_1d    (1:nbpb), fhld            , jpi, jpj, npb(1:nbpb) )
527         
528         CALL tab_2d_1d( nbpb, wfx_snw_1d (1:nbpb), wfx_snw         , jpi, jpj, npb(1:nbpb) )
529         CALL tab_2d_1d( nbpb, wfx_sub_1d (1:nbpb), wfx_sub         , jpi, jpj, npb(1:nbpb) )
530         
531         CALL tab_2d_1d( nbpb, wfx_bog_1d (1:nbpb), wfx_bog         , jpi, jpj, npb(1:nbpb) )
532         CALL tab_2d_1d( nbpb, wfx_bom_1d (1:nbpb), wfx_bom         , jpi, jpj, npb(1:nbpb) )
533         CALL tab_2d_1d( nbpb, wfx_sum_1d (1:nbpb), wfx_sum         , jpi, jpj, npb(1:nbpb) )
534         CALL tab_2d_1d( nbpb, wfx_sni_1d (1:nbpb), wfx_sni         , jpi, jpj, npb(1:nbpb) )
535         CALL tab_2d_1d( nbpb, wfx_res_1d (1:nbpb), wfx_res         , jpi, jpj, npb(1:nbpb) )
536         CALL tab_2d_1d( nbpb, wfx_spr_1d (1:nbpb), wfx_spr         , jpi, jpj, npb(1:nbpb) )
537         
538         CALL tab_2d_1d( nbpb, sfx_bog_1d (1:nbpb), sfx_bog         , jpi, jpj, npb(1:nbpb) )
539         CALL tab_2d_1d( nbpb, sfx_bom_1d (1:nbpb), sfx_bom         , jpi, jpj, npb(1:nbpb) )
540         CALL tab_2d_1d( nbpb, sfx_sum_1d (1:nbpb), sfx_sum         , jpi, jpj, npb(1:nbpb) )
541         CALL tab_2d_1d( nbpb, sfx_sni_1d (1:nbpb), sfx_sni         , jpi, jpj, npb(1:nbpb) )
542         CALL tab_2d_1d( nbpb, sfx_bri_1d (1:nbpb), sfx_bri         , jpi, jpj, npb(1:nbpb) )
543         CALL tab_2d_1d( nbpb, sfx_res_1d (1:nbpb), sfx_res         , jpi, jpj, npb(1:nbpb) )
544         
545         CALL tab_2d_1d( nbpb, hfx_thd_1d (1:nbpb), hfx_thd         , jpi, jpj, npb(1:nbpb) )
546         CALL tab_2d_1d( nbpb, hfx_spr_1d (1:nbpb), hfx_spr         , jpi, jpj, npb(1:nbpb) )
547         CALL tab_2d_1d( nbpb, hfx_sum_1d (1:nbpb), hfx_sum         , jpi, jpj, npb(1:nbpb) )
548         CALL tab_2d_1d( nbpb, hfx_bom_1d (1:nbpb), hfx_bom         , jpi, jpj, npb(1:nbpb) )
549         CALL tab_2d_1d( nbpb, hfx_bog_1d (1:nbpb), hfx_bog         , jpi, jpj, npb(1:nbpb) )
550         CALL tab_2d_1d( nbpb, hfx_dif_1d (1:nbpb), hfx_dif         , jpi, jpj, npb(1:nbpb) )
551         CALL tab_2d_1d( nbpb, hfx_opw_1d (1:nbpb), hfx_opw         , jpi, jpj, npb(1:nbpb) )
552         CALL tab_2d_1d( nbpb, hfx_snw_1d (1:nbpb), hfx_snw         , jpi, jpj, npb(1:nbpb) )
553         CALL tab_2d_1d( nbpb, hfx_sub_1d (1:nbpb), hfx_sub         , jpi, jpj, npb(1:nbpb) )
554         CALL tab_2d_1d( nbpb, hfx_err_1d (1:nbpb), hfx_err         , jpi, jpj, npb(1:nbpb) )
555         CALL tab_2d_1d( nbpb, hfx_res_1d (1:nbpb), hfx_res         , jpi, jpj, npb(1:nbpb) )
556         CALL tab_2d_1d( nbpb, hfx_err_dif_1d (1:nbpb), hfx_err_dif , jpi, jpj, npb(1:nbpb) )
557         CALL tab_2d_1d( nbpb, hfx_err_rem_1d (1:nbpb), hfx_err_rem , jpi, jpj, npb(1:nbpb) )
558
559      CASE( 2 )
560
561         CALL tab_1d_2d( nbpb, at_i          , npb, at_i_1d    (1:nbpb)   , jpi, jpj )
562         CALL tab_1d_2d( nbpb, ht_i(:,:,jl)  , npb, ht_i_1d    (1:nbpb)   , jpi, jpj )
563         CALL tab_1d_2d( nbpb, ht_s(:,:,jl)  , npb, ht_s_1d    (1:nbpb)   , jpi, jpj )
564         CALL tab_1d_2d( nbpb, a_i (:,:,jl)  , npb, a_i_1d     (1:nbpb)   , jpi, jpj )
565         CALL tab_1d_2d( nbpb, t_su(:,:,jl)  , npb, t_su_1d    (1:nbpb)   , jpi, jpj )
566         CALL tab_1d_2d( nbpb, sm_i(:,:,jl)  , npb, sm_i_1d    (1:nbpb)   , jpi, jpj )
567         DO jk = 1, nlay_s
568            CALL tab_1d_2d( nbpb, t_s(:,:,jk,jl), npb, t_s_1d     (1:nbpb,jk), jpi, jpj)
569            CALL tab_1d_2d( nbpb, e_s(:,:,jk,jl), npb, q_s_1d     (1:nbpb,jk), jpi, jpj)
570         END DO
571         DO jk = 1, nlay_i
572            CALL tab_1d_2d( nbpb, t_i(:,:,jk,jl), npb, t_i_1d     (1:nbpb,jk), jpi, jpj)
573            CALL tab_1d_2d( nbpb, e_i(:,:,jk,jl), npb, q_i_1d     (1:nbpb,jk), jpi, jpj)
574            CALL tab_1d_2d( nbpb, s_i(:,:,jk,jl), npb, s_i_1d     (1:nbpb,jk), jpi, jpj)
575         END DO
576         CALL tab_1d_2d( nbpb, qlead         , npb, qlead_1d  (1:nbpb)   , jpi, jpj )
577         
578         CALL tab_1d_2d( nbpb, wfx_snw       , npb, wfx_snw_1d(1:nbpb)   , jpi, jpj )
579         CALL tab_1d_2d( nbpb, wfx_sub       , npb, wfx_sub_1d(1:nbpb)   , jpi, jpj )
580         
581         CALL tab_1d_2d( nbpb, wfx_bog       , npb, wfx_bog_1d(1:nbpb)   , jpi, jpj )
582         CALL tab_1d_2d( nbpb, wfx_bom       , npb, wfx_bom_1d(1:nbpb)   , jpi, jpj )
583         CALL tab_1d_2d( nbpb, wfx_sum       , npb, wfx_sum_1d(1:nbpb)   , jpi, jpj )
584         CALL tab_1d_2d( nbpb, wfx_sni       , npb, wfx_sni_1d(1:nbpb)   , jpi, jpj )
585         CALL tab_1d_2d( nbpb, wfx_res       , npb, wfx_res_1d(1:nbpb)   , jpi, jpj )
586         CALL tab_1d_2d( nbpb, wfx_spr       , npb, wfx_spr_1d(1:nbpb)   , jpi, jpj )
587         
588         CALL tab_1d_2d( nbpb, sfx_bog       , npb, sfx_bog_1d(1:nbpb)   , jpi, jpj )
589         CALL tab_1d_2d( nbpb, sfx_bom       , npb, sfx_bom_1d(1:nbpb)   , jpi, jpj )
590         CALL tab_1d_2d( nbpb, sfx_sum       , npb, sfx_sum_1d(1:nbpb)   , jpi, jpj )
591         CALL tab_1d_2d( nbpb, sfx_sni       , npb, sfx_sni_1d(1:nbpb)   , jpi, jpj )
592         CALL tab_1d_2d( nbpb, sfx_res       , npb, sfx_res_1d(1:nbpb)   , jpi, jpj )
593         CALL tab_1d_2d( nbpb, sfx_bri       , npb, sfx_bri_1d(1:nbpb)   , jpi, jpj )
594         
595         CALL tab_1d_2d( nbpb, hfx_thd       , npb, hfx_thd_1d(1:nbpb)   , jpi, jpj )
596         CALL tab_1d_2d( nbpb, hfx_spr       , npb, hfx_spr_1d(1:nbpb)   , jpi, jpj )
597         CALL tab_1d_2d( nbpb, hfx_sum       , npb, hfx_sum_1d(1:nbpb)   , jpi, jpj )
598         CALL tab_1d_2d( nbpb, hfx_bom       , npb, hfx_bom_1d(1:nbpb)   , jpi, jpj )
599         CALL tab_1d_2d( nbpb, hfx_bog       , npb, hfx_bog_1d(1:nbpb)   , jpi, jpj )
600         CALL tab_1d_2d( nbpb, hfx_dif       , npb, hfx_dif_1d(1:nbpb)   , jpi, jpj )
601         CALL tab_1d_2d( nbpb, hfx_opw       , npb, hfx_opw_1d(1:nbpb)   , jpi, jpj )
602         CALL tab_1d_2d( nbpb, hfx_snw       , npb, hfx_snw_1d(1:nbpb)   , jpi, jpj )
603         CALL tab_1d_2d( nbpb, hfx_sub       , npb, hfx_sub_1d(1:nbpb)   , jpi, jpj )
604         CALL tab_1d_2d( nbpb, hfx_err       , npb, hfx_err_1d(1:nbpb)   , jpi, jpj )
605         CALL tab_1d_2d( nbpb, hfx_res       , npb, hfx_res_1d(1:nbpb)   , jpi, jpj )
606         CALL tab_1d_2d( nbpb, hfx_err_rem   , npb, hfx_err_rem_1d(1:nbpb), jpi, jpj )
607         CALL tab_1d_2d( nbpb, hfx_err_dif   , npb, hfx_err_dif_1d(1:nbpb), jpi, jpj )
608         !
609         CALL tab_1d_2d( nbpb, qns_ice(:,:,jl), npb, qns_ice_1d(1:nbpb) , jpi, jpj)
610         CALL tab_1d_2d( nbpb, ftr_ice(:,:,jl), npb, ftr_ice_1d(1:nbpb) , jpi, jpj )
611         !         
612      END SELECT
613
614   END SUBROUTINE lim_thd_1d2d
615
616
617   SUBROUTINE lim_thd_init
618      !!-----------------------------------------------------------------------
619      !!                   ***  ROUTINE lim_thd_init ***
620      !!                 
621      !! ** Purpose :   Physical constants and parameters linked to the ice
622      !!              thermodynamics
623      !!
624      !! ** Method  :   Read the namicethd namelist and check the ice-thermo
625      !!              parameter values called at the first timestep (nit000)
626      !!
627      !! ** input   :   Namelist namicether
628      !!-------------------------------------------------------------------
629      INTEGER  ::   ios                 ! Local integer output status for namelist read
630      NAMELIST/namicethd/ rn_hnewice, ln_frazil, rn_maxfrazb, rn_vfrazb, rn_Cfrazb,                       &
631         &                rn_himin, rn_betas, rn_kappa_i, nn_conv_dif, rn_terr_dif, nn_ice_thcon, &
632         &                nn_monocat, ln_it_qnsice
633      !!-------------------------------------------------------------------
634      !
635      IF(lwp) THEN
636         WRITE(numout,*)
637         WRITE(numout,*) 'lim_thd : Ice Thermodynamics'
638         WRITE(numout,*) '~~~~~~~'
639      ENDIF
640      !
641      REWIND( numnam_ice_ref )              ! Namelist namicethd in reference namelist : Ice thermodynamics
642      READ  ( numnam_ice_ref, namicethd, IOSTAT = ios, ERR = 901)
643901   IF( ios /= 0 ) CALL ctl_nam ( ios , 'namicethd in reference namelist', lwp )
644
645      REWIND( numnam_ice_cfg )              ! Namelist namicethd in configuration namelist : Ice thermodynamics
646      READ  ( numnam_ice_cfg, namicethd, IOSTAT = ios, ERR = 902 )
647902   IF( ios /= 0 ) CALL ctl_nam ( ios , 'namicethd in configuration namelist', lwp )
648      IF(lwm) WRITE ( numoni, namicethd )
649      !
650      IF ( ( jpl > 1 ) .AND. ( nn_monocat == 1 ) ) THEN
651         nn_monocat = 0
652         IF(lwp) WRITE(numout, *) '   nn_monocat must be 0 in multi-category case '
653      ENDIF
654
655      !
656      IF(lwp) THEN                          ! control print
657         WRITE(numout,*)
658         WRITE(numout,*)'   Namelist of ice parameters for ice thermodynamic computation '
659         WRITE(numout,*)'      ice thick. for lateral accretion                        rn_hnewice   = ', rn_hnewice
660         WRITE(numout,*)'      Frazil ice thickness as a function of wind or not       ln_frazil    = ', ln_frazil
661         WRITE(numout,*)'      Maximum proportion of frazil ice collecting at bottom   rn_maxfrazb  = ', rn_maxfrazb
662         WRITE(numout,*)'      Thresold relative drift speed for collection of frazil  rn_vfrazb    = ', rn_vfrazb
663         WRITE(numout,*)'      Squeezing coefficient for collection of frazil          rn_Cfrazb    = ', rn_Cfrazb
664         WRITE(numout,*)'      minimum ice thickness                                   rn_himin     = ', rn_himin 
665         WRITE(numout,*)'      numerical carac. of the scheme for diffusion in ice '
666         WRITE(numout,*)'      coefficient for ice-lead partition of snowfall          rn_betas     = ', rn_betas
667         WRITE(numout,*)'      extinction radiation parameter in sea ice               rn_kappa_i   = ', rn_kappa_i
668         WRITE(numout,*)'      maximal n. of iter. for heat diffusion computation      nn_conv_dif  = ', nn_conv_dif
669         WRITE(numout,*)'      maximal err. on T for heat diffusion computation        rn_terr_dif  = ', rn_terr_dif
670         WRITE(numout,*)'      switch for comp. of thermal conductivity in the ice     nn_ice_thcon = ', nn_ice_thcon
671         WRITE(numout,*)'      check heat conservation in the ice/snow                 con_i        = ', con_i
672         WRITE(numout,*)'      virtual ITD mono-category parameterizations (1) or not  nn_monocat   = ', nn_monocat
673         WRITE(numout,*)'      iterate the surface non-solar flux (T) or not (F)       ln_it_qnsice = ', ln_it_qnsice
674      ENDIF
675      !
676   END SUBROUTINE lim_thd_init
677
678#else
679   !!----------------------------------------------------------------------
680   !!   Default option         Dummy module          NO  LIM3 sea-ice model
681   !!----------------------------------------------------------------------
682#endif
683
684   !!======================================================================
685END MODULE limthd
Note: See TracBrowser for help on using the repository browser.