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.
domain.F90 in NEMO/branches/2019/dev_r11265_ASINTER-01_Guillaume_ABL1D/src/OCE/DOM – NEMO

source: NEMO/branches/2019/dev_r11265_ASINTER-01_Guillaume_ABL1D/src/OCE/DOM/domain.F90 @ 12165

Last change on this file since 12165 was 11413, checked in by gsamson, 5 years ago

dev_r11265_ABL : see #2131

  • merge src and cfgs from HPC-13_IRRMANN_BDY_optimization branch @ r11402 with dev_r11265_ABL branch @ r11363
  • change ORCA2 results due to ice rheology "cleaning" (see commit r11377)
  • Property svn:keywords set to Id
File size: 36.7 KB
RevLine 
[3]1MODULE domain
2   !!==============================================================================
3   !!                       ***  MODULE domain   ***
4   !! Ocean initialization : domain initialization
5   !!==============================================================================
[1438]6   !! History :  OPA  !  1990-10  (C. Levy - G. Madec)  Original code
7   !!                 !  1992-01  (M. Imbard) insert time step initialization
8   !!                 !  1996-06  (G. Madec) generalized vertical coordinate
9   !!                 !  1997-02  (G. Madec) creation of domwri.F
10   !!                 !  2001-05  (E.Durand - G. Madec) insert closed sea
11   !!   NEMO     1.0  !  2002-08  (G. Madec)  F90: Free form and module
12   !!            2.0  !  2005-11  (V. Garnier) Surface pressure gradient organization
[2528]13   !!            3.3  !  2010-11  (G. Madec)  initialisation in C1D configuration
[4152]14   !!            3.6  !  2013     ( J. Simeon, C. Calone, G. Madec, C. Ethe ) Online coarsening of outputs
[6140]15   !!            3.7  !  2015-11  (G. Madec, A. Coward)  time varying zgr by default
[7646]16   !!            4.0  !  2016-10  (G. Madec, S. Flavoni)  domain configuration / user defined interface
[3]17   !!----------------------------------------------------------------------
[1438]18   
19   !!----------------------------------------------------------------------
[7646]20   !!   dom_init      : initialize the space and time domain
21   !!   dom_glo       : initialize global domain <--> local domain indices
22   !!   dom_nam       : read and contral domain namelists
23   !!   dom_ctl       : control print for the ocean domain
24   !!   domain_cfg    : read the global domain size in domain configuration file
25   !!   cfg_write     : create the domain configuration file
[3]26   !!----------------------------------------------------------------------
[7646]27   USE oce            ! ocean variables
28   USE dom_oce        ! domain: ocean
29   USE sbc_oce        ! surface boundary condition: ocean
30   USE trc_oce        ! shared ocean & passive tracers variab
31   USE phycst         ! physical constants
[9161]32   USE closea         ! closed seas
[7646]33   USE domhgr         ! domain: set the horizontal mesh
34   USE domzgr         ! domain: set the vertical mesh
35   USE dommsk         ! domain: set the mask system
36   USE domwri         ! domain: write the meshmask file
37   USE domvvl         ! variable volume
38   USE c1d            ! 1D configuration
39   USE dyncor_c1d     ! 1D configuration: Coriolis term    (cor_c1d routine)
[9023]40   USE wet_dry,  ONLY : ll_wd
[5836]41   !
[7646]42   USE in_out_manager ! I/O manager
43   USE iom            ! I/O library
44   USE lbclnk         ! ocean lateral boundary condition (or mpp link)
45   USE lib_mpp        ! distributed memory computing library
[3]46
47   IMPLICIT NONE
48   PRIVATE
49
[7646]50   PUBLIC   dom_init     ! called by nemogcm.F90
51   PUBLIC   domain_cfg   ! called by nemogcm.F90
[3]52
[1438]53   !!-------------------------------------------------------------------------
[9598]54   !! NEMO/OCE 4.0 , NEMO Consortium (2018)
[888]55   !! $Id$
[10068]56   !! Software governed by the CeCILL license (see ./LICENSE)
[1438]57   !!-------------------------------------------------------------------------
[3]58CONTAINS
59
[9367]60   SUBROUTINE dom_init(cdstr)
[3]61      !!----------------------------------------------------------------------
62      !!                  ***  ROUTINE dom_init  ***
63      !!                   
64      !! ** Purpose :   Domain initialization. Call the routines that are
[1601]65      !!              required to create the arrays which define the space
66      !!              and time domain of the ocean model.
[3]67      !!
[1601]68      !! ** Method  : - dom_msk: compute the masks from the bathymetry file
69      !!              - dom_hgr: compute or read the horizontal grid-point position
70      !!                         and scale factors, and the coriolis factor
71      !!              - dom_zgr: define the vertical coordinate and the bathymetry
[9169]72      !!              - dom_wri: create the meshmask file (ln_meshmask=T)
[2528]73      !!              - 1D configuration, move Coriolis, u and v at T-point
[3]74      !!----------------------------------------------------------------------
[7646]75      INTEGER ::   ji, jj, jk, ik   ! dummy loop indices
76      INTEGER ::   iconf = 0    ! local integers
77      CHARACTER (len=64) ::   cform = "(A12, 3(A13, I7))" 
[9367]78      CHARACTER (len=*), INTENT(IN) :: cdstr                  ! model: NEMO or SAS. Determines core restart variables
[7646]79      INTEGER , DIMENSION(jpi,jpj) ::   ik_top , ik_bot       ! top and bottom ocean level
80      REAL(wp), DIMENSION(jpi,jpj) ::   z1_hu_0, z1_hv_0
[3]81      !!----------------------------------------------------------------------
[1601]82      !
[7646]83      IF(lwp) THEN         ! Ocean domain Parameters (control print)
[3]84         WRITE(numout,*)
85         WRITE(numout,*) 'dom_init : domain initialization'
86         WRITE(numout,*) '~~~~~~~~'
[7646]87         !
88         WRITE(numout,*)     '   Domain info'
89         WRITE(numout,*)     '      dimension of model:'
90         WRITE(numout,*)     '             Local domain      Global domain       Data domain '
91         WRITE(numout,cform) '        ','   jpi     : ', jpi, '   jpiglo  : ', jpiglo
92         WRITE(numout,cform) '        ','   jpj     : ', jpj, '   jpjglo  : ', jpjglo
93         WRITE(numout,cform) '        ','   jpk     : ', jpk, '   jpkglo  : ', jpkglo
94         WRITE(numout,cform) '       ' ,'   jpij    : ', jpij
95         WRITE(numout,*)     '      mpp local domain info (mpp):'
[9019]96         WRITE(numout,*)     '              jpni    : ', jpni, '   nn_hls  : ', nn_hls
97         WRITE(numout,*)     '              jpnj    : ', jpnj, '   nn_hls  : ', nn_hls
[7646]98         WRITE(numout,*)     '              jpnij   : ', jpnij
99         WRITE(numout,*)     '      lateral boundary of the Global domain : jperio  = ', jperio
100         SELECT CASE ( jperio )
101         CASE( 0 )   ;   WRITE(numout,*) '         (i.e. closed)'
102         CASE( 1 )   ;   WRITE(numout,*) '         (i.e. cyclic east-west)'
[11258]103         CASE( 2 )   ;   WRITE(numout,*) '         (i.e. cyclic north-south)'
[7646]104         CASE( 3 )   ;   WRITE(numout,*) '         (i.e. north fold with T-point pivot)'
105         CASE( 4 )   ;   WRITE(numout,*) '         (i.e. cyclic east-west and north fold with T-point pivot)'
106         CASE( 5 )   ;   WRITE(numout,*) '         (i.e. north fold with F-point pivot)'
107         CASE( 6 )   ;   WRITE(numout,*) '         (i.e. cyclic east-west and north fold with F-point pivot)'
[7822]108         CASE( 7 )   ;   WRITE(numout,*) '         (i.e. cyclic east-west and north-south)'
[7646]109         CASE DEFAULT
110            CALL ctl_stop( 'jperio is out of range' )
111         END SELECT
112         WRITE(numout,*)     '      Ocean model configuration used:'
[9169]113         WRITE(numout,*)     '         cn_cfg = ', TRIM( cn_cfg ), '   nn_cfg = ', nn_cfg
[3]114      ENDIF
[9405]115      lwxios = .FALSE.
116      ln_xios_read = .FALSE.
[1601]117      !
[7646]118      !           !==  Reference coordinate system  ==!
[6140]119      !
[7646]120      CALL dom_glo                     ! global domain versus local domain
121      CALL dom_nam                     ! read namelist ( namrun, namdom )
[9367]122      !
123      IF( lwxios ) THEN
124!define names for restart write and set core output (restart.F90)
125         CALL iom_set_rst_vars(rst_wfields)
126         CALL iom_set_rstw_core(cdstr)
127      ENDIF
128!reset namelist for SAS
129      IF(cdstr == 'SAS') THEN
130         IF(lrxios) THEN
131               IF(lwp) write(numout,*) 'Disable reading restart file using XIOS for SAS'
132               lrxios = .FALSE.
133         ENDIF
134      ENDIF
135      !
[7646]136      CALL dom_hgr                     ! Horizontal mesh
137      CALL dom_zgr( ik_top, ik_bot )   ! Vertical mesh and bathymetry
138      CALL dom_msk( ik_top, ik_bot )   ! Masks
[9209]139      IF( ln_closea )   CALL dom_clo   ! ln_closea=T : closed seas included in the simulation
[9161]140                                       ! Read in masks to define closed seas and lakes
[7646]141      !
142      DO jj = 1, jpj                   ! depth of the iceshelves
143         DO ji = 1, jpi
144            ik = mikt(ji,jj)
145            risfdep(ji,jj) = gdepw_0(ji,jj,ik)
146         END DO
147      END DO
148      !
[7753]149      ht_0(:,:) = 0._wp  ! Reference ocean thickness
150      hu_0(:,:) = 0._wp
151      hv_0(:,:) = 0._wp
[7646]152      DO jk = 1, jpk
[7753]153         ht_0(:,:) = ht_0(:,:) + e3t_0(:,:,jk) * tmask(:,:,jk)
154         hu_0(:,:) = hu_0(:,:) + e3u_0(:,:,jk) * umask(:,:,jk)
155         hv_0(:,:) = hv_0(:,:) + e3v_0(:,:,jk) * vmask(:,:,jk)
[4490]156      END DO
157      !
[7646]158      !           !==  time varying part of coordinate system  ==!
[1601]159      !
[7646]160      IF( ln_linssh ) THEN       != Fix in time : set to the reference one for all
161      !
[6140]162         !       before        !          now          !       after         !
[6981]163            gdept_b = gdept_0  ;   gdept_n = gdept_0   !        ---          ! depth of grid-points
164            gdepw_b = gdepw_0  ;   gdepw_n = gdepw_0   !        ---          !
165                                   gde3w_n = gde3w_0   !        ---          !
[6140]166         !                                                                 
[6981]167              e3t_b =   e3t_0  ;     e3t_n =   e3t_0   ;   e3t_a =  e3t_0    ! scale factors
168              e3u_b =   e3u_0  ;     e3u_n =   e3u_0   ;   e3u_a =  e3u_0    !
169              e3v_b =   e3v_0  ;     e3v_n =   e3v_0   ;   e3v_a =  e3v_0    !
170                                     e3f_n =   e3f_0   !        ---          !
171              e3w_b =   e3w_0  ;     e3w_n =   e3w_0   !        ---          !
172             e3uw_b =  e3uw_0  ;    e3uw_n =  e3uw_0   !        ---          !
173             e3vw_b =  e3vw_0  ;    e3vw_n =  e3vw_0   !        ---          !
[6140]174         !
[7753]175         z1_hu_0(:,:) = ssumask(:,:) / ( hu_0(:,:) + 1._wp - ssumask(:,:) )     ! _i mask due to ISF
176         z1_hv_0(:,:) = ssvmask(:,:) / ( hv_0(:,:) + 1._wp - ssvmask(:,:) )
[6140]177         !
178         !        before       !          now          !       after         !
[6981]179                                      ht_n =    ht_0   !                     ! water column thickness
180               hu_b =    hu_0  ;      hu_n =    hu_0   ;    hu_a =    hu_0   !
181               hv_b =    hv_0  ;      hv_n =    hv_0   ;    hv_a =    hv_0   !
182            r1_hu_b = z1_hu_0  ;   r1_hu_n = z1_hu_0   ; r1_hu_a = z1_hu_0   ! inverse of water column thickness
183            r1_hv_b = z1_hv_0  ;   r1_hv_n = z1_hv_0   ; r1_hv_a = z1_hv_0   !
[6140]184         !
185         !
[7646]186      ELSE                       != time varying : initialize before/now/after variables
[6140]187         !
[7646]188         IF( .NOT.l_offline )  CALL dom_vvl_init 
[6140]189         !
190      ENDIF
[2528]191      !
[6140]192      IF( lk_c1d         )   CALL cor_c1d       ! 1D configuration: Coriolis set at T-point
[4370]193      !
[9169]194      IF( ln_meshmask .AND. .NOT.ln_iscpl )                        CALL dom_wri     ! Create a domain file
195      IF( ln_meshmask .AND.      ln_iscpl .AND. .NOT.ln_rstart )   CALL dom_wri     ! Create a domain file
196      IF(                                       .NOT.ln_rstart )   CALL dom_ctl     ! Domain control
[1438]197      !
[9169]198      IF( ln_write_cfg )   CALL cfg_write         ! create the configuration file
199      !
[7646]200      IF(lwp) THEN
201         WRITE(numout,*)
[9169]202         WRITE(numout,*) 'dom_init :   ==>>>   END of domain initialization'
203         WRITE(numout,*) '~~~~~~~~'
[7646]204         WRITE(numout,*) 
205      ENDIF
206      !
[3]207   END SUBROUTINE dom_init
208
209
[7646]210   SUBROUTINE dom_glo
211      !!----------------------------------------------------------------------
212      !!                     ***  ROUTINE dom_glo  ***
213      !!
214      !! ** Purpose :   initialization of global domain <--> local domain indices
215      !!
216      !! ** Method  :   
217      !!
218      !! ** Action  : - mig , mjg : local  domain indices ==> global domain indices
219      !!              - mi0 , mi1 : global domain indices ==> local  domain indices
220      !!              - mj0,, mj1   (global point not in the local domain ==> mi0>mi1 and/or mj0>mj1)
221      !!----------------------------------------------------------------------
222      INTEGER ::   ji, jj   ! dummy loop argument
223      !!----------------------------------------------------------------------
224      !
225      DO ji = 1, jpi                 ! local domain indices ==> global domain indices
226        mig(ji) = ji + nimpp - 1
227      END DO
228      DO jj = 1, jpj
229        mjg(jj) = jj + njmpp - 1
230      END DO
231      !                              ! global domain indices ==> local domain indices
232      !                                   ! (return (m.0,m.1)=(1,0) if data domain gridpoint is to the west/south of the
233      !                                   ! local domain, or (m.0,m.1)=(jp.+1,jp.) to the east/north of local domain.
234      DO ji = 1, jpiglo
235        mi0(ji) = MAX( 1 , MIN( ji - nimpp + 1, jpi+1 ) )
236        mi1(ji) = MAX( 0 , MIN( ji - nimpp + 1, jpi   ) )
237      END DO
238      DO jj = 1, jpjglo
239        mj0(jj) = MAX( 1 , MIN( jj - njmpp + 1, jpj+1 ) )
240        mj1(jj) = MAX( 0 , MIN( jj - njmpp + 1, jpj   ) )
241      END DO
242      IF(lwp) THEN                   ! control print
243         WRITE(numout,*)
244         WRITE(numout,*) 'dom_glo : domain: global <<==>> local '
245         WRITE(numout,*) '~~~~~~~ '
246         WRITE(numout,*) '   global domain:   jpiglo = ', jpiglo, ' jpjglo = ', jpjglo, ' jpkglo = ', jpkglo
247         WRITE(numout,*) '   local  domain:   jpi    = ', jpi   , ' jpj    = ', jpj   , ' jpk    = ', jpk
248         WRITE(numout,*)
249         WRITE(numout,*) '   conversion from local to global domain indices (and vise versa) done'
250         IF( nn_print >= 1 ) THEN
251            WRITE(numout,*)
[9019]252            WRITE(numout,*) '          conversion local  ==> global i-index domain (mig)'
[7646]253            WRITE(numout,25)              (mig(ji),ji = 1,jpi)
254            WRITE(numout,*)
255            WRITE(numout,*) '          conversion global ==> local  i-index domain'
[9019]256            WRITE(numout,*) '             starting index (mi0)'
[7646]257            WRITE(numout,25)              (mi0(ji),ji = 1,jpiglo)
[9019]258            WRITE(numout,*) '             ending index (mi1)'
[7646]259            WRITE(numout,25)              (mi1(ji),ji = 1,jpiglo)
260            WRITE(numout,*)
[9019]261            WRITE(numout,*) '          conversion local  ==> global j-index domain (mjg)'
[7646]262            WRITE(numout,25)              (mjg(jj),jj = 1,jpj)
263            WRITE(numout,*)
264            WRITE(numout,*) '          conversion global ==> local  j-index domain'
[9019]265            WRITE(numout,*) '             starting index (mj0)'
[7646]266            WRITE(numout,25)              (mj0(jj),jj = 1,jpjglo)
[9019]267            WRITE(numout,*) '             ending index (mj1)'
[7646]268            WRITE(numout,25)              (mj1(jj),jj = 1,jpjglo)
269         ENDIF
270      ENDIF
271 25   FORMAT( 100(10x,19i4,/) )
272      !
273   END SUBROUTINE dom_glo
274
275
[3]276   SUBROUTINE dom_nam
277      !!----------------------------------------------------------------------
278      !!                     ***  ROUTINE dom_nam  ***
279      !!                   
280      !! ** Purpose :   read domaine namelists and print the variables.
281      !!
282      !! ** input   : - namrun namelist
283      !!              - namdom namelist
[2528]284      !!              - namnc4 namelist   ! "key_netcdf4" only
[3]285      !!----------------------------------------------------------------------
286      USE ioipsl
[9169]287      !!
288      INTEGER  ::   ios   ! Local integer
289      !
[6140]290      NAMELIST/namrun/ cn_ocerst_indir, cn_ocerst_outdir, nn_stocklist, ln_rst_list,                 &
[7646]291         &             nn_no   , cn_exp   , cn_ocerst_in, cn_ocerst_out, ln_rstart , nn_rstctl ,     &
[6140]292         &             nn_it000, nn_itend , nn_date0    , nn_time0     , nn_leapy  , nn_istate ,     &
293         &             nn_stock, nn_write , ln_mskland  , ln_clobber   , nn_chunksz, nn_euler  ,     &
[9367]294         &             ln_cfmeta, ln_iscpl, ln_xios_read, nn_wxios
[9169]295      NAMELIST/namdom/ ln_linssh, rn_isfhmin, rn_rdt, rn_atfp, ln_crs, ln_meshmask
[2528]296#if defined key_netcdf4
297      NAMELIST/namnc4/ nn_nchunks_i, nn_nchunks_j, nn_nchunks_k, ln_nc4zip
298#endif
[3]299      !!----------------------------------------------------------------------
[7646]300      !
[9169]301      IF(lwp) THEN
302         WRITE(numout,*)
[9190]303         WRITE(numout,*) 'dom_nam : domain initialization through namelist read'
[9169]304         WRITE(numout,*) '~~~~~~~ '
305      ENDIF
306      !
[9367]307      !
[4147]308      REWIND( numnam_ref )              ! Namelist namrun in reference namelist : Parameters of the run
309      READ  ( numnam_ref, namrun, IOSTAT = ios, ERR = 901)
[11348]310901   IF( ios /= 0 )   CALL ctl_nam ( ios , 'namrun in reference namelist' )
[4147]311      REWIND( numnam_cfg )              ! Namelist namrun in configuration namelist : Parameters of the run
312      READ  ( numnam_cfg, namrun, IOSTAT = ios, ERR = 902 )
[11348]313902   IF( ios >  0 )   CALL ctl_nam ( ios , 'namrun in configuration namelist' )
[4624]314      IF(lwm) WRITE ( numond, namrun )
[1601]315      !
316      IF(lwp) THEN                  ! control print
[9190]317         WRITE(numout,*) '   Namelist : namrun   ---   run parameters'
[9490]318         WRITE(numout,*) '      Assimilation cycle              nn_no           = ', nn_no
[9169]319         WRITE(numout,*) '      experiment name for output      cn_exp          = ', TRIM( cn_exp           )
320         WRITE(numout,*) '      file prefix restart input       cn_ocerst_in    = ', TRIM( cn_ocerst_in     )
321         WRITE(numout,*) '      restart input directory         cn_ocerst_indir = ', TRIM( cn_ocerst_indir  )
322         WRITE(numout,*) '      file prefix restart output      cn_ocerst_out   = ', TRIM( cn_ocerst_out    )
323         WRITE(numout,*) '      restart output directory        cn_ocerst_outdir= ', TRIM( cn_ocerst_outdir )
324         WRITE(numout,*) '      restart logical                 ln_rstart       = ', ln_rstart
325         WRITE(numout,*) '      start with forward time step    nn_euler        = ', nn_euler
326         WRITE(numout,*) '      control of time step            nn_rstctl       = ', nn_rstctl
327         WRITE(numout,*) '      number of the first time step   nn_it000        = ', nn_it000
328         WRITE(numout,*) '      number of the last time step    nn_itend        = ', nn_itend
329         WRITE(numout,*) '      initial calendar date aammjj    nn_date0        = ', nn_date0
330         WRITE(numout,*) '      initial time of day in hhmm     nn_time0        = ', nn_time0
331         WRITE(numout,*) '      leap year calendar (0/1)        nn_leapy        = ', nn_leapy
332         WRITE(numout,*) '      initial state output            nn_istate       = ', nn_istate
[5341]333         IF( ln_rst_list ) THEN
[9169]334            WRITE(numout,*) '      list of restart dump times      nn_stocklist    =', nn_stocklist
[5341]335         ELSE
[9169]336            WRITE(numout,*) '      frequency of restart file       nn_stock        = ', nn_stock
[5341]337         ENDIF
[11413]338#if ! defined key_iomput
[9169]339         WRITE(numout,*) '      frequency of output file        nn_write        = ', nn_write
[11413]340#endif
[9169]341         WRITE(numout,*) '      mask land points                ln_mskland      = ', ln_mskland
342         WRITE(numout,*) '      additional CF standard metadata ln_cfmeta       = ', ln_cfmeta
343         WRITE(numout,*) '      overwrite an existing file      ln_clobber      = ', ln_clobber
344         WRITE(numout,*) '      NetCDF chunksize (bytes)        nn_chunksz      = ', nn_chunksz
345         WRITE(numout,*) '      IS coupling at the restart step ln_iscpl        = ', ln_iscpl
[9367]346         IF( TRIM(Agrif_CFixed()) == '0' ) THEN
347            WRITE(numout,*) '      READ restart for a single file using XIOS ln_xios_read =', ln_xios_read
348            WRITE(numout,*) '      Write restart using XIOS        nn_wxios   = ', nn_wxios
349         ELSE
350            WRITE(numout,*) "      AGRIF: nn_wxios will be ingored. See setting for parent"
351            WRITE(numout,*) "      AGRIF: ln_xios_read will be ingored. See setting for parent"
352         ENDIF
[3]353      ENDIF
354
[9490]355      cexper = cn_exp         ! conversion DOCTOR names into model names (this should disappear soon)
[1601]356      nrstdt = nn_rstctl
357      nit000 = nn_it000
358      nitend = nn_itend
359      ndate0 = nn_date0
360      nleapy = nn_leapy
361      ninist = nn_istate
[4370]362      neuler = nn_euler
[9168]363      IF( neuler == 1 .AND. .NOT. ln_rstart ) THEN
364         IF(lwp) WRITE(numout,*) 
[9169]365         IF(lwp) WRITE(numout,*)'   ==>>>   Start from rest (ln_rstart=F)'
366         IF(lwp) WRITE(numout,*)'           an Euler initial time step is used : nn_euler is forced to 0 '   
[4370]367         neuler = 0
368      ENDIF
[1601]369      !                             ! control of output frequency
[11413]370      IF( .NOT. ln_rst_list ) THEN     ! we use nn_stock
371         IF( nn_stock == -1 )   CALL ctl_warn( 'nn_stock = -1 --> no restart will be done' )
372         IF( nn_stock == 0 .OR. nn_stock > nitend ) THEN
373            WRITE(ctmp1,*) 'nn_stock = ', nn_stock, ' it is forced to ', nitend
374            CALL ctl_warn( ctmp1 )
375            nn_stock = nitend
376         ENDIF
[3]377      ENDIF
[11413]378#if ! defined key_iomput
379      IF( nn_write == -1 )   CALL ctl_warn( 'nn_write = -1 --> no output files will be done' )
380      IF ( nn_write == 0 ) THEN
381         WRITE(ctmp1,*) 'nn_write = ', nn_write, ' it is forced to ', nitend
[783]382         CALL ctl_warn( ctmp1 )
[11413]383         nn_write = nitend
[3]384      ENDIF
[11413]385#endif
[3]386
[2528]387#if defined key_agrif
[1601]388      IF( Agrif_Root() ) THEN
[2528]389#endif
[9190]390      IF(lwp) WRITE(numout,*)
[2528]391      SELECT CASE ( nleapy )        ! Choose calendar for IOIPSL
392      CASE (  1 ) 
393         CALL ioconf_calendar('gregorian')
[9190]394         IF(lwp) WRITE(numout,*) '   ==>>>   The IOIPSL calendar is "gregorian", i.e. leap year'
[2528]395      CASE (  0 )
396         CALL ioconf_calendar('noleap')
[9190]397         IF(lwp) WRITE(numout,*) '   ==>>>   The IOIPSL calendar is "noleap", i.e. no leap year'
[2528]398      CASE ( 30 )
399         CALL ioconf_calendar('360d')
[9190]400         IF(lwp) WRITE(numout,*) '   ==>>>   The IOIPSL calendar is "360d", i.e. 360 days in a year'
[2528]401      END SELECT
402#if defined key_agrif
[1601]403      ENDIF
[2528]404#endif
[3]405
[4147]406      REWIND( numnam_ref )              ! Namelist namdom in reference namelist : space & time domain (bathymetry, mesh, timestep)
407      READ  ( numnam_ref, namdom, IOSTAT = ios, ERR = 903)
[11348]408903   IF( ios /= 0 )   CALL ctl_nam ( ios , 'namdom in reference namelist' )
[4147]409      REWIND( numnam_cfg )              ! Namelist namdom in configuration namelist : space & time domain (bathymetry, mesh, timestep)
410      READ  ( numnam_cfg, namdom, IOSTAT = ios, ERR = 904 )
[11348]411904   IF( ios >  0 )   CALL ctl_nam ( ios , 'namdom in configuration namelist' )
[9169]412      IF(lwm) WRITE( numond, namdom )
[5836]413      !
[3]414      IF(lwp) THEN
[72]415         WRITE(numout,*)
[9169]416         WRITE(numout,*) '   Namelist : namdom   ---   space & time domain'
417         WRITE(numout,*) '      linear free surface (=T)                ln_linssh   = ', ln_linssh
418         WRITE(numout,*) '      create mesh/mask file                   ln_meshmask = ', ln_meshmask
419         WRITE(numout,*) '      treshold to open the isf cavity         rn_isfhmin  = ', rn_isfhmin, ' [m]'
420         WRITE(numout,*) '      ocean time step                         rn_rdt      = ', rn_rdt
421         WRITE(numout,*) '      asselin time filter parameter           rn_atfp     = ', rn_atfp
422         WRITE(numout,*) '      online coarsening of dynamical fields   ln_crs      = ', ln_crs
[223]423      ENDIF
[5836]424      !
[9169]425      !          ! conversion DOCTOR names into model names (this should disappear soon)
426      atfp = rn_atfp
427      rdt  = rn_rdt
[1601]428
[9367]429      IF( TRIM(Agrif_CFixed()) == '0' ) THEN
430         lrxios = ln_xios_read.AND.ln_rstart
431!set output file type for XIOS based on NEMO namelist
432         IF (nn_wxios > 0) lwxios = .TRUE. 
433         nxioso = nn_wxios
434      ENDIF
435
[2528]436#if defined key_netcdf4
437      !                             ! NetCDF 4 case   ("key_netcdf4" defined)
[4147]438      REWIND( numnam_ref )              ! Namelist namnc4 in reference namelist : NETCDF
439      READ  ( numnam_ref, namnc4, IOSTAT = ios, ERR = 907)
[11348]440907   IF( ios /= 0 )   CALL ctl_nam ( ios , 'namnc4 in reference namelist' )
[4147]441      REWIND( numnam_cfg )              ! Namelist namnc4 in configuration namelist : NETCDF
442      READ  ( numnam_cfg, namnc4, IOSTAT = ios, ERR = 908 )
[11348]443908   IF( ios >  0 )   CALL ctl_nam ( ios , 'namnc4 in configuration namelist' )
[4624]444      IF(lwm) WRITE( numond, namnc4 )
[4147]445
[2528]446      IF(lwp) THEN                        ! control print
447         WRITE(numout,*)
448         WRITE(numout,*) '   Namelist namnc4 - Netcdf4 chunking parameters'
[9169]449         WRITE(numout,*) '      number of chunks in i-dimension             nn_nchunks_i = ', nn_nchunks_i
450         WRITE(numout,*) '      number of chunks in j-dimension             nn_nchunks_j = ', nn_nchunks_j
451         WRITE(numout,*) '      number of chunks in k-dimension             nn_nchunks_k = ', nn_nchunks_k
452         WRITE(numout,*) '      apply netcdf4/hdf5 chunking & compression   ln_nc4zip    = ', ln_nc4zip
[2528]453      ENDIF
[1601]454
[2528]455      ! Put the netcdf4 settings into a simple structure (snc4set, defined in in_out_manager module)
456      ! Note the chunk size in the unlimited (time) dimension will be fixed at 1
457      snc4set%ni   = nn_nchunks_i
458      snc4set%nj   = nn_nchunks_j
459      snc4set%nk   = nn_nchunks_k
460      snc4set%luse = ln_nc4zip
461#else
462      snc4set%luse = .FALSE.        ! No NetCDF 4 case
463#endif
[1438]464      !
[3]465   END SUBROUTINE dom_nam
466
467
468   SUBROUTINE dom_ctl
469      !!----------------------------------------------------------------------
470      !!                     ***  ROUTINE dom_ctl  ***
471      !!
472      !! ** Purpose :   Domain control.
473      !!
474      !! ** Method  :   compute and print extrema of masked scale factors
475      !!----------------------------------------------------------------------
[10425]476      INTEGER, DIMENSION(2) ::   imi1, imi2, ima1, ima2
[1601]477      INTEGER, DIMENSION(2) ::   iloc   !
[3]478      REAL(wp) ::   ze1min, ze1max, ze2min, ze2max
479      !!----------------------------------------------------------------------
[1601]480      !
481      IF(lk_mpp) THEN
[10425]482         CALL mpp_minloc( 'domain', e1t(:,:), tmask_i(:,:), ze1min, imi1 )
483         CALL mpp_minloc( 'domain', e2t(:,:), tmask_i(:,:), ze2min, imi2 )
484         CALL mpp_maxloc( 'domain', e1t(:,:), tmask_i(:,:), ze1max, ima1 )
485         CALL mpp_maxloc( 'domain', e2t(:,:), tmask_i(:,:), ze2max, ima2 )
[181]486      ELSE
[4990]487         ze1min = MINVAL( e1t(:,:), mask = tmask_i(:,:) == 1._wp )   
488         ze2min = MINVAL( e2t(:,:), mask = tmask_i(:,:) == 1._wp )   
489         ze1max = MAXVAL( e1t(:,:), mask = tmask_i(:,:) == 1._wp )   
490         ze2max = MAXVAL( e2t(:,:), mask = tmask_i(:,:) == 1._wp )   
[7646]491         !
[4990]492         iloc  = MINLOC( e1t(:,:), mask = tmask_i(:,:) == 1._wp )
[10425]493         imi1(1) = iloc(1) + nimpp - 1
494         imi1(2) = iloc(2) + njmpp - 1
[4990]495         iloc  = MINLOC( e2t(:,:), mask = tmask_i(:,:) == 1._wp )
[10425]496         imi2(1) = iloc(1) + nimpp - 1
497         imi2(2) = iloc(2) + njmpp - 1
[4990]498         iloc  = MAXLOC( e1t(:,:), mask = tmask_i(:,:) == 1._wp )
[10425]499         ima1(1) = iloc(1) + nimpp - 1
500         ima1(2) = iloc(2) + njmpp - 1
[4990]501         iloc  = MAXLOC( e2t(:,:), mask = tmask_i(:,:) == 1._wp )
[10425]502         ima2(1) = iloc(1) + nimpp - 1
503         ima2(2) = iloc(2) + njmpp - 1
[32]504      ENDIF
[3]505      IF(lwp) THEN
[1601]506         WRITE(numout,*)
507         WRITE(numout,*) 'dom_ctl : extrema of the masked scale factors'
508         WRITE(numout,*) '~~~~~~~'
[10425]509         WRITE(numout,"(14x,'e1t maxi: ',1f10.2,' at i = ',i5,' j= ',i5)") ze1max, ima1(1), ima1(2)
510         WRITE(numout,"(14x,'e1t mini: ',1f10.2,' at i = ',i5,' j= ',i5)") ze1min, imi1(1), imi1(2)
511         WRITE(numout,"(14x,'e2t maxi: ',1f10.2,' at i = ',i5,' j= ',i5)") ze2max, ima2(1), ima2(2)
512         WRITE(numout,"(14x,'e2t mini: ',1f10.2,' at i = ',i5,' j= ',i5)") ze2min, imi2(1), imi2(2)
[3]513      ENDIF
[1438]514      !
[3]515   END SUBROUTINE dom_ctl
516
[5836]517
[11348]518   SUBROUTINE domain_cfg( cd_cfg, kk_cfg, kpi, kpj, kpk, kperio )
[3680]519      !!----------------------------------------------------------------------
[7646]520      !!                     ***  ROUTINE dom_nam  ***
521      !!                   
522      !! ** Purpose :   read the domain size in domain configuration file
[3680]523      !!
[9169]524      !! ** Method  :   read the cn_domcfg NetCDF file
[3680]525      !!----------------------------------------------------------------------
[7646]526      CHARACTER(len=*)              , INTENT(out) ::   cd_cfg          ! configuration name
527      INTEGER                       , INTENT(out) ::   kk_cfg          ! configuration resolution
528      INTEGER                       , INTENT(out) ::   kpi, kpj, kpk   ! global domain sizes
529      INTEGER                       , INTENT(out) ::   kperio          ! lateral global domain b.c.
530      !
[11348]531      INTEGER ::   inum   ! local integer
[7646]532      REAL(wp) ::   zorca_res                     ! local scalars
[11258]533      REAL(wp) ::   zperio                        !   -      -
534      INTEGER, DIMENSION(4) ::   idvar, idimsz    ! size   of dimensions
[3680]535      !!----------------------------------------------------------------------
[5836]536      !
[11348]537      IF(lwp) THEN
538         WRITE(numout,*) '           '
539         WRITE(numout,*) 'domain_cfg : domain size read in ', TRIM( cn_domcfg ), ' file'
540         WRITE(numout,*) '~~~~~~~~~~ '
541      ENDIF
[5836]542      !
[7646]543      CALL iom_open( cn_domcfg, inum )
[5836]544      !
[7646]545      !                                   !- ORCA family specificity
546      IF(  iom_varid( inum, 'ORCA'       , ldstop = .FALSE. ) > 0  .AND.  &
547         & iom_varid( inum, 'ORCA_index' , ldstop = .FALSE. ) > 0    ) THEN
548         !
549         cd_cfg = 'ORCA'
[9919]550         CALL iom_get( inum, 'ORCA_index', zorca_res )   ;   kk_cfg = NINT( zorca_res )
[7646]551         !
[11348]552         IF(lwp) THEN
553            WRITE(numout,*) '   .'
554            WRITE(numout,*) '   ==>>>   ORCA configuration '
555            WRITE(numout,*) '   .'
556         ENDIF
[7646]557         !
558      ELSE                                !- cd_cfg & k_cfg are not used
559         cd_cfg = 'UNKNOWN'
560         kk_cfg = -9999999
561                                          !- or they may be present as global attributes
562                                          !- (netcdf only) 
[10425]563         CALL iom_getatt( inum, 'cn_cfg', cd_cfg )  ! returns   !  if not found
564         CALL iom_getatt( inum, 'nn_cfg', kk_cfg )  ! returns -999 if not found
565         IF( TRIM(cd_cfg) == '!') cd_cfg = 'UNKNOWN'
566         IF( kk_cfg == -999     ) kk_cfg = -9999999
[7646]567         !
568      ENDIF
[11258]569       !
570      idvar = iom_varid( inum, 'e3t_0', kdimsz = idimsz )   ! use e3t_0, that must exist, to get jp(ijk)glo
571      kpi = idimsz(1)
572      kpj = idimsz(2)
573      kpk = idimsz(3)
[9919]574      CALL iom_get( inum, 'jperio', zperio )   ;   kperio = NINT( zperio )
[7646]575      CALL iom_close( inum )
576      !
[11348]577      IF(lwp) THEN
578         WRITE(numout,*) '      cn_cfg = ', TRIM(cd_cfg), '   nn_cfg = ', kk_cfg
579         WRITE(numout,*) '      jpiglo = ', kpi
580         WRITE(numout,*) '      jpjglo = ', kpj
581         WRITE(numout,*) '      jpkglo = ', kpk
582         WRITE(numout,*) '      type of global domain lateral boundary   jperio = ', kperio
583      ENDIF
[7646]584      !       
585   END SUBROUTINE domain_cfg
586   
587   
588   SUBROUTINE cfg_write
589      !!----------------------------------------------------------------------
590      !!                  ***  ROUTINE cfg_write  ***
591      !!                   
592      !! ** Purpose :   Create the "cn_domcfg_out" file, a NetCDF file which
593      !!              contains all the ocean domain informations required to
594      !!              define an ocean configuration.
595      !!
596      !! ** Method  :   Write in a file all the arrays required to set up an
597      !!              ocean configuration.
598      !!
599      !! ** output file :   domcfg_out.nc : domain size, characteristics, horizontal
600      !!                       mesh, Coriolis parameter, and vertical scale factors
601      !!                    NB: also contain ORCA family information
602      !!----------------------------------------------------------------------
603      INTEGER           ::   ji, jj, jk   ! dummy loop indices
604      INTEGER           ::   izco, izps, isco, icav
605      INTEGER           ::   inum     ! local units
606      CHARACTER(len=21) ::   clnam    ! filename (mesh and mask informations)
607      REAL(wp), DIMENSION(jpi,jpj) ::   z2d   ! workspace
608      !!----------------------------------------------------------------------
609      !
610      IF(lwp) WRITE(numout,*)
611      IF(lwp) WRITE(numout,*) 'cfg_write : create the domain configuration file (', TRIM(cn_domcfg_out),'.nc)'
612      IF(lwp) WRITE(numout,*) '~~~~~~~~~'
613      !
614      !                       ! ============================= !
615      !                       !  create 'domcfg_out.nc' file  !
616      !                       ! ============================= !
617      !         
[9019]618      clnam = cn_domcfg_out  ! filename (configuration information)
[10425]619      CALL iom_open( TRIM(clnam), inum, ldwrt = .TRUE. )
[7646]620     
621      !
622      !                             !==  ORCA family specificities  ==!
623      IF( cn_cfg == "ORCA" ) THEN
624         CALL iom_rstput( 0, 0, inum, 'ORCA'      , 1._wp            , ktype = jp_i4 )
625         CALL iom_rstput( 0, 0, inum, 'ORCA_index', REAL( nn_cfg, wp), ktype = jp_i4 )         
[3680]626      ENDIF
[5836]627      !
[7646]628      !                             !==  global domain size  ==!
629      !
630      CALL iom_rstput( 0, 0, inum, 'jpiglo', REAL( jpiglo, wp), ktype = jp_i4 )
631      CALL iom_rstput( 0, 0, inum, 'jpjglo', REAL( jpjglo, wp), ktype = jp_i4 )
632      CALL iom_rstput( 0, 0, inum, 'jpkglo', REAL( jpk   , wp), ktype = jp_i4 )
633      !
634      !                             !==  domain characteristics  ==!
635      !
636      !                                   ! lateral boundary of the global domain
637      CALL iom_rstput( 0, 0, inum, 'jperio', REAL( jperio, wp), ktype = jp_i4 )
638      !
639      !                                   ! type of vertical coordinate
640      IF( ln_zco    ) THEN   ;   izco = 1   ;   ELSE   ;   izco = 0   ;   ENDIF
641      IF( ln_zps    ) THEN   ;   izps = 1   ;   ELSE   ;   izps = 0   ;   ENDIF
642      IF( ln_sco    ) THEN   ;   isco = 1   ;   ELSE   ;   isco = 0   ;   ENDIF
643      CALL iom_rstput( 0, 0, inum, 'ln_zco'   , REAL( izco, wp), ktype = jp_i4 )
644      CALL iom_rstput( 0, 0, inum, 'ln_zps'   , REAL( izps, wp), ktype = jp_i4 )
645      CALL iom_rstput( 0, 0, inum, 'ln_sco'   , REAL( isco, wp), ktype = jp_i4 )
646      !
647      !                                   ! ocean cavities under iceshelves
648      IF( ln_isfcav ) THEN   ;   icav = 1   ;   ELSE   ;   icav = 0   ;   ENDIF
649      CALL iom_rstput( 0, 0, inum, 'ln_isfcav', REAL( icav, wp), ktype = jp_i4 )
650      !
651      !                             !==  horizontal mesh  !
652      !
653      CALL iom_rstput( 0, 0, inum, 'glamt', glamt, ktype = jp_r8 )   ! latitude
654      CALL iom_rstput( 0, 0, inum, 'glamu', glamu, ktype = jp_r8 )
655      CALL iom_rstput( 0, 0, inum, 'glamv', glamv, ktype = jp_r8 )
656      CALL iom_rstput( 0, 0, inum, 'glamf', glamf, ktype = jp_r8 )
657      !                               
658      CALL iom_rstput( 0, 0, inum, 'gphit', gphit, ktype = jp_r8 )   ! longitude
659      CALL iom_rstput( 0, 0, inum, 'gphiu', gphiu, ktype = jp_r8 )
660      CALL iom_rstput( 0, 0, inum, 'gphiv', gphiv, ktype = jp_r8 )
661      CALL iom_rstput( 0, 0, inum, 'gphif', gphif, ktype = jp_r8 )
662      !                               
663      CALL iom_rstput( 0, 0, inum, 'e1t'  , e1t  , ktype = jp_r8 )   ! i-scale factors (e1.)
664      CALL iom_rstput( 0, 0, inum, 'e1u'  , e1u  , ktype = jp_r8 )
665      CALL iom_rstput( 0, 0, inum, 'e1v'  , e1v  , ktype = jp_r8 )
666      CALL iom_rstput( 0, 0, inum, 'e1f'  , e1f  , ktype = jp_r8 )
667      !
668      CALL iom_rstput( 0, 0, inum, 'e2t'  , e2t  , ktype = jp_r8 )   ! j-scale factors (e2.)
669      CALL iom_rstput( 0, 0, inum, 'e2u'  , e2u  , ktype = jp_r8 )
670      CALL iom_rstput( 0, 0, inum, 'e2v'  , e2v  , ktype = jp_r8 )
671      CALL iom_rstput( 0, 0, inum, 'e2f'  , e2f  , ktype = jp_r8 )
672      !
673      CALL iom_rstput( 0, 0, inum, 'ff_f' , ff_f , ktype = jp_r8 )   ! coriolis factor
674      CALL iom_rstput( 0, 0, inum, 'ff_t' , ff_t , ktype = jp_r8 )
675      !
676      !                             !==  vertical mesh  ==!
677      !                                                     
678      CALL iom_rstput( 0, 0, inum, 'e3t_1d'  , e3t_1d , ktype = jp_r8 )   ! reference 1D-coordinate
679      CALL iom_rstput( 0, 0, inum, 'e3w_1d'  , e3w_1d , ktype = jp_r8 )
680      !
681      CALL iom_rstput( 0, 0, inum, 'e3t_0'   , e3t_0  , ktype = jp_r8 )   ! vertical scale factors
682      CALL iom_rstput( 0, 0, inum, 'e3u_0'   , e3u_0  , ktype = jp_r8 )
683      CALL iom_rstput( 0, 0, inum, 'e3v_0'   , e3v_0  , ktype = jp_r8 )
684      CALL iom_rstput( 0, 0, inum, 'e3f_0'   , e3f_0  , ktype = jp_r8 )
685      CALL iom_rstput( 0, 0, inum, 'e3w_0'   , e3w_0  , ktype = jp_r8 )
686      CALL iom_rstput( 0, 0, inum, 'e3uw_0'  , e3uw_0 , ktype = jp_r8 )
687      CALL iom_rstput( 0, 0, inum, 'e3vw_0'  , e3vw_0 , ktype = jp_r8 )
688      !                                         
689      !                             !==  wet top and bottom level  ==!   (caution: multiplied by ssmask)
690      !
691      CALL iom_rstput( 0, 0, inum, 'top_level'    , REAL( mikt, wp )*ssmask , ktype = jp_i4 )   ! nb of ocean T-points (ISF)
692      CALL iom_rstput( 0, 0, inum, 'bottom_level' , REAL( mbkt, wp )*ssmask , ktype = jp_i4 )   ! nb of ocean T-points
693      !
694      IF( ln_sco ) THEN             ! s-coordinate: store grid stiffness ratio  (Not required anyway)
695         CALL dom_stiff( z2d )
696         CALL iom_rstput( 0, 0, inum, 'stiffness', z2d )        !    ! Max. grid stiffness ratio
697      ENDIF
698      !
[9023]699      IF( ll_wd ) THEN              ! wetting and drying domain
[7646]700         CALL iom_rstput( 0, 0, inum, 'ht_0'   , ht_0   , ktype = jp_r8 )
701      ENDIF
702      !
703      ! Add some global attributes ( netcdf only )
[10425]704      CALL iom_putatt( inum, 'nn_cfg', nn_cfg )
705      CALL iom_putatt( inum, 'cn_cfg', TRIM(cn_cfg) )
[7646]706      !
707      !                                ! ============================
708      !                                !        close the files
709      !                                ! ============================
710      CALL iom_close( inum )
711      !
712   END SUBROUTINE cfg_write
[3680]713
[3]714   !!======================================================================
715END MODULE domain
Note: See TracBrowser for help on using the repository browser.