source: branches/2014/dev_r4650_UKMO3_masked_damping/NEMOGCM/NEMO/LIM_SRC_3/limdiahsb.F90 @ 5086

Last change on this file since 5086 was 5086, checked in by timgraham, 7 years ago

Merged head of trunk into branch in preparation for putting code back onto the trunk
In working copy ran the command:
svn merge svn+sshtimgraham@…/ipsl/forge/projets/nemo/svn/trunk

Also recompiled NEMO_book.pdf with merged input files

File size: 17.7 KB
Line 
1MODULE limdiahsb
2   !!======================================================================
3   !!                       ***  MODULE limdia_hsb   ***
4   !!  LIM-3 sea ice model :   diagnostics of ice model
5   !!======================================================================
6   !! History :  3.4  ! 2012-10  (C. Rousset)  original code
7   !!----------------------------------------------------------------------
8#if defined key_lim3
9   !!----------------------------------------------------------------------
10   !!   'key_lim3'                                       LIM3 sea-ice model
11   !!----------------------------------------------------------------------
12   !!   lim_dia_hsb        : computation and output of the time evolution of keys variables
13   !!   lim_dia_hsb_init   : initialization and namelist read
14   !!----------------------------------------------------------------------
15   USE ice             ! LIM-3: sea-ice variable
16   USE par_ice         ! LIM-3: ice parameters
17   USE dom_ice         ! LIM-3: sea-ice domain
18   USE dom_oce         ! ocean domain
19   USE sbc_oce         ! surface boundary condition: ocean fields
20   USE sbc_ice         ! Surface boundary condition: sea-ice fields
21   USE daymod          ! model calendar
22   USE phycst          ! physical constant
23   USE in_out_manager  ! I/O manager
24   USE lib_mpp         ! MPP library
25   USE timing          ! preformance summary
26   USE iom             ! I/O manager
27   USE lib_fortran     ! glob_sum
28   USE limrst          ! ice restart
29
30   IMPLICIT NONE
31   PRIVATE
32
33   PUBLIC   lim_diahsb        ! routine called by ice_step.F90
34   !!PUBLIC   lim_diahsb_init   ! routine called by ice_init.F90
35   !!PUBLIC   lim_diahsb_rst   ! routine called by ice_init.F90
36
37   real(wp) ::   frc_sal, frc_vol   ! global forcing trends
38   real(wp) ::   bg_grme            ! global ice growth+melt trends
39
40   !! * Substitutions
41#  include "vectopt_loop_substitute.h90"
42
43   !!----------------------------------------------------------------------
44   !! NEMO/OPA 3.4 , NEMO Consortium (2012)
45   !! $Id: limdiahsb.F90 3294 2012-10-18 16:44:18Z rblod $
46   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt)
47   !!----------------------------------------------------------------------
48
49CONTAINS
50
51   SUBROUTINE lim_diahsb
52      !!---------------------------------------------------------------------------
53      !!                  ***  ROUTINE lim_diahsb  ***
54      !!     
55      !! ** Purpose: Compute the ice global heat content, salt content and volume conservation
56      !!
57      !!---------------------------------------------------------------------------
58      !!
59      real(wp)   ::   zbg_ivo, zbg_svo, zbg_are, zbg_sal ,zbg_tem ,zbg_ihc ,zbg_shc
60      real(wp)   ::   zbg_sfx, zbg_sfx_bri, zbg_sfx_bog, zbg_sfx_bom, zbg_sfx_sum, zbg_sfx_sni,   &
61      &               zbg_sfx_opw, zbg_sfx_res, zbg_sfx_dyn 
62      real(wp)   ::   zbg_vfx, zbg_vfx_bog, zbg_vfx_opw, zbg_vfx_sni, zbg_vfx_dyn
63      real(wp)   ::   zbg_vfx_bom, zbg_vfx_sum, zbg_vfx_res, zbg_vfx_spr, zbg_vfx_snw, zbg_vfx_sub 
64      real(wp)   ::   zbg_hfx_dhc, zbg_hfx_spr
65      real(wp)   ::   zbg_hfx_res, zbg_hfx_sub, zbg_hfx_dyn, zbg_hfx_thd, zbg_hfx_snw, zbg_hfx_out, zbg_hfx_in   
66      real(wp)   ::   zbg_hfx_sum, zbg_hfx_bom, zbg_hfx_bog, zbg_hfx_dif, zbg_hfx_opw
67      real(wp)   ::   z_frc_vol, z_frc_sal, z_bg_grme 
68      real(wp)   ::   z1_area                     !    -     -
69      REAL(wp)   ::   ztmp
70      !!---------------------------------------------------------------------------
71      IF( nn_timing == 1 )   CALL timing_start('lim_diahsb')
72
73      IF( numit == nstart ) CALL lim_diahsb_init 
74
75      ! 1/area
76      z1_area = 1._wp / MAX( glob_sum( area(:,:) * tms(:,:) ), epsi06 )
77
78      rswitch = MAX( 0._wp , SIGN( 1._wp , glob_sum( area(:,:) * tms(:,:) ) - epsi06 ) )
79      ! ----------------------- !
80      ! 1 -  Content variations !
81      ! ----------------------- !
82      zbg_ivo = glob_sum( vt_i(:,:) * area(:,:) * tms(:,:) ) ! volume ice
83      zbg_svo = glob_sum( vt_s(:,:) * area(:,:) * tms(:,:) ) ! volume snow
84      zbg_are = glob_sum( at_i(:,:) * area(:,:) * tms(:,:) ) ! area
85      zbg_sal = glob_sum( SUM( smv_i(:,:,:), dim=3 ) * area(:,:) * tms(:,:) )       ! mean salt content
86      zbg_tem = glob_sum( ( tm_i(:,:) - rtt ) * vt_i(:,:) * area(:,:) * tms(:,:) )  ! mean temp content
87
88      !zbg_ihc = glob_sum( et_i(:,:) * area(:,:) * tms(:,:) ) / MAX( zbg_ivo,epsi06 ) ! ice heat content
89      !zbg_shc = glob_sum( et_s(:,:) * area(:,:) * tms(:,:) ) / MAX( zbg_svo,epsi06 ) ! snow heat content
90
91      ! Volume
92      ztmp = rswitch * z1_area * r1_rau0 * rday
93      zbg_vfx     = ztmp * glob_sum(     emp(:,:) * area(:,:) * tms(:,:) )
94      zbg_vfx_bog = ztmp * glob_sum( wfx_bog(:,:) * area(:,:) * tms(:,:) )
95      zbg_vfx_opw = ztmp * glob_sum( wfx_opw(:,:) * area(:,:) * tms(:,:) )
96      zbg_vfx_sni = ztmp * glob_sum( wfx_sni(:,:) * area(:,:) * tms(:,:) )
97      zbg_vfx_dyn = ztmp * glob_sum( wfx_dyn(:,:) * area(:,:) * tms(:,:) )
98      zbg_vfx_bom = ztmp * glob_sum( wfx_bom(:,:) * area(:,:) * tms(:,:) )
99      zbg_vfx_sum = ztmp * glob_sum( wfx_sum(:,:) * area(:,:) * tms(:,:) )
100      zbg_vfx_res = ztmp * glob_sum( wfx_res(:,:) * area(:,:) * tms(:,:) )
101      zbg_vfx_spr = ztmp * glob_sum( wfx_spr(:,:) * area(:,:) * tms(:,:) )
102      zbg_vfx_snw = ztmp * glob_sum( wfx_snw(:,:) * area(:,:) * tms(:,:) )
103      zbg_vfx_sub = ztmp * glob_sum( wfx_sub(:,:) * area(:,:) * tms(:,:) )
104
105      ! Salt
106      zbg_sfx     = ztmp * glob_sum(     sfx(:,:) * area(:,:) * tms(:,:) )
107      zbg_sfx_bri = ztmp * glob_sum( sfx_bri(:,:) * area(:,:) * tms(:,:) )
108      zbg_sfx_res = ztmp * glob_sum( sfx_res(:,:) * area(:,:) * tms(:,:) )
109      zbg_sfx_dyn = ztmp * glob_sum( sfx_dyn(:,:) * area(:,:) * tms(:,:) )
110
111      zbg_sfx_bog = ztmp * glob_sum( sfx_bog(:,:) * area(:,:) * tms(:,:) )
112      zbg_sfx_opw = ztmp * glob_sum( sfx_opw(:,:) * area(:,:) * tms(:,:) )
113      zbg_sfx_sni = ztmp * glob_sum( sfx_sni(:,:) * area(:,:) * tms(:,:) )
114      zbg_sfx_bom = ztmp * glob_sum( sfx_bom(:,:) * area(:,:) * tms(:,:) )
115      zbg_sfx_sum = ztmp * glob_sum( sfx_sum(:,:) * area(:,:) * tms(:,:) )
116
117      ! Heat budget
118      zbg_ihc      = glob_sum( et_i(:,:) * 1.e-20 ) ! ice heat content  [1.e-20 J]
119      zbg_shc      = glob_sum( et_s(:,:) * 1.e-20 ) ! snow heat content [1.e-20 J]
120      zbg_hfx_dhc  = glob_sum( diag_heat_dhc(:,:) * area(:,:) * tms(:,:) ) ! [in W]
121      zbg_hfx_spr  = glob_sum( hfx_spr(:,:) * area(:,:) * tms(:,:) ) ! [in W]
122
123      zbg_hfx_thd  = glob_sum( hfx_thd(:,:) * area(:,:) * tms(:,:) ) ! [in W]
124      zbg_hfx_dyn  = glob_sum( hfx_dyn(:,:) * area(:,:) * tms(:,:) ) ! [in W]
125      zbg_hfx_res  = glob_sum( hfx_res(:,:) * area(:,:) * tms(:,:) ) ! [in W]
126      zbg_hfx_sub  = glob_sum( hfx_sub(:,:) * area(:,:) * tms(:,:) ) ! [in W]
127      zbg_hfx_snw  = glob_sum( hfx_snw(:,:) * area(:,:) * tms(:,:) ) ! [in W]
128      zbg_hfx_sum  = glob_sum( hfx_sum(:,:) * area(:,:) * tms(:,:) ) ! [in W]
129      zbg_hfx_bom  = glob_sum( hfx_bom(:,:) * area(:,:) * tms(:,:) ) ! [in W]
130      zbg_hfx_bog  = glob_sum( hfx_bog(:,:) * area(:,:) * tms(:,:) ) ! [in W]
131      zbg_hfx_dif  = glob_sum( hfx_dif(:,:) * area(:,:) * tms(:,:) ) ! [in W]
132      zbg_hfx_opw  = glob_sum( hfx_opw(:,:) * area(:,:) * tms(:,:) ) ! [in W]
133      zbg_hfx_out  = glob_sum( hfx_out(:,:) * area(:,:) * tms(:,:) ) ! [in W]
134      zbg_hfx_in   = glob_sum(  hfx_in(:,:) * area(:,:) * tms(:,:) ) ! [in W]
135   
136      ! --------------------------------------------- !
137      ! 2 - Trends due to forcing and ice growth/melt !
138      ! --------------------------------------------- !
139      z_frc_vol = r1_rau0 * glob_sum( - emp(:,:) * area(:,:) * tms(:,:) ) ! volume fluxes
140      z_frc_sal = r1_rau0 * glob_sum(   sfx(:,:) * area(:,:) * tms(:,:) ) ! salt fluxes
141      z_bg_grme = glob_sum( - ( wfx_bog(:,:) + wfx_opw(:,:) + wfx_sni(:,:) + wfx_dyn(:,:) + &
142                          &     wfx_bom(:,:) + wfx_sum(:,:) + wfx_res(:,:) + wfx_snw(:,:) + wfx_sub(:,:) ) * area(:,:) * tms(:,:) ) ! volume fluxes
143      !
144      frc_vol  = frc_vol  + z_frc_vol  * rdt_ice
145      frc_sal  = frc_sal  + z_frc_sal  * rdt_ice
146      bg_grme  = bg_grme  + z_bg_grme  * rdt_ice
147     
148      ! difference
149      !frc_vol = zbg_ivo - frc_vol
150      !frc_sal = zbg_sal - frc_sal
151     
152      ! ----------------------- !
153      ! 3 - Diagnostics writing !
154      ! ----------------------- !
155      rswitch = MAX( 0._wp , SIGN( 1._wp , zbg_ivo - epsi06 ) )
156      !
157      IF( iom_use('ibgvoltot') )   &
158      CALL iom_put( 'ibgvoltot' , zbg_ivo * rhoic * r1_rau0 * 1.e-9        )   ! ice volume (km3 equivalent liquid)         
159      IF( iom_use('sbgvoltot') )   &
160      CALL iom_put( 'sbgvoltot' , zbg_svo * rhosn * r1_rau0 * 1.e-9        )   ! snw volume (km3 equivalent liquid)       
161      IF( iom_use('ibgarea') )   &
162      CALL iom_put( 'ibgarea'   , zbg_are * 1.e-6                          )   ! ice area   (km2)
163      IF( iom_use('ibgsaline') )   &
164      CALL iom_put( 'ibgsaline' , rswitch * zbg_sal / MAX( zbg_ivo, epsi06 ) )   ! ice saline (psu)
165      IF( iom_use('ibgtemper') )   &
166      CALL iom_put( 'ibgtemper' , rswitch * zbg_tem / MAX( zbg_ivo, epsi06 ) )   ! ice temper (C)
167      CALL iom_put( 'ibgheatco' , zbg_ihc                                  )   ! ice heat content (1.e20 J)       
168      CALL iom_put( 'sbgheatco' , zbg_shc                                  )   ! snw heat content (1.e20 J)
169      IF( iom_use('ibgsaltco') )   &
170      CALL iom_put( 'ibgsaltco' , zbg_sal * rhoic * r1_rau0 * 1.e-9        )   ! ice salt content (psu*km3 equivalent liquid)       
171
172      CALL iom_put( 'ibgvfx'    , zbg_vfx                                  )   ! volume flux emp (m/day liquid)
173      CALL iom_put( 'ibgvfxbog' , zbg_vfx_bog                              )   ! volume flux bottom growth     -(m/day equivalent liquid)
174      CALL iom_put( 'ibgvfxopw' , zbg_vfx_opw                              )   ! volume flux open water growth -
175      CALL iom_put( 'ibgvfxsni' , zbg_vfx_sni                              )   ! volume flux snow ice growth   -
176      CALL iom_put( 'ibgvfxdyn' , zbg_vfx_dyn                              )   ! volume flux dynamic growth    -
177      CALL iom_put( 'ibgvfxbom' , zbg_vfx_bom                              )   ! volume flux bottom melt       -
178      CALL iom_put( 'ibgvfxsum' , zbg_vfx_sum                              )   ! volume flux surface melt      -
179      CALL iom_put( 'ibgvfxres' , zbg_vfx_res                              )   ! volume flux resultant         -
180      CALL iom_put( 'ibgvfxspr' , zbg_vfx_spr                              )   ! volume flux from snow precip         -
181      CALL iom_put( 'ibgvfxsnw' , zbg_vfx_snw                              )   ! volume flux from snow melt         -
182      CALL iom_put( 'ibgvfxsub' , zbg_vfx_sub                              )   ! volume flux from sublimation         -
183         
184      CALL iom_put( 'ibgsfx'    , zbg_sfx                                  )   ! salt flux         -(psu*m/day equivalent liquid)       
185      CALL iom_put( 'ibgsfxbri' , zbg_sfx_bri                              )   ! salt flux brines  -     
186      CALL iom_put( 'ibgsfxdyn' , zbg_sfx_dyn                              )   ! salt flux dynamic -   
187      CALL iom_put( 'ibgsfxres' , zbg_sfx_res                              )   ! salt flux result  -   
188      CALL iom_put( 'ibgsfxbog' , zbg_sfx_bog                              )   ! salt flux bottom growth   
189      CALL iom_put( 'ibgsfxopw' , zbg_sfx_opw                              )   ! salt flux open water growth -
190      CALL iom_put( 'ibgsfxsni' , zbg_sfx_sni                              )   ! salt flux snow ice growth   -
191      CALL iom_put( 'ibgsfxbom' , zbg_sfx_bom                              )   ! salt flux bottom melt       -
192      CALL iom_put( 'ibgsfxsum' , zbg_sfx_sum                              )   ! salt flux surface melt      -
193
194      CALL iom_put( 'ibghfxdhc' , zbg_hfx_dhc                              )   ! Heat content variation in snow and ice [W]
195      CALL iom_put( 'ibghfxspr' , zbg_hfx_spr                              )   ! Heat content of snow precip [W]
196
197      CALL iom_put( 'ibghfxres' , zbg_hfx_res                              )   !
198      CALL iom_put( 'ibghfxsub' , zbg_hfx_sub                              )   !
199      CALL iom_put( 'ibghfxdyn' , zbg_hfx_dyn                              )   !
200      CALL iom_put( 'ibghfxthd' , zbg_hfx_thd                              )   !
201      CALL iom_put( 'ibghfxsnw' , zbg_hfx_snw                              )   !
202      CALL iom_put( 'ibghfxsum' , zbg_hfx_sum                              )   !
203      CALL iom_put( 'ibghfxbom' , zbg_hfx_bom                              )   !
204      CALL iom_put( 'ibghfxbog' , zbg_hfx_bog                              )   !
205      CALL iom_put( 'ibghfxdif' , zbg_hfx_dif                              )   !
206      CALL iom_put( 'ibghfxopw' , zbg_hfx_opw                              )   !
207      CALL iom_put( 'ibghfxout' , zbg_hfx_out                              )   !
208      CALL iom_put( 'ibghfxin'  , zbg_hfx_in                               )   !
209
210      CALL iom_put( 'ibgfrcvol' , frc_vol * 1.e-9                          )   ! vol - forcing     (km3 equivalent liquid)
211      CALL iom_put( 'ibgfrcsfx' , frc_sal * 1.e-9                          )   ! sal - forcing     (psu*km3 equivalent liquid)   
212      IF( iom_use('ibgvolgrm') )   &
213      CALL iom_put( 'ibgvolgrm' , bg_grme * r1_rau0 * 1.e-9                )   ! vol growth + melt (km3 equivalent liquid)         
214
215      !
216      IF( lrst_ice )   CALL lim_diahsb_rst( numit, 'WRITE' )
217      !
218      IF( nn_timing == 1 )   CALL timing_stop('lim_diahsb')
219!
220   END SUBROUTINE lim_diahsb
221
222
223   SUBROUTINE lim_diahsb_init
224      !!---------------------------------------------------------------------------
225      !!                  ***  ROUTINE lim_diahsb_init  ***
226      !!     
227      !! ** Purpose: Initialization for the heat salt volume budgets
228      !!
229      !! ** Method : Compute initial heat content, salt content and volume
230      !!
231      !! ** Action : - Compute initial heat content, salt content and volume
232      !!             - Initialize forcing trends
233      !!             - Compute coefficients for conversion
234      !!---------------------------------------------------------------------------
235      INTEGER            ::   jk       ! dummy loop indice
236      INTEGER            ::   ierror   ! local integer
237      !!
238      !!NAMELIST/namicehsb/ blabla
239      !!----------------------------------------------------------------------
240      !
241      !!REWIND ( numnam_ice )              ! Read Namelist namicehsb
242      !!READ   ( numnam_ice, namicehsb )
243      !
244      IF(lwp) THEN                   ! Control print
245         WRITE(numout,*)
246         WRITE(numout,*) 'lim_diahsb_init : check the heat and salt budgets'
247         WRITE(numout,*) '~~~~~~~~~~~~'
248      ENDIF
249
250      ! ---------------------------------- !
251      ! 2 - initial conservation variables !
252      ! ---------------------------------- !
253      !frc_vol = 0._wp                                          ! volume       trend due to forcing
254      !frc_sal = 0._wp                                          ! salt content   -    -   -    -         
255      !bg_grme = 0._wp                                          ! ice growth + melt volume trend
256      !
257      CALL lim_diahsb_rst( nstart, 'READ' )  !* read or initialize all required files
258      !
259   END SUBROUTINE lim_diahsb_init
260
261   SUBROUTINE lim_diahsb_rst( kt, cdrw )
262     !!---------------------------------------------------------------------
263     !!                   ***  ROUTINE limdia_rst  ***
264     !!                     
265     !! ** Purpose :   Read or write DIA file in restart file
266     !!
267     !! ** Method  :   use of IOM library
268     !!----------------------------------------------------------------------
269     INTEGER         , INTENT(in) ::   kt     ! ice time-step
270     CHARACTER(len=*), INTENT(in) ::   cdrw   ! "READ"/"WRITE" flag
271     !
272     INTEGER ::   id1, id2, id3   ! local integers
273     !!----------------------------------------------------------------------
274     !
275     IF( TRIM(cdrw) == 'READ' ) THEN        ! Read/initialise
276        IF( ln_rstart ) THEN                   !* Read the restart file
277           !id1 = iom_varid( numrir, 'frc_vol'  , ldstop = .TRUE. )
278           !
279           IF(lwp) WRITE(numout,*) '~~~~~~~'
280           IF(lwp) WRITE(numout,*) ' lim_diahsb_rst at it= ', kt,' date= ', ndastp
281           IF(lwp) WRITE(numout,*) '~~~~~~~'
282           CALL iom_get( numrir, 'frc_vol', frc_vol )
283           CALL iom_get( numrir, 'frc_sal', frc_sal )
284           CALL iom_get( numrir, 'bg_grme', bg_grme )
285        ELSE
286           IF(lwp) WRITE(numout,*) '~~~~~~~'
287           IF(lwp) WRITE(numout,*) ' lim_diahsb at initial state '
288           IF(lwp) WRITE(numout,*) '~~~~~~~'
289           frc_vol  = 0._wp                                         
290           frc_sal  = 0._wp                                                 
291           bg_grme  = 0._wp                                       
292       ENDIF
293
294     ELSEIF( TRIM(cdrw) == 'WRITE' ) THEN   ! Create restart file
295        !                                   ! -------------------
296        IF(lwp) WRITE(numout,*) '~~~~~~~'
297        IF(lwp) WRITE(numout,*) ' lim_diahsb_rst at it= ', kt,' date= ', ndastp
298        IF(lwp) WRITE(numout,*) '~~~~~~~'
299        CALL iom_rstput( kt, nitrst, numriw, 'frc_vol'   , frc_vol     )
300        CALL iom_rstput( kt, nitrst, numriw, 'frc_sal'   , frc_sal     )
301        CALL iom_rstput( kt, nitrst, numriw, 'bg_grme'   , bg_grme     )
302        !
303     ENDIF
304     !
305   END SUBROUTINE lim_diahsb_rst
306 
307#else
308   !!----------------------------------------------------------------------
309   !!   Default option :         Empty module          NO LIM sea-ice model
310   !!----------------------------------------------------------------------
311CONTAINS
312   SUBROUTINE lim_diahsb          ! Empty routine
313   END SUBROUTINE lim_diahsb
314#endif
315   !!======================================================================
316END MODULE limdiahsb
Note: See TracBrowser for help on using the repository browser.