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/2020/dev_r12558_HPC-08_epico_Extra_Halo/src/OCE/DOM – NEMO

Context Navigation

source: NEMO/branches/2020/dev_r12558_HPC-08_epico_Extra_Halo/src/OCE/DOM/domain.F90 @ 12978

Last change on this file since 12978 was 12960, checked in by smasson, 4 years ago
Extra_Halo: additional bugfixes and developments, see #2366
Property svn:keywords set to `Id`
File size: 36.6 KB

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

Note: See TracBrowser for help on using the repository browser.

Download in other formats: