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.

ice.F90 in branches/2017/dev_r8183_ICEMODEL/NEMOGCM/NEMO/LIM_SRC_3 – NEMO

Context Navigation

source: branches/2017/dev_r8183_ICEMODEL/NEMOGCM/NEMO/LIM_SRC_3/ice.F90 @ 8626

Last change on this file since 8626 was 8597, checked in by clem, 7 years ago
first step to make melt ponds compliant with the new code
Property svn:keywords set to `Id`
File size: 36.2 KB

Rev	Line
[825]	1	MODULE ice
[2528]	2	!!======================================================================
[8534]	3	!! * MODULE ice *
	4	!! sea-ice: ice variables defined in memory
	5	!!======================================================================
[2715]	6	!! History : 3.0 ! 2008-03 (M. Vancoppenolle) original code LIM-3
	7	!! 4.0 ! 2011-02 (G. Madec) dynamical allocation
[2528]	8	!!----------------------------------------------------------------------
[825]	9	#if defined key_lim3
	10	!!----------------------------------------------------------------------
[8534]	11	!! 'key_lim3' ESIM sea-ice model
[825]	12	!!----------------------------------------------------------------------
[3625]	13	USE in_out_manager ! I/O manager
	14	USE lib_mpp ! MPP library
[825]	15
	16	IMPLICIT NONE
	17	PRIVATE
[2528]	18
[8486]	19	PUBLIC ice_alloc ! called by icestp.F90
[2715]	20
[834]	21	!!======================================================================
	22	!! LIM3 by the use of sweat, agile fingers and sometimes brain juice,
	23	!! was developed in Louvain-la-Neuve by :
	24	!! * Martin Vancoppenolle (UCL-ASTR, Belgium)
	25	!! * Sylvain Bouillon (UCL-ASTR, Belgium)
[2715]	26	!! * Miguel Angel Morales Maqueda (NOC-L, UK)
[834]	27	!!
	28	!! Based on extremely valuable earlier work by
	29	!! * Thierry Fichefet
	30	!! * Hugues Goosse
	31	!!
	32	!! The following persons also contributed to the code in various ways
[2715]	33	!! * Gurvan Madec, Claude Talandier, Christian Ethe (LOCEAN, France)
[834]	34	!! * Xavier Fettweis (UCL-ASTR), Ralph Timmermann (AWI, Germany)
	35	!! * Bill Lipscomb (LANL), Cecilia Bitz (UWa)
	36	!! and Elisabeth Hunke (LANL), USA.
	37	!!
[2715]	38	!! For more info, the interested user is kindly invited to consult the following references
[834]	39	!! For model description and validation :
	40	!! * Vancoppenolle et al., Ocean Modelling, 2008a.
	41	!! * Vancoppenolle et al., Ocean Modelling, 2008b.
	42	!! For a specific description of EVP :
[2715]	43	!! * Bouillon et al., Ocean Modelling 2009.
[834]	44	!!
[2715]	45	!! Or the reference manual, that should be available by 2011
[834]	46	!!======================================================================
	47	!! \|
[2528]	48	!! I C E S T A T E V A R I A B L E S \|
[834]	49	!! \|
	50	!! Introduction : \|
	51	!! -------------- \|
	52	!! Every ice-covered grid cell is characterized by a series of state \|
	53	!! variables. To account for unresolved spatial variability in ice \|
	54	!! thickness, the ice cover in divided in ice thickness categories. \|
	55	!! \|
	56	!! Sea ice state variables depend on the ice thickness category \|
	57	!! \|
	58	!! Those variables are divided into two groups \|
	59	!! * Extensive (or global) variables. \|
	60	!! These are the variables that are transported by all means \|
	61	!! * Intensive (or equivalent) variables. \|
	62	!! These are the variables that are either physically more \|
	63	!! meaningful and/or used in ice thermodynamics \|
	64	!! \|
[8424]	65	!! Routines in icevar.F90 perform conversions \|
	66	!! - ice_var_glo2eqv : from global to equivalent variables \|
	67	!! - ice_var_eqv2glo : from equivalent to global variables \|
[834]	68	!! \|
	69	!! For various purposes, the sea ice state variables have sometimes \|
	70	!! to be aggregated over all ice thickness categories. This operation \|
	71	!! is done in : \|
[8424]	72	!! - ice_var_agg \|
[834]	73	!! \|
	74	!! in icestp.F90, the routines that compute the changes in the ice \|
	75	!! state variables are called \|
[8407]	76	!! - ice_rhg : ice dynamics \|
[8409]	77	!! - ice_adv : ice advection \|
	78	!! - ice_rdgrft : ice ridging and rafting \|
[8422]	79	!! - ice_thd : ice halo-thermodynamics and creation of new ice \|
	80	!! - ice_itd : thermodynamic changes in ice thickness distribution \|
[834]	81	!! \|
	82	!! See the associated routines for more information \|
	83	!! \|
	84	!! List of ice state variables : \|
	85	!! ----------------------------- \|
	86	!! \|
	87	!!-------------\|-------------\|---------------------------------\|-------\|
	88	!! name in \| name in \| meaning \| units \|
	89	!! 2D routines \| 1D routines \| \| \|
	90	!!-------------\|-------------\|---------------------------------\|-------\|
	91	!! \|
	92	!! ******************************************************************* \|
	93	!! * Dynamical variables (prognostic) * \|
	94	!! ******************************************************************* \|
	95	!! \|
	96	!! u_ice \| - \| Comp. U of the ice velocity \| m/s \|
	97	!! v_ice \| - \| Comp. V of the ice velocity \| m/s \|
	98	!! \|
	99	!! ******************************************************************* \|
	100	!! * Category dependent state variables (prognostic) * \|
	101	!! ******************************************************************* \|
	102	!! \|
	103	!! ** Global variables \|
	104	!!-------------\|-------------\|---------------------------------\|-------\|
[4872]	105	!! a_i \| a_i_1d \| Ice concentration \| \|
[834]	106	!! v_i \| - \| Ice volume per unit area \| m \|
	107	!! v_s \| - \| Snow volume per unit area \| m \|
[8569]	108	!! sv_i \| - \| Sea ice salt content \| ppt.m \|
[8239]	109	!! oa_i ! - ! Sea ice areal age content \| s \|
[5123]	110	!! e_i ! - ! Ice enthalpy \| J/m2 \|
[8325]	111	!! - ! e_i_1d ! Ice enthalpy per unit vol. \| J/m3 \|
[5123]	112	!! e_s ! - ! Snow enthalpy \| J/m2 \|
[8325]	113	!! - ! e_s_1d ! Snow enthalpy per unit vol. \| J/m3 \|
[834]	114	!! \|
	115	!!-------------\|-------------\|---------------------------------\|-------\|
	116	!! \|
	117	!! ** Equivalent variables \|
	118	!!-------------\|-------------\|---------------------------------\|-------\|
	119	!! \|
[8564]	120	!! h_i \| h_i_1d \| Ice thickness \| m \|
	121	!! h_s ! h_s_1d \| Snow depth \| m \|
	122	!! s_i ! s_i_1d \| Sea ice bulk salinity ! ppt \|
	123	!! sz_i ! sz_i_1d \| Sea ice salinity profile ! ppt \|
[8239]	124	!! o_i ! - \| Sea ice Age ! s \|
[4872]	125	!! t_i ! t_i_1d \| Sea ice temperature ! K \|
	126	!! t_s ! t_s_1d \| Snow temperature ! K \|
	127	!! t_su ! t_su_1d \| Sea ice surface temperature ! K \|
[834]	128	!! \|
	129	!! notes: the ice model only sees a bulk (i.e., vertically averaged) \|
	130	!! salinity, except in thermodynamic computations, for which \|
	131	!! the salinity profile is computed as a function of bulk \|
	132	!! salinity \|
	133	!! \|
	134	!! the sea ice surface temperature is not associated to any \|
	135	!! heat content. Therefore, it is not a state variable and \|
	136	!! does not have to be advected. Nevertheless, it has to be \|
	137	!! computed to determine whether the ice is melting or not \|
	138	!! \|
	139	!! ******************************************************************* \|
	140	!! * Category-summed state variables (diagnostic) * \|
	141	!! ******************************************************************* \|
[4872]	142	!! at_i \| at_i_1d \| Total ice concentration \| \|
[834]	143	!! vt_i \| - \| Total ice vol. per unit area \| m \|
	144	!! vt_s \| - \| Total snow vol. per unit ar. \| m \|
[8564]	145	!! sm_i \| - \| Mean sea ice salinity \| ppt \|
[834]	146	!! tm_i \| - \| Mean sea ice temperature \| K \|
[5123]	147	!! et_i ! - ! Total ice enthalpy \| J/m2 \|
	148	!! et_s ! - ! Total snow enthalpy \| J/m2 \|
[7646]	149	!! bv_i ! - ! relative brine volume \| ??? \|
[834]	150	!!=====================================================================
[825]	151
[8534]	152	!!----------------------------------------------------------------------
[825]	153	!! * Share Module variables
[8534]	154	!!----------------------------------------------------------------------
[8531]	155	! !! ice-generic parameters namelist (nampar)
[7646]	156	INTEGER , PUBLIC :: jpl !: number of ice categories
	157	INTEGER , PUBLIC :: nlay_i !: number of ice layers
	158	INTEGER , PUBLIC :: nlay_s !: number of snow layers
[8531]	159	INTEGER , PUBLIC :: nn_monocat !: virtual ITD mono-category parameterizations (1-4) or not (0)
[8517]	160	LOGICAL , PUBLIC :: ln_icedyn !: flag for ice dynamics (T) or not (F)
	161	LOGICAL , PUBLIC :: ln_icethd !: flag for ice thermo (T) or not (F)
[7646]	162	REAL(wp) , PUBLIC :: rn_amax_n !: maximum ice concentration Northern hemisphere
	163	REAL(wp) , PUBLIC :: rn_amax_s !: maximum ice concentration Southern hemisphere
	164	CHARACTER(len=32) , PUBLIC :: cn_icerst_in !: suffix of ice restart name (input)
	165	CHARACTER(len=32) , PUBLIC :: cn_icerst_out !: suffix of ice restart name (output)
	166	CHARACTER(len=256), PUBLIC :: cn_icerst_indir !: ice restart input directory
	167	CHARACTER(len=256), PUBLIC :: cn_icerst_outdir!: ice restart output directory
[8516]	168
[8531]	169	! !! ice-itd namelist (namitd)
[8516]	170	REAL(wp), PUBLIC :: rn_himin !: minimum ice thickness
[7646]	171
[8531]	172	! !! ice-dynamics namelist (namdyn)
[8516]	173	REAL(wp), PUBLIC :: rn_ishlat !: lateral boundary condition for sea-ice
	174	LOGICAL , PUBLIC :: ln_landfast !: landfast ice parameterization (T or F)
[8517]	175	REAL(wp), PUBLIC :: rn_gamma !: fraction of ocean depth that ice must reach to initiate landfast ice
	176	REAL(wp), PUBLIC :: rn_icebfr !: maximum bottom stress per unit area of contact (landfast ice)
	177	REAL(wp), PUBLIC :: rn_lfrelax !: relaxation time scale (s-1) to reach static friction (landfast ice)
[8516]	178	!
[8531]	179	! !! ice-rheology namelist (namrhg)
[5123]	180	REAL(wp), PUBLIC :: rn_creepl !: creep limit : has to be under 1.0e-9
	181	REAL(wp), PUBLIC :: rn_ecc !: eccentricity of the elliptical yield curve
[7646]	182	INTEGER , PUBLIC :: nn_nevp !: number of iterations for subcycling
[5123]	183	REAL(wp), PUBLIC :: rn_relast !: ratio => telast/rdt_ice (1/3 or 1/9 depending on nb of subcycling nevp)
[8516]	184	!
[8562]	185	! !! ice-surface forcing namelist (namforcing)
[8422]	186	! -- icethd_dh -- !
[8514]	187	REAL(wp), PUBLIC :: rn_blow_s !: coef. for partitioning of snowfall between leads and sea ice
[8516]	188	! -- icethd -- !
[8562]	189	REAL(wp), PUBLIC :: rn_cio !: drag coefficient for oceanic stress
[8514]	190	INTEGER , PUBLIC :: nn_iceflx !: Redistribute heat flux over ice categories
	191	! ! =-1 Do nothing (needs N(cat) fluxes)
	192	! ! = 0 Average N(cat) fluxes then apply the average over the N(cat) ice
	193	! ! = 1 Average N(cat) fluxes then redistribute over the N(cat) ice
	194	! ! using T-ice and albedo sensitivity
[8512]	195	! ! = 2 Redistribute a single flux over categories
[7646]	196
[8531]	197	! !! ice-salinity namelist (namthd_sal)
[7646]	198	INTEGER , PUBLIC :: nn_icesal !: salinity configuration used in the model
	199	! ! 1 - constant salinity in both space and time
	200	! ! 2 - prognostic salinity (s(z,t))
	201	! ! 3 - salinity profile, constant in time
	202	REAL(wp), PUBLIC :: rn_icesal !: bulk salinity (ppt) in case of constant salinity
	203	REAL(wp), PUBLIC :: rn_simax !: maximum ice salinity [PSU]
	204	REAL(wp), PUBLIC :: rn_simin !: minimum ice salinity [PSU]
[825]	205
[8597]	206	! !!** namelist namthd_pnd
	207	LOGICAL , PUBLIC :: ln_pnd_H12 !: Melt ponds scheme from Holland et al 2012
	208	LOGICAL , PUBLIC :: ln_pnd_fwb !: melt ponds store freshwater
	209	LOGICAL , PUBLIC :: ln_pnd_CST !: Melt ponds scheme with constant fraction and depth
	210	REAL(wp), PUBLIC :: rn_apnd !: prescribed pond fraction (0<rn_apnd<1)
	211	REAL(wp), PUBLIC :: rn_hpnd !: prescribed pond depth (0<rn_hpnd<1)
	212	LOGICAL , PUBLIC :: ln_pnd_alb !: melt ponds affect albedo
	213
[8531]	214	! !! ice-diagnostics namelist (namdia)
[8516]	215	LOGICAL , PUBLIC :: ln_icediachk !: flag for ice diag (T) or not (F)
	216	LOGICAL , PUBLIC :: ln_icediahsb !: flag for ice diag (T) or not (F)
	217	LOGICAL , PUBLIC :: ln_icectl !: flag for sea-ice points output (T) or not (F)
	218	INTEGER , PUBLIC :: iiceprt !: debug i-point
	219	INTEGER , PUBLIC :: jiceprt !: debug j-point
[8233]	220
[7646]	221	! !!** some other parameters
[8319]	222	INTEGER , PUBLIC :: kt_ice !: iteration number
[7646]	223	REAL(wp), PUBLIC :: rdt_ice !: ice time step
	224	REAL(wp), PUBLIC :: r1_rdtice !: = 1. / rdt_ice
[5123]	225	REAL(wp), PUBLIC :: r1_nlay_i !: 1 / nlay_i
	226	REAL(wp), PUBLIC :: r1_nlay_s !: 1 / nlay_s
[7646]	227	REAL(wp), PUBLIC :: rswitch !: switch for the presence of ice (1) or not (0)
[8517]	228	REAL(wp), PUBLIC :: rdiag_v, rdiag_s, rdiag_t, rdiag_fv, rdiag_fs, rdiag_ft !: conservation diagnostics
[8486]	229	REAL(wp), PUBLIC, PARAMETER :: epsi06 = 1.e-06_wp !: small number
	230	REAL(wp), PUBLIC, PARAMETER :: epsi10 = 1.e-10_wp !: small number
	231	REAL(wp), PUBLIC, PARAMETER :: epsi20 = 1.e-20_wp !: small number
[4990]	232
[8517]	233
[7646]	234	! !!** define arrays
[8486]	235	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_oce,v_oce !: surface ocean velocity used in ice dynamics
[8562]	236	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: ht_i_new !: ice collection thickness accreted in leads
[7646]	237	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: strength !: ice strength
[2715]	238	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: stress1_i, stress2_i, stress12_i !: 1st, 2nd & diagonal stress tensor element
[7646]	239	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: delta_i !: ice rheology elta factor (Flato & Hibler 95) [s-1]
	240	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: divu_i !: Divergence of the velocity field [s-1]
	241	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: shear_i !: Shear of the velocity field [s-1]
[2715]	242	!
	243	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: t_bo !: Sea-Ice bottom temperature [Kelvin]
[4688]	244	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: qlead !: heat balance of the lead (or of the open ocean)
	245	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: fhtur !: net downward heat flux from the ice to the ocean
	246	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: fhld !: heat flux from the lead used for bottom melting
	247
[7646]	248	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw !: snow-ocean mass exchange [kg.m-2.s-1]
[8341]	249	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sni !: snow ice growth component of wfx_snw [kg.m-2.s-1]
[8233]	250	! MV MP 2016
	251	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sum !: surface melt component of wfx_snw [kg.m-2.s-1]
	252	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_pnd !: melt pond-ocean mass exchange [kg.m-2.s-1]
	253	! END MV MP 2016
[7646]	254	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_spr !: snow precipitation on ice [kg.m-2.s-1]
[8239]	255	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sub !: sublimation of snow/ice [kg.m-2.s-1]
	256	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sub !: snow sublimation [kg.m-2.s-1]
	257	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_ice_sub !: ice sublimation [kg.m-2.s-1]
[4688]	258
[8239]	259	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_dyn !: dynamical component of wfx_snw [kg.m-2.s-1]
	260
[7646]	261	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_ice !: ice-ocean mass exchange [kg.m-2.s-1]
	262	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sni !: snow ice growth component of wfx_ice [kg.m-2.s-1]
	263	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_opw !: lateral ice growth component of wfx_ice [kg.m-2.s-1]
	264	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_bog !: bottom ice growth component of wfx_ice [kg.m-2.s-1]
	265	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_dyn !: dynamical ice growth component of wfx_ice [kg.m-2.s-1]
	266	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_bom !: bottom melt component of wfx_ice [kg.m-2.s-1]
	267	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sum !: surface melt component of wfx_ice [kg.m-2.s-1]
	268	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_lam !: lateral melt component of wfx_ice [kg.m-2.s-1]
	269	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_res !: residual component of wfx_ice [kg.m-2.s-1]
[4688]	270
[6416]	271	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: afx_tot !: ice concentration tendency (total) [s-1]
[5123]	272
[4688]	273	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bog !: salt flux due to ice growth/melt [PSU/m2/s]
	274	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bom !: salt flux due to ice growth/melt [PSU/m2/s]
[7646]	275	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_lam !: salt flux due to ice growth/melt [PSU/m2/s]
[4688]	276	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sum !: salt flux due to ice growth/melt [PSU/m2/s]
	277	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sni !: salt flux due to ice growth/melt [PSU/m2/s]
	278	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_opw !: salt flux due to ice growth/melt [PSU/m2/s]
[3625]	279	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bri !: salt flux due to brine rejection [PSU/m2/s]
[4688]	280	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_dyn !: salt flux due to porous ridged ice formation [PSU/m2/s]
[3625]	281	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_res !: residual salt flux due to correction of ice thickness [PSU/m2/s]
[825]	282
[6416]	283	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sub !: salt flux due to ice sublimation
[4688]	284
[6416]	285	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_bog !: total heat flux causing bottom ice growth [W.m-2]
	286	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_bom !: total heat flux causing bottom ice melt [W.m-2]
	287	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_sum !: total heat flux causing surface ice melt [W.m-2]
	288	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_opw !: total heat flux causing open water ice formation [W.m-2]
	289	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_dif !: total heat flux causing Temp change in the ice [W.m-2]
	290	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_snw !: heat flux for snow melt [W.m-2]
	291	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_err_dif !: heat flux remaining due to change in non-solar flux [W.m-2]
	292	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_err_rem !: heat flux error after heat remapping [W.m-2]
	293	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_in !: heat flux available for thermo transformations [W.m-2]
	294	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_out !: heat flux remaining at the end of thermo transformations [W.m-2]
	295	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_err_sub !: mass flux error after sublimation [kg.m-2.s-1]
	296
[4688]	297	! heat flux associated with ice-atmosphere mass exchange
[6416]	298	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_sub !: heat flux for sublimation [W.m-2]
	299	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_spr !: heat flux of the snow precipitation [W.m-2]
[4688]	300
	301	! heat flux associated with ice-ocean mass exchange
[8422]	302	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_thd !: ice-ocean heat flux from thermo processes (icethd_dh) [W.m-2]
[8409]	303	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_dyn !: ice-ocean heat flux from ridging [W.m-2]
[6416]	304	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_res !: residual heat flux due to correction of ice thickness [W.m-2]
[4688]	305
[7646]	306	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: rn_amax_2d !: maximum ice concentration 2d array
	307	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: ftr_ice !: transmitted solar radiation under ice
[4688]	308
[8534]	309	!!----------------------------------------------------------------------
[834]	310	!! * Ice global state variables
[8534]	311	!!----------------------------------------------------------------------
[834]	312	!! Variables defined for each ice category
[8564]	313	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_i !: Ice thickness (m)
[7646]	314	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_i !: Ice fractional areas (concentration)
	315	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_i !: Ice volume per unit area (m)
	316	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_s !: Snow volume per unit area(m)
[8564]	317	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_s !: Snow thickness (m)
[7646]	318	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: t_su !: Sea-Ice Surface Temperature (K)
[8564]	319	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: s_i !: Sea-Ice Bulk salinity (ppt)
	320	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: sv_i !: Sea-Ice Bulk salinity times volume per area (ppt.m)
[8239]	321	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: o_i !: Sea-Ice Age (s)
	322	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: oa_i !: Sea-Ice Age times ice area (s)
[7646]	323	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: bv_i !: brine volume
[825]	324
[2715]	325	!! Variables summed over all categories, or associated to all the ice in a single grid cell
[7646]	326	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_ice, v_ice !: components of the ice velocity (m/s)
	327	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: vt_i , vt_s !: ice and snow total volume per unit area (m)
	328	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_i !: ice total fractional area (ice concentration)
	329	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: ato_i !: =1-at_i ; total open water fractional area
	330	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: et_i , et_s !: ice and snow total heat content
	331	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_i !: mean ice temperature over all categories
	332	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: bvm_i !: brine volume averaged over all categories
[8564]	333	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sm_i !: mean sea ice salinity averaged over all categories [PSU]
[7646]	334	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_su !: mean surface temperature over all categories
[8564]	335	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hm_i !: mean ice thickness over all categories
	336	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hm_s !: mean snow thickness over all categories
[7646]	337	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: om_i !: mean ice age over all categories
	338	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tau_icebfr !: ice friction with bathy (landfast param activated)
[825]	339
[8564]	340	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: t_s !: Snow temperatures [K]
	341	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_s !: Snow enthalpy [J/m2]
	342	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: t_i !: ice temperatures [K]
	343	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_i !: ice enthalpy [J/m2]
	344	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: sz_i !: ice salinity [PSU]
[825]	345
[8233]	346	! MV MP 2016
	347	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_ip !: melt pond fraction per grid cell area
	348	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_ip !: melt pond volume per grid cell area [m]
	349	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_ip_frac !: melt pond volume per ice area
	350	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_ip !: melt pond thickness [m]
	351
	352	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_ip !: total melt pond fraction
	353	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: vt_ip !: total melt pond volume per unit area [m]
	354	! END MV MP 2016
	355
[8534]	356	!!----------------------------------------------------------------------
[834]	357	!! * Old values of global variables
[8534]	358	!!----------------------------------------------------------------------
[8563]	359	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_s_b, v_i_b, h_s_b, h_i_b !: snow and ice volumes/thickness
[8564]	360	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_i_b, sv_i_b, oa_i_b !:
[8360]	361	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_s_b !: snow heat content
	362	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_i_b !: ice temperatures
	363	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_ice_b, v_ice_b !: ice velocity
	364	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_i_b !: ice concentration (total)
[5123]	365
[8534]	366	!!----------------------------------------------------------------------
[834]	367	!! * Ice thickness distribution variables
[8534]	368	!!----------------------------------------------------------------------
[2715]	369	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:) :: hi_max !: Boundary of ice thickness categories in thickness space
	370	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:) :: hi_mean !: Mean ice thickness in catgories
[4147]	371	!
[8534]	372	!!----------------------------------------------------------------------
[834]	373	!! * Ice diagnostics
[8534]	374	!!----------------------------------------------------------------------
[5123]	375	! thd refers to changes induced by thermodynamics
	376	! trp '' '' '' advection (transport of ice)
[7646]	377	!
[5123]	378	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_vi !: transport of ice volume
	379	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_vs !: transport of snw volume
	380	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_ei !: transport of ice enthalpy (W/m2)
	381	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_es !: transport of snw enthalpy (W/m2)
[8564]	382	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_sv !: transport of salt content
[4688]	383	!
[5167]	384	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_heat !: snw/ice heat content variation [W/m2]
[8564]	385	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_sice !: ice salt content variation []
[5167]	386	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_vice !: ice volume variation [m/s]
	387	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_vsnw !: snw volume variation [m/s]
[8239]	388
[4688]	389	!
[8534]	390	!!----------------------------------------------------------------------
[8239]	391	!! * SIMIP extra diagnostics
[8534]	392	!!----------------------------------------------------------------------
[8239]	393	! Extra sea ice diagnostics to address the data request
	394	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: t_si !: Temperature at Snow-ice interface (K)
	395	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_si !: mean temperature at the snow-ice interface (K)
	396	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_fc_bo !: Bottom conduction flux (W/m2)
	397	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_fc_su !: Surface conduction flux (W/m2)
	398
	399	!
[2715]	400	!!----------------------------------------------------------------------
[8486]	401	!! NEMO/ICE 4.0 , NEMO Consortium (2017)
[2715]	402	!! $Id$
	403	!! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt)
	404	!!----------------------------------------------------------------------
	405	CONTAINS
	406
	407	FUNCTION ice_alloc()
	408	!!-----------------------------------------------------------------
[7813]	409	!! * Routine ice_alloc *
[2715]	410	!!-----------------------------------------------------------------
	411	INTEGER :: ice_alloc
	412	!
[8239]	413	INTEGER :: ierr(18), ii
[2715]	414	!!-----------------------------------------------------------------
	415
	416	ierr(:) = 0
	417
	418	! What could be one huge allocate statement is broken-up to try to
	419	! stay within Fortran's max-line length limit.
	420	ii = 1
[8562]	421	ALLOCATE( u_oce (jpi,jpj) , v_oce (jpi,jpj) , ht_i_new (jpi,jpj) , &
[7646]	422	& strength(jpi,jpj) , stress1_i(jpi,jpj) , stress2_i(jpi,jpj) , stress12_i(jpi,jpj) , &
	423	& delta_i (jpi,jpj) , divu_i (jpi,jpj) , shear_i (jpi,jpj) , STAT=ierr(ii) )
[2715]	424
	425	ii = ii + 1
[8341]	426	ALLOCATE( t_bo (jpi,jpj) , wfx_snw_sni(jpi,jpj) , &
[8239]	427	& wfx_snw(jpi,jpj) , wfx_snw_dyn(jpi,jpj) , wfx_snw_sum(jpi,jpj) , wfx_snw_sub(jpi,jpj) , &
	428	& wfx_ice(jpi,jpj) , wfx_sub (jpi,jpj) , wfx_ice_sub(jpi,jpj) , wfx_lam (jpi,jpj) , &
[8240]	429	& wfx_pnd(jpi,jpj) , &
[4688]	430	& wfx_bog(jpi,jpj) , wfx_dyn(jpi,jpj) , wfx_bom(jpi,jpj) , wfx_sum(jpi,jpj) , &
[5123]	431	& wfx_res(jpi,jpj) , wfx_sni(jpi,jpj) , wfx_opw(jpi,jpj) , wfx_spr(jpi,jpj) , &
[8498]	432	& afx_tot(jpi,jpj) , rn_amax_2d(jpi,jpj), &
[7646]	433	& fhtur (jpi,jpj) , qlead (jpi,jpj) , &
	434	& sfx_res(jpi,jpj) , sfx_bri(jpi,jpj) , sfx_dyn(jpi,jpj) , sfx_sub(jpi,jpj) , sfx_lam(jpi,jpj) , &
	435	& sfx_bog(jpi,jpj) , sfx_bom(jpi,jpj) , sfx_sum(jpi,jpj) , sfx_sni(jpi,jpj) , sfx_opw(jpi,jpj) , &
[8518]	436	& hfx_res(jpi,jpj) , hfx_snw(jpi,jpj) , hfx_sub(jpi,jpj) , &
[7646]	437	& hfx_in (jpi,jpj) , hfx_out(jpi,jpj) , fhld (jpi,jpj) , &
	438	& hfx_sum(jpi,jpj) , hfx_bom(jpi,jpj) , hfx_bog(jpi,jpj) , hfx_dif(jpi,jpj) , &
	439	& hfx_opw(jpi,jpj) , hfx_thd(jpi,jpj) , hfx_dyn(jpi,jpj) , hfx_spr(jpi,jpj) , &
	440	& hfx_err_dif(jpi,jpj) , hfx_err_rem(jpi,jpj) , wfx_err_sub(jpi,jpj) , STAT=ierr(ii) )
[2715]	441
	442	! * Ice global state variables
	443	ii = ii + 1
[8312]	444	ALLOCATE( ftr_ice(jpi,jpj,jpl) , &
[8563]	445	& h_i (jpi,jpj,jpl) , a_i (jpi,jpj,jpl) , v_i (jpi,jpj,jpl) , &
	446	& v_s (jpi,jpj,jpl) , h_s (jpi,jpj,jpl) , t_su (jpi,jpj,jpl) , &
[8564]	447	& s_i (jpi,jpj,jpl) , sv_i (jpi,jpj,jpl) , o_i (jpi,jpj,jpl) , &
[7646]	448	& oa_i (jpi,jpj,jpl) , bv_i (jpi,jpj,jpl) , STAT=ierr(ii) )
[2715]	449	ii = ii + 1
[7646]	450	ALLOCATE( u_ice(jpi,jpj) , v_ice(jpi,jpj) , &
[2715]	451	& vt_i (jpi,jpj) , vt_s (jpi,jpj) , at_i (jpi,jpj) , ato_i(jpi,jpj) , &
[7646]	452	& et_i (jpi,jpj) , et_s (jpi,jpj) , tm_i (jpi,jpj) , bvm_i(jpi,jpj) , &
[8564]	453	& sm_i (jpi,jpj) , tm_su(jpi,jpj) , hm_i(jpi,jpj) , hm_s(jpi,jpj) , &
[7646]	454	& om_i (jpi,jpj) , tau_icebfr(jpi,jpj) , STAT=ierr(ii) )
[2715]	455	ii = ii + 1
[5123]	456	ALLOCATE( t_s(jpi,jpj,nlay_s,jpl) , e_s(jpi,jpj,nlay_s,jpl) , STAT=ierr(ii) )
[2715]	457	ii = ii + 1
[8564]	458	ALLOCATE( t_i(jpi,jpj,nlay_i,jpl) , e_i(jpi,jpj,nlay_i,jpl) , sz_i(jpi,jpj,nlay_i,jpl) , STAT=ierr(ii) )
[2715]	459
[8233]	460	ii = ii + 1
	461	ALLOCATE( a_ip(jpi,jpj,jpl) , v_ip(jpi,jpj,jpl) , a_ip_frac(jpi,jpj,jpl) , &
	462	& h_ip(jpi,jpj,jpl) , STAT = ierr(ii) )
	463	ii = ii + 1
	464	ALLOCATE( at_ip(jpi,jpj) , vt_ip(jpi,jpj) , STAT = ierr(ii) )
	465
[2715]	466	! * Old values of global variables
	467	ii = ii + 1
[8563]	468	ALLOCATE( v_s_b (jpi,jpj,jpl) , v_i_b (jpi,jpj,jpl) , h_s_b(jpi,jpj,jpl) , h_i_b(jpi,jpj,jpl) , &
[8564]	469	& a_i_b (jpi,jpj,jpl) , sv_i_b(jpi,jpj,jpl) , e_i_b (jpi,jpj,nlay_i,jpl) , e_s_b (jpi,jpj,nlay_s,jpl) , &
[8360]	470	& oa_i_b (jpi,jpj,jpl) , STAT=ierr(ii) )
[7646]	471	ii = ii + 1
	472	ALLOCATE( u_ice_b(jpi,jpj) , v_ice_b(jpi,jpj) , at_i_b(jpi,jpj) , STAT=ierr(ii) )
[2715]	473
	474	! * Ice thickness distribution variables
	475	ii = ii + 1
[4869]	476	ALLOCATE( hi_max(0:jpl), hi_mean(jpl), STAT=ierr(ii) )
[2715]	477
	478	! * Ice diagnostics
	479	ii = ii + 1
[7646]	480	ALLOCATE( diag_trp_vi(jpi,jpj) , diag_trp_vs (jpi,jpj) , diag_trp_ei(jpi,jpj), &
[8564]	481	& diag_trp_es(jpi,jpj) , diag_trp_sv (jpi,jpj) , diag_heat (jpi,jpj), &
	482	& diag_sice (jpi,jpj) , diag_vice (jpi,jpj) , diag_vsnw (jpi,jpj), STAT=ierr(ii) )
[2715]	483
[8239]	484	! * SIMIP diagnostics
	485	ii = ii + 1
	486	ALLOCATE( t_si (jpi,jpj,jpl) , tm_si(jpi,jpj) , &
	487	diag_fc_bo(jpi,jpj) , diag_fc_su(jpi,jpj) , &
[8500]	488	STAT = ierr(ii) )
[8239]	489
[2715]	490	ice_alloc = MAXVAL( ierr(:) )
[7646]	491	IF( ice_alloc /= 0 ) CALL ctl_warn('ice_alloc: failed to allocate arrays.')
[2715]	492	!
	493	END FUNCTION ice_alloc
	494
[825]	495	#else
	496	!!----------------------------------------------------------------------
[8534]	497	!! Default option Empty module NO ESIM sea-ice model
[825]	498	!!----------------------------------------------------------------------
	499	#endif
	500
	501	!!======================================================================
	502	END MODULE ice

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

Download in other formats: