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.
Changeset 6808 for branches/NERC/dev_r5549_BDY_ZEROGRAD/NEMOGCM/NEMO/OPA_SRC/step.F90 – NEMO

Ignore:
Timestamp:
2016-07-19T10:38:35+02:00 (8 years ago)
Author:
jamesharle
Message:

merge with trunk@6232 for consistency with SSB code

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/NERC/dev_r5549_BDY_ZEROGRAD/NEMOGCM/NEMO/OPA_SRC/step.F90

    r5510 r6808  
    22   !!====================================================================== 
    33   !!                       ***  MODULE step  *** 
    4    !! Time-stepping    : manager of the ocean, tracer and ice time stepping 
     4   !! Time-stepping   : manager of the ocean, tracer and ice time stepping 
    55   !!====================================================================== 
    66   !! History :  OPA  !  1991-03  (G. Madec)  Original code 
     
    2424   !!             -   !  2010-10  (C. Ethe, G. Madec) reorganisation of initialisation phase + merge TRC-TRA 
    2525   !!            3.4  !  2011-04  (G. Madec, C. Ethe) Merge of dtatem and dtasal 
    26    !!                 !  2012-07  (J. Simeon, G. Madec, C. Ethe) Online coarsening of outputs 
    27    !!            3.7  !  2014-04  (F. Roquet, G. Madec) New equations of state 
     26   !!            3.6  !  2012-07  (J. Simeon, G. Madec. C. Ethe)  Online coarsening of outputs 
     27   !!            3.6  !  2014-04  (F. Roquet, G. Madec) New equations of state 
     28   !!            3.7  !  2014-10  (G. Madec)  LDF simplication  
     29   !!             -   !  2014-12  (G. Madec) remove KPP scheme 
     30   !!             -   !  2015-11  (J. Chanut) free surface simplification 
    2831   !!---------------------------------------------------------------------- 
    2932 
     
    3235   !!---------------------------------------------------------------------- 
    3336   USE step_oce         ! time stepping definition modules 
    34    USE iom 
     37   ! 
     38   USE iom              ! xIOs server 
    3539 
    3640   IMPLICIT NONE 
    3741   PRIVATE 
    3842 
    39    PUBLIC   stp   ! called by opa.F90 
    40  
    41    !! * Substitutions 
    42 #  include "domzgr_substitute.h90" 
    43 !!gm   #  include "zdfddm_substitute.h90" 
    44    !!---------------------------------------------------------------------- 
    45    !! NEMO/OPA 3.7 , NEMO Consortium (2014) 
     43   PUBLIC   stp   ! called by nemogcm.F90 
     44 
     45   !!---------------------------------------------------------------------- 
     46   !! NEMO/OPA 3.7 , NEMO Consortium (2015) 
    4647   !! $Id$ 
    4748   !! Software governed by the CeCILL licence     (NEMOGCM/NEMO_CeCILL.txt) 
     
    5051 
    5152#if defined key_agrif 
    52    SUBROUTINE stp( ) 
     53   RECURSIVE SUBROUTINE stp( ) 
    5354      INTEGER             ::   kstp   ! ocean time-step index 
    5455#else 
     
    6970      !!              -5- Compute the momentum trends 
    7071      !!              -6- Update the horizontal velocity 
    71       !!              -7- Compute the diagnostics variables (rd,N2, div,cur,w) 
     72      !!              -7- Compute the diagnostics variables (rd,N2, hdiv,w) 
    7273      !!              -8- Outputs and diagnostics 
    7374      !!---------------------------------------------------------------------- 
     
    7677      INTEGER ::   kcall    ! optional integer argument (dom_vvl_sf_nxt) 
    7778      !! --------------------------------------------------------------------- 
    78  
    7979#if defined key_agrif 
    8080      kstp = nit000 + Agrif_Nb_Step() 
    81 !      IF ( Agrif_Root() .and. lwp) Write(*,*) '---' 
    82 !      IF (lwp) Write(*,*) 'Grid Number',Agrif_Fixed(),' time step ',kstp 
    83       IF ( kstp == (nit000 + 1) ) lk_agrif_fstep = .FALSE. 
     81      IF( lk_agrif_debug ) THEN 
     82         IF( Agrif_Root() .and. lwp)   WRITE(*,*) '---' 
     83         IF(lwp)   WRITE(*,*) 'Grid Number', Agrif_Fixed(),' time step ', kstp, 'int tstep', Agrif_NbStepint() 
     84      ENDIF 
     85      IF( kstp == nit000 + 1 )   lk_agrif_fstep = .FALSE. 
    8486# if defined key_iomput 
    8587      IF( Agrif_Nbstepint() == 0 )   CALL iom_swap( cxios_context ) 
    8688# endif 
    8789#endif 
    88                              indic = 0           ! reset to no error condition 
    89       IF( kstp == nit000 ) THEN 
    90          ! must be done after nemo_init for AGRIF+XIOS+OASIS 
    91                       CALL iom_init(      cxios_context          )  ! iom_put initialization 
    92          IF( ln_crs ) CALL iom_init( TRIM(cxios_context)//"_crs" )  ! initialize context for coarse grid 
    93       ENDIF 
    94  
     90      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     91      ! update I/O and calendar  
     92      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     93                             indic = 0                ! reset to no error condition 
     94                              
     95      IF( kstp == nit000 ) THEN                       ! initialize IOM context (must be done after nemo_init for AGRIF+XIOS+OASIS) 
     96                             CALL iom_init(      cxios_context          )  ! for model grid (including passible AGRIF zoom) 
     97         IF( ln_crs      )   CALL iom_init( TRIM(cxios_context)//"_crs" )  ! for coarse grid 
     98      ENDIF 
    9599      IF( kstp /= nit000 )   CALL day( kstp )         ! Calendar (day was already called at nit000 in day_init) 
    96                              CALL iom_setkt( kstp - nit000 + 1,      cxios_context          )   ! tell iom we are at time step kstp 
    97       IF( ln_crs     )       CALL iom_setkt( kstp - nit000 + 1, TRIM(cxios_context)//"_crs" )   ! tell iom we are at time step kstp 
    98  
    99       !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    100       ! Update data, open boundaries, surface boundary condition (including sea-ice) 
    101       !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    102       IF( lk_tide    )   CALL sbc_tide( kstp ) 
    103       IF( lk_bdy     )  THEN 
    104          IF( ln_apr_dyn) CALL sbc_apr( kstp )   ! bdy_dta needs ssh_ib  
    105                          CALL bdy_dta ( kstp, time_offset=+1 )   ! update dynamic & tracer data at open boundaries 
    106       ENDIF 
    107                          CALL sbc    ( kstp )         ! Sea Boundary Condition (including sea-ice) 
    108                                                       ! clem: moved here for bdy ice purpose 
     100                             CALL iom_setkt( kstp - nit000 + 1,      cxios_context          )   ! tell IOM we are at time step kstp 
     101      IF( ln_crs         )   CALL iom_setkt( kstp - nit000 + 1, TRIM(cxios_context)//"_crs" )   ! tell IOM we are at time step kstp 
     102 
     103      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     104      ! Update external forcing (tides, open boundaries, and surface boundary condition (including sea-ice) 
     105      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     106      IF( lk_tide    )   CALL sbc_tide( kstp )                   ! update tide potential 
     107      IF( ln_apr_dyn )   CALL sbc_apr ( kstp )                   ! atmospheric pressure (NB: call before bdy_dta which needs ssh_ib)  
     108      IF( lk_bdy     )   CALL bdy_dta ( kstp, time_offset=+1 )   ! update dynamic & tracer data at open boundaries 
     109                         CALL sbc     ( kstp )                   ! Sea Boundary Condition (including sea-ice) 
     110 
    109111      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    110112      ! Update stochastic parameters and random T/S fluctuations 
    111113      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    112                         CALL sto_par( kstp )          ! Stochastic parameters 
     114                         CALL sto_par( kstp )          ! Stochastic parameters 
    113115 
    114116      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     
    120122                         CALL bn2    ( tsb, rab_b, rn2b ) ! before Brunt-Vaisala frequency 
    121123                         CALL bn2    ( tsn, rab_n, rn2  ) ! now    Brunt-Vaisala frequency 
     124 
    122125      ! 
    123126      !  VERTICAL PHYSICS 
     
    127130      IF( lk_zdftke  )   CALL zdf_tke( kstp )            ! TKE closure scheme for Kz 
    128131      IF( lk_zdfgls  )   CALL zdf_gls( kstp )            ! GLS closure scheme for Kz 
    129       IF( lk_zdfkpp  )   CALL zdf_kpp( kstp )            ! KPP closure scheme for Kz 
    130132      IF( lk_zdfcst  ) THEN                              ! Constant Kz (reset avt, avm[uv] to the background value) 
    131133         avt (:,:,:) = rn_avt0 * wmask (:,:,:) 
     
    133135         avmv(:,:,:) = rn_avm0 * wvmask(:,:,:) 
    134136      ENDIF 
     137 
    135138      IF( ln_rnf_mouth ) THEN                         ! increase diffusivity at rivers mouths 
    136          DO jk = 2, nkrnf   ;   avt(:,:,jk) = avt(:,:,jk) + 2.e0 * rn_avt_rnf * rnfmsk(:,:) * tmask(:,:,jk)   ;   END DO 
     139         DO jk = 2, nkrnf   ;   avt(:,:,jk) = avt(:,:,jk) + 2._wp * rn_avt_rnf * rnfmsk(:,:) * tmask(:,:,jk)   ;   END DO 
    137140      ENDIF 
    138141      IF( ln_zdfevd  )   CALL zdf_evd( kstp )         ! enhanced vertical eddy diffusivity 
     
    140143      IF( lk_zdftmx  )   CALL zdf_tmx( kstp )         ! tidal vertical mixing 
    141144 
    142       IF( lk_zdfddm .AND. .NOT. lk_zdfkpp )   & 
    143          &               CALL zdf_ddm( kstp )         ! double diffusive mixing 
     145      IF( lk_zdfddm  )   CALL zdf_ddm( kstp )         ! double diffusive mixing 
    144146 
    145147                         CALL zdf_mxl( kstp )         ! mixed layer depth 
     
    151153      !  LATERAL  PHYSICS 
    152154      ! 
    153       IF( lk_ldfslp ) THEN                            ! slope of lateral mixing 
     155      IF( l_ldfslp ) THEN                             ! slope of lateral mixing 
     156!!gm : why this here ???? 
    154157         IF(ln_sto_eos ) CALL sto_pts( tsn )          ! Random T/S fluctuations 
     158!!gm 
    155159                         CALL eos( tsb, rhd, gdept_0(:,:,:) )               ! before in situ density 
     160 
    156161         IF( ln_zps .AND. .NOT. ln_isfcav)                               & 
    157162            &            CALL zps_hde    ( kstp, jpts, tsb, gtsu, gtsv,  &  ! Partial steps: before horizontal gradient 
    158163            &                                          rhd, gru , grv    )  ! of t, s, rd at the last ocean level 
     164 
    159165         IF( ln_zps .AND.       ln_isfcav)                               & 
    160             &            CALL zps_hde_isf( kstp, jpts, tsb, gtsu, gtsv,  &    ! Partial steps for top cell (ISF) 
    161             &                                          rhd, gru , grv , aru , arv , gzu , gzv , ge3ru , ge3rv ,   & 
    162             &                                   gtui, gtvi, grui, grvi, arui, arvi, gzui, gzvi, ge3rui, ge3rvi    ) ! of t, s, rd at the first ocean level 
    163          IF( ln_traldf_grif ) THEN                           ! before slope for Griffies operator 
    164                          CALL ldf_slp_grif( kstp ) 
    165          ELSE 
    166                          CALL ldf_slp( kstp, rhd, rn2b )     ! before slope for Madec operator 
     166            &            CALL zps_hde_isf( kstp, jpts, tsb, gtsu, gtsv, gtui, gtvi,  &  ! Partial steps for top cell (ISF) 
     167            &                                          rhd, gru , grv , grui, grvi   )  ! of t, s, rd at the first ocean level 
     168         IF( ln_traldf_triad ) THEN  
     169                         CALL ldf_slp_triad( kstp )                       ! before slope for triad operator 
     170         ELSE      
     171                         CALL ldf_slp     ( kstp, rhd, rn2b )             ! before slope for standard operator 
    167172         ENDIF 
    168173      ENDIF 
    169 #if defined key_traldf_c2d 
    170       IF( lk_traldf_eiv )   CALL ldf_eiv( kstp )      ! eddy induced velocity coefficient 
    171 #endif 
    172 #if defined key_traldf_c3d && defined key_traldf_smag 
    173                           CALL ldf_tra_smag( kstp )      ! eddy induced velocity coefficient 
    174 #  endif 
    175 #if defined key_dynldf_c3d && defined key_dynldf_smag 
    176                           CALL ldf_dyn_smag( kstp )      ! eddy induced velocity coefficient 
    177 #  endif 
    178  
    179       !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    180       !  Ocean dynamics : hdiv, rot, ssh, e3, wn 
    181       !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    182                          CALL ssh_nxt       ( kstp )  ! after ssh (includes call to div_cur) 
    183       IF( lk_vvl     )   CALL dom_vvl_sf_nxt( kstp )  ! after vertical scale factors  
    184                          CALL wzv           ( kstp )  ! now cross-level velocity  
    185  
    186       IF( lk_dynspg_ts ) THEN  
    187           ! In case the time splitting case, update almost all momentum trends here: 
    188           ! Note that the computation of vertical velocity above, hence "after" sea level 
    189           ! is necessary to compute momentum advection for the rhs of barotropic loop: 
    190             IF(ln_sto_eos ) CALL sto_pts( tsn )                             ! Random T/S fluctuations 
    191                             CALL eos    ( tsn, rhd, rhop, fsdept_n(:,:,:) ) ! now in situ density for hpg computation 
    192             IF( ln_zps .AND. .NOT. ln_isfcav)                               & 
    193                &            CALL zps_hde    ( kstp, jpts, tsn, gtsu, gtsv,  &    ! Partial steps: before horizontal gradient 
    194                &                                          rhd, gru , grv    )  ! of t, s, rd at the last ocean level 
    195             IF( ln_zps .AND.       ln_isfcav)                               & 
    196                &            CALL zps_hde_isf( kstp, jpts, tsn, gtsu, gtsv,  &    ! Partial steps for top cell (ISF) 
    197                &                                          rhd, gru , grv , aru , arv , gzu , gzv , ge3ru , ge3rv ,   & 
    198                &                                   gtui, gtvi, grui, grvi, arui, arvi, gzui, gzvi, ge3rui, ge3rvi    ) ! of t, s, rd at the last ocean level 
    199  
    200                                   ua(:,:,:) = 0.e0             ! set dynamics trends to zero 
    201                                   va(:,:,:) = 0.e0 
    202           IF(  ln_asmiau .AND. & 
    203              & ln_dyninc       )  CALL dyn_asm_inc  ( kstp )   ! apply dynamics assimilation increment 
    204           IF( ln_neptsimp )       CALL dyn_nept_cor ( kstp )   ! subtract Neptune velocities (simplified) 
    205           IF( lk_bdy           )  CALL bdy_dyn3d_dmp( kstp )   ! bdy damping trends 
    206                                   CALL dyn_adv      ( kstp )   ! advection (vector or flux form) 
    207                                   CALL dyn_vor      ( kstp )   ! vorticity term including Coriolis 
    208                                   CALL dyn_ldf      ( kstp )   ! lateral mixing 
    209           IF( ln_neptsimp )       CALL dyn_nept_cor ( kstp )   ! add Neptune velocities (simplified) 
    210 #if defined key_agrif 
    211           IF(.NOT. Agrif_Root())  CALL Agrif_Sponge_dyn        ! momentum sponge 
    212 #endif 
    213                                   CALL dyn_hpg( kstp )         ! horizontal gradient of Hydrostatic pressure 
    214                                   CALL dyn_spg( kstp, indic )  ! surface pressure gradient 
    215  
    216                                   ua_sv(:,:,:) = ua(:,:,:)     ! Save trends (barotropic trend has been fully updated at this stage) 
    217                                   va_sv(:,:,:) = va(:,:,:) 
    218  
    219                                   CALL div_cur( kstp )         ! Horizontal divergence & Relative vorticity (2nd call in time-split case) 
    220           IF( lk_vvl     )        CALL dom_vvl_sf_nxt( kstp, kcall=2 )  ! after vertical scale factors (update depth average component) 
    221                                   CALL wzv           ( kstp )  ! now cross-level velocity  
    222       ENDIF 
    223  
     174      !                                               ! eddy diffusivity coeff. and/or eiv coeff. 
     175      IF( l_ldftra_time .OR. l_ldfeiv_time )   CALL ldf_tra( kstp )  
     176 
     177      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     178      !  Ocean dynamics : hdiv, ssh, e3, u, v, w 
     179      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     180 
     181                            CALL ssh_nxt       ( kstp )  ! after ssh (includes call to div_hor) 
     182      IF(.NOT.ln_linssh )   CALL dom_vvl_sf_nxt( kstp )  ! after vertical scale factors  
     183                            CALL wzv           ( kstp )  ! now cross-level velocity  
     184!!gm : why also here ???? 
     185      IF( ln_sto_eos    )   CALL sto_pts( tsn )                             ! Random T/S fluctuations 
     186!!gm 
     187                            CALL eos    ( tsn, rhd, rhop, gdept_n(:,:,:) )  ! now in situ density for hpg computation 
     188                             
     189!!jc: fs simplification 
     190!!jc: lines below are useless if ln_linssh=F. Keep them here (which maintains a bug if ln_linssh=T and ln_zps=T, cf ticket #1636)  
     191!!                                         but ensures reproductible results 
     192!!                                         with previous versions using split-explicit free surface           
     193            IF( ln_zps .AND. .NOT. ln_isfcav )                               & 
     194               &            CALL zps_hde    ( kstp, jpts, tsn, gtsu, gtsv,   &  ! Partial steps: before horizontal gradient 
     195               &                                          rhd, gru , grv     )  ! of t, s, rd at the last ocean level 
     196            IF( ln_zps .AND.       ln_isfcav )                                          & 
     197               &            CALL zps_hde_isf( kstp, jpts, tsn, gtsu, gtsv, gtui, gtvi,  &  ! Partial steps for top cell (ISF) 
     198               &                                          rhd, gru , grv , grui, grvi   )  ! of t, s, rd at the first ocean level 
     199!!jc: fs simplification 
     200                             
     201                         ua(:,:,:) = 0._wp            ! set dynamics trends to zero 
     202                         va(:,:,:) = 0._wp 
     203 
     204      IF(  lk_asminc .AND. ln_asmiau .AND. ln_dyninc )   & 
     205                         CALL dyn_asm_inc   ( kstp )  ! apply dynamics assimilation increment 
     206      IF( lk_bdy     )   CALL bdy_dyn3d_dmp ( kstp )  ! bdy damping trends 
     207#if defined key_agrif 
     208      IF(.NOT. Agrif_Root())  &  
     209               &         CALL Agrif_Sponge_dyn        ! momentum sponge 
     210#endif 
     211                         CALL dyn_adv       ( kstp )  ! advection (vector or flux form) 
     212                         CALL dyn_vor       ( kstp )  ! vorticity term including Coriolis 
     213                         CALL dyn_ldf       ( kstp )  ! lateral mixing 
     214                         CALL dyn_hpg       ( kstp )  ! horizontal gradient of Hydrostatic pressure 
     215                         CALL dyn_spg       ( kstp )  ! surface pressure gradient 
     216 
     217                                                      ! With split-explicit free surface, since now transports have been updated and ssha as well 
     218      IF( ln_dynspg_ts ) THEN                         ! vertical scale factors and vertical velocity need to be updated 
     219                            CALL div_hor    ( kstp )              ! Horizontal divergence  (2nd call in time-split case) 
     220         IF(.NOT.ln_linssh) CALL dom_vvl_sf_nxt( kstp, kcall=2 )  ! after vertical scale factors (update depth average component) 
     221                            CALL wzv        ( kstp )              ! now cross-level velocity  
     222      ENDIF 
     223 
     224                         CALL dyn_bfr       ( kstp )  ! bottom friction 
     225                         CALL dyn_zdf       ( kstp )  ! vertical diffusion 
     226 
     227      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     228      ! cool skin 
     229      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<       
     230      IF ( ln_diurnal )  CALL stp_diurnal( kstp ) 
     231       
    224232      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    225233      ! diagnostics and outputs             (ua, va, tsa used as workspace) 
    226234      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    227       IF( lk_floats  )      CALL flo_stp( kstp )         ! drifting Floats 
    228       IF( lk_diahth  )      CALL dia_hth( kstp )         ! Thermocline depth (20 degres isotherm depth) 
    229       IF( .NOT. ln_cpl )    CALL dia_fwb( kstp )         ! Fresh water budget diagnostics 
    230       IF( lk_diadct  )      CALL dia_dct( kstp )         ! Transports 
    231       IF( lk_diaar5  )      CALL dia_ar5( kstp )         ! ar5 diag 
    232       IF( lk_diaharm )      CALL dia_harm( kstp )        ! Tidal harmonic analysis 
    233                             CALL dia_wri( kstp )         ! ocean model: outputs 
    234       ! 
    235       IF( ln_crs     )      CALL crs_fld( kstp )         ! ocean model: online field coarsening & output 
    236  
     235      IF( lk_floats  )   CALL flo_stp( kstp )         ! drifting Floats 
     236      IF( nn_diacfl == 1 )   CALL dia_cfl( kstp )         ! Courant number diagnostics 
     237      IF( lk_diahth  )   CALL dia_hth( kstp )         ! Thermocline depth (20 degres isotherm depth) 
     238      IF(.NOT.ln_cpl )   CALL dia_fwb( kstp )         ! Fresh water budget diagnostics 
     239      IF( lk_diadct  )   CALL dia_dct( kstp )         ! Transports 
     240      IF( lk_diaar5  )   CALL dia_ar5( kstp )         ! ar5 diag 
     241      IF( lk_diaharm )   CALL dia_harm( kstp )        ! Tidal harmonic analysis 
     242                         CALL dia_wri( kstp )         ! ocean model: outputs 
     243      ! 
     244      IF( ln_crs     )   CALL crs_fld       ( kstp )  ! ocean model: online field coarsening & output 
     245       
    237246#if defined key_top 
    238247      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    239248      ! Passive Tracer Model 
    240249      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    241                          CALL trc_stp( kstp )         ! time-stepping 
    242 #endif 
    243  
    244  
    245       !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    246       ! Active tracers                              (ua, va used as workspace) 
    247       !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    248                              tsa(:,:,:,:) = 0.e0            ! set tracer trends to zero 
    249  
    250       IF(  ln_asmiau .AND. & 
    251          & ln_trainc     )   CALL tra_asm_inc( kstp )       ! apply tracer assimilation increment 
    252                              CALL tra_sbc    ( kstp )       ! surface boundary condition 
    253       IF( ln_traqsr      )   CALL tra_qsr    ( kstp )       ! penetrative solar radiation qsr 
    254       IF( ln_trabbc      )   CALL tra_bbc    ( kstp )       ! bottom heat flux 
    255       IF( lk_trabbl      )   CALL tra_bbl    ( kstp )       ! advective (and/or diffusive) bottom boundary layer scheme 
    256       IF( ln_tradmp      )   CALL tra_dmp    ( kstp )       ! internal damping trends 
    257       IF( lk_bdy         )   CALL bdy_tra_dmp( kstp )       ! bdy damping trends 
    258                              CALL tra_adv    ( kstp )       ! horizontal & vertical advection 
    259       IF( lk_zdfkpp      )   CALL tra_kpp    ( kstp )       ! KPP non-local tracer fluxes 
    260                              CALL tra_ldf    ( kstp )       ! lateral mixing 
    261  
    262       IF( ln_diaptr      )   CALL dia_ptr                   ! Poleward adv/ldf TRansports diagnostics 
    263  
    264 #if defined key_agrif 
    265       IF(.NOT. Agrif_Root()) CALL Agrif_Sponge_tra          ! tracers sponge 
    266 #endif 
    267                              CALL tra_zdf    ( kstp )       ! vertical mixing and after tracer fields 
    268  
    269       IF( ln_dynhpg_imp  ) THEN                             ! semi-implicit hpg (time stepping then eos) 
    270          IF( ln_zdfnpc   )   CALL tra_npc( kstp )                ! update after fields by non-penetrative convection 
    271                              CALL tra_nxt( kstp )                ! tracer fields at next time step 
    272             IF( ln_sto_eos ) CALL sto_pts( tsn )                 ! Random T/S fluctuations 
    273                              CALL eos    ( tsa, rhd, rhop, fsdept_n(:,:,:) )  ! Time-filtered in situ density for hpg computation 
    274             IF( ln_zps .AND. .NOT. ln_isfcav)                                & 
    275                &             CALL zps_hde    ( kstp, jpts, tsa, gtsu, gtsv,  &    ! Partial steps: before horizontal gradient 
    276                &                                           rhd, gru , grv    )  ! of t, s, rd at the last ocean level 
    277             IF( ln_zps .AND.       ln_isfcav)                                & 
    278                &             CALL zps_hde_isf( kstp, jpts, tsa, gtsu, gtsv,  &    ! Partial steps for top cell (ISF) 
    279                &                                           rhd, gru , grv , aru , arv , gzu , gzv , ge3ru , ge3rv ,   & 
    280                &                                    gtui, gtvi, grui, grvi, arui, arvi, gzui, gzvi, ge3rui, ge3rvi    ) ! of t, s, rd at the last ocean level 
    281       ELSE                                                  ! centered hpg  (eos then time stepping) 
    282          IF ( .NOT. lk_dynspg_ts ) THEN                     ! eos already called in time-split case 
    283             IF( ln_sto_eos ) CALL sto_pts( tsn )    ! Random T/S fluctuations 
    284                              CALL eos    ( tsn, rhd, rhop, fsdept_n(:,:,:) )  ! now in situ density for hpg computation 
    285          IF( ln_zps .AND. .NOT. ln_isfcav)                                   & 
    286                &             CALL zps_hde    ( kstp, jpts, tsn, gtsu, gtsv,  &    ! Partial steps: before horizontal gradient 
    287                &                                           rhd, gru , grv    )  ! of t, s, rd at the last ocean level 
    288          IF( ln_zps .AND.       ln_isfcav)                                   &  
    289                &             CALL zps_hde_isf( kstp, jpts, tsn, gtsu, gtsv,  &    ! Partial steps for top cell (ISF) 
    290                &                                           rhd, gru , grv , aru , arv , gzu , gzv , ge3ru , ge3rv ,   & 
    291                &                                    gtui, gtvi, grui, grvi, arui, arvi, gzui, gzvi, ge3rui, ge3rvi    ) ! of t, s, rd at the last ocean level 
    292          ENDIF 
    293          IF( ln_zdfnpc   )   CALL tra_npc( kstp )                ! update after fields by non-penetrative convection 
    294                              CALL tra_nxt( kstp )                ! tracer fields at next time step 
    295       ENDIF 
    296  
    297       !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    298       ! Dynamics                                    (tsa used as workspace) 
    299       !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    300       IF( lk_dynspg_ts   )  THEN 
    301                                                              ! revert to previously computed momentum tendencies 
    302                                                              ! (not using ua, va as temporary arrays during tracers' update could avoid that) 
    303                                ua(:,:,:) = ua_sv(:,:,:) 
    304                                va(:,:,:) = va_sv(:,:,:) 
    305                                                              ! Revert now divergence and rotational to previously computed ones  
    306                                                              !(needed because of the time swap in div_cur, at the beginning of each time step) 
    307                                hdivn(:,:,:) = hdivb(:,:,:) 
    308                                rotn(:,:,:)  = rotb(:,:,:)  
    309  
    310                                CALL dyn_bfr( kstp )         ! bottom friction 
    311                                CALL dyn_zdf( kstp )         ! vertical diffusion 
    312       ELSE 
    313                                ua(:,:,:) = 0.e0             ! set dynamics trends to zero 
    314                                va(:,:,:) = 0.e0 
    315  
    316         IF(  ln_asmiau .AND. & 
    317            & ln_dyninc      )  CALL dyn_asm_inc( kstp )     ! apply dynamics assimilation increment 
    318         IF( ln_bkgwri )        CALL asm_bkg_wri( kstp )     ! output background fields 
    319         IF( ln_neptsimp )      CALL dyn_nept_cor( kstp )    ! subtract Neptune velocities (simplified) 
    320         IF( lk_bdy          )  CALL bdy_dyn3d_dmp(kstp )    ! bdy damping trends 
    321                                CALL dyn_adv( kstp )         ! advection (vector or flux form) 
    322                                CALL dyn_vor( kstp )         ! vorticity term including Coriolis 
    323                                CALL dyn_ldf( kstp )         ! lateral mixing 
    324         IF( ln_neptsimp )      CALL dyn_nept_cor( kstp )    ! add Neptune velocities (simplified) 
    325 #if defined key_agrif 
    326         IF(.NOT. Agrif_Root()) CALL Agrif_Sponge_dyn        ! momemtum sponge 
    327 #endif 
    328                                CALL dyn_hpg( kstp )         ! horizontal gradient of Hydrostatic pressure 
    329                                CALL dyn_bfr( kstp )         ! bottom friction 
    330                                CALL dyn_zdf( kstp )         ! vertical diffusion 
    331                                CALL dyn_spg( kstp, indic )  ! surface pressure gradient 
    332       ENDIF 
    333                                CALL dyn_nxt( kstp )         ! lateral velocity at next time step 
    334  
    335                                CALL ssh_swp( kstp )         ! swap of sea surface height 
    336       IF( lk_vvl           )   CALL dom_vvl_sf_swp( kstp )  ! swap of vertical scale factors 
    337  
    338       IF( ln_diahsb        )   CALL dia_hsb( kstp )         ! - ML - global conservation diagnostics 
    339       IF( lk_diaobs  )         CALL dia_obs( kstp )         ! obs-minus-model (assimilation) diagnostics (call after dynamics update) 
    340  
    341       !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    342       ! Control and restarts 
    343       !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    344                                CALL stp_ctl( kstp, indic ) 
    345       IF( indic < 0        )   THEN 
    346                                CALL ctl_stop( 'step: indic < 0' ) 
    347                                CALL dia_wri_state( 'output.abort', kstp ) 
    348       ENDIF 
    349       IF( kstp == nit000   )   THEN 
     250                         CALL trc_stp       ( kstp )  ! time-stepping 
     251#endif 
     252 
     253      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     254      ! Active tracers                               
     255      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     256                         tsa(:,:,:,:) = 0._wp         ! set tracer trends to zero 
     257 
     258      IF(  lk_asminc .AND. ln_asmiau .AND. & 
     259         & ln_trainc )   CALL tra_asm_inc   ( kstp )  ! apply tracer assimilation increment 
     260                         CALL tra_sbc       ( kstp )  ! surface boundary condition 
     261      IF( ln_traqsr  )   CALL tra_qsr       ( kstp )  ! penetrative solar radiation qsr 
     262      IF( ln_trabbc  )   CALL tra_bbc       ( kstp )  ! bottom heat flux 
     263      IF( lk_trabbl  )   CALL tra_bbl       ( kstp )  ! advective (and/or diffusive) bottom boundary layer scheme 
     264      IF( ln_tradmp  )   CALL tra_dmp       ( kstp )  ! internal damping trends 
     265      IF( lk_bdy     )   CALL bdy_tra_dmp   ( kstp )  ! bdy damping trends 
     266#if defined key_agrif 
     267      IF(.NOT. Agrif_Root())  &  
     268               &         CALL Agrif_Sponge_tra        ! tracers sponge 
     269#endif 
     270                         CALL tra_adv       ( kstp )  ! horizontal & vertical advection 
     271                         CALL tra_ldf       ( kstp )  ! lateral mixing 
     272 
     273!!gm : why CALL to dia_ptr has been moved here??? (use trends info?) 
     274      IF( ln_diaptr  )   CALL dia_ptr                 ! Poleward adv/ldf TRansports diagnostics 
     275!!gm 
     276                         CALL tra_zdf       ( kstp )  ! vertical mixing and after tracer fields 
     277      IF( ln_zdfnpc  )   CALL tra_npc       ( kstp )  ! update after fields by non-penetrative convection 
     278 
     279      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     280      ! Set boundary conditions and Swap 
     281      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     282!!jc1: For agrif, it would be much better to finalize tracers/momentum here (e.g. bdy conditions) and move the swap  
     283!!    (and time filtering) after Agrif update. Then restart would be done after and would contain updated fields.  
     284!!    If so:  
     285!!    (i) no need to call agrif update at initialization time 
     286!!    (ii) no need to update "before" fields  
     287!! 
     288!!    Apart from creating new tra_swp/dyn_swp routines, this however:  
     289!!    (i) makes boundary conditions at initialization time computed from updated fields which is not the case between  
     290!!    two restarts => restartability issue. One can circumvent this, maybe, by assuming "interface separation",  
     291!!    e.g. a shift of the feedback interface inside child domain.  
     292!!    (ii) requires that all restart outputs of updated variables by agrif (e.g. passive tracers/tke/barotropic arrays) are done at the same 
     293!!    place. 
     294!!  
     295!!jc2: dynnxt must be the latest call. e3t_b are indeed updated in that routine 
     296                         CALL tra_nxt       ( kstp )  ! finalize (bcs) tracer fields at next time step and swap 
     297                         CALL dyn_nxt       ( kstp )  ! finalize (bcs) velocities at next time step and swap 
     298                         CALL ssh_swp       ( kstp )  ! swap of sea surface height 
     299      IF(.NOT.ln_linssh) CALL dom_vvl_sf_swp( kstp )  ! swap of vertical scale factors 
     300      ! 
     301 
     302!!gm : This does not only concern the dynamics ==>>> add a new title 
     303!!gm2: why ouput restart before AGRIF update? 
     304!! 
     305!!jc: That would be better, but see comment above 
     306!! 
     307      IF( lrst_oce   )   CALL rst_write     ( kstp )  ! write output ocean restart file 
     308 
     309#if defined key_agrif 
     310      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     311      ! AGRIF 
     312      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<       
     313                         CALL Agrif_Integrate_ChildGrids( stp )   
     314 
     315      IF( Agrif_NbStepint() == 0 ) THEN               ! AGRIF Update  
     316!!jc in fact update is useless at last time step, but do it for global diagnostics 
     317                         CALL Agrif_Update_Tra()      ! Update active tracers 
     318                         CALL Agrif_Update_Dyn()      ! Update momentum 
     319      ENDIF 
     320#endif 
     321      IF( ln_diahsb  )   CALL dia_hsb( kstp )         ! - ML - global conservation diagnostics 
     322      IF( ln_diaobs  )   CALL dia_obs( kstp )         ! obs-minus-model (assimilation) diagnostics (call after dynamics update) 
     323 
     324      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     325      ! Control 
     326      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
     327                         CALL stp_ctl       ( kstp, indic ) 
     328      IF( indic < 0  ) THEN 
     329                         CALL ctl_stop( 'step: indic < 0' ) 
     330                         CALL dia_wri_state( 'output.abort', kstp ) 
     331      ENDIF 
     332      IF( kstp == nit000 ) THEN 
    350333                 CALL iom_close( numror )     ! close input  ocean restart file 
    351334         IF(lwm) CALL FLUSH    ( numond )     ! flush output namelist oce 
    352          IF( lwm.AND.numoni /= -1 ) CALL FLUSH    ( numoni )     ! flush output namelist ice 
    353       ENDIF 
    354       IF( lrst_oce         )   CALL rst_write    ( kstp )   ! write output ocean restart file 
     335         IF(lwm.AND.numoni /= -1 )   & 
     336            &    CALL FLUSH    ( numoni )     ! flush output namelist ice (if exist) 
     337      ENDIF 
    355338 
    356339      !>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    357340      ! Coupled mode 
    358341      !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 
    359       IF( lk_oasis         )   CALL sbc_cpl_snd( kstp )     ! coupled mode : field exchanges 
     342!!gm why lk_oasis and not lk_cpl ???? 
     343      IF( lk_oasis   )   CALL sbc_cpl_snd( kstp )     ! coupled mode : field exchanges 
    360344      ! 
    361345#if defined key_iomput 
     
    369353      ! 
    370354   END SUBROUTINE stp 
    371  
    372    !!====================================================================== 
     355    
    373356END MODULE step 
Note: See TracChangeset for help on using the changeset viewer.