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 NEMO/branches/2018/dev_r9947_SI3_advection/src/ICE – NEMO

Context Navigation

source: NEMO/branches/2018/dev_r9947_SI3_advection/src/ICE/ice.F90 @ 10312

Last change on this file since 10312 was 10312, checked in by clem, 5 years ago
add the parameterization of landfast ice from Lemieux2015 and 2016 with the addition of isotropic tensile strength
Property svn:keywords set to `Id`
File size: 35.4 KB

Line
1	MODULE ice
2	!!======================================================================
3	!! * MODULE ice *
4	!! sea-ice: ice variables defined in memory
5	!!======================================================================
6	!! History : 3.0 ! 2008-03 (M. Vancoppenolle) Original code
7	!! 4.0 ! 2018 (many people) SI3 [aka Sea Ice cube]
8	!!----------------------------------------------------------------------
9	#if defined key_si3
10	!!----------------------------------------------------------------------
11	!! 'key_si3' SI3 sea-ice model
12	!!----------------------------------------------------------------------
13	USE in_out_manager ! I/O manager
14	USE lib_mpp ! MPP library
15
16	IMPLICIT NONE
17	PRIVATE
18
19	PUBLIC ice_alloc ! called by icestp.F90
20
21	!!======================================================================
22	!! \|
23	!! I C E S T A T E V A R I A B L E S \|
24	!! \|
25	!! Introduction : \|
26	!! -------------- \|
27	!! Every ice-covered grid cell is characterized by a series of state \|
28	!! variables. To account for unresolved spatial variability in ice \|
29	!! thickness, the ice cover in divided in ice thickness categories. \|
30	!! \|
31	!! Sea ice state variables depend on the ice thickness category \|
32	!! \|
33	!! Those variables are divided into two groups \|
34	!! * Extensive (or global) variables. \|
35	!! These are the variables that are transported by all means \|
36	!! * Intensive (or equivalent) variables. \|
37	!! These are the variables that are either physically more \|
38	!! meaningful and/or used in ice thermodynamics \|
39	!! \|
40	!! List of ice state variables : \|
41	!! ----------------------------- \|
42	!! \|
43	!!-------------\|-------------\|---------------------------------\|-------\|
44	!! name in \| name in \| meaning \| units \|
45	!! 2D routines \| 1D routines \| \| \|
46	!!-------------\|-------------\|---------------------------------\|-------\|
47	!! \|
48	!! ******************************************************************* \|
49	!! * Dynamical variables (prognostic) * \|
50	!! ******************************************************************* \|
51	!! \|
52	!! u_ice \| - \| Comp. U of the ice velocity \| m/s \|
53	!! v_ice \| - \| Comp. V of the ice velocity \| m/s \|
54	!! \|
55	!! ******************************************************************* \|
56	!! * Category dependent state variables (prognostic) * \|
57	!! ******************************************************************* \|
58	!! \|
59	!! ** Global variables \|
60	!!-------------\|-------------\|---------------------------------\|-------\|
61	!! a_i \| a_i_1d \| Ice concentration \| \|
62	!! v_i \| - \| Ice volume per unit area \| m \|
63	!! v_s \| - \| Snow volume per unit area \| m \|
64	!! sv_i \| - \| Sea ice salt content \| ppt.m \|
65	!! oa_i ! - ! Sea ice areal age content \| s \|
66	!! e_i ! - ! Ice enthalpy \| J/m2 \|
67	!! - ! e_i_1d ! Ice enthalpy per unit vol. \| J/m3 \|
68	!! e_s ! - ! Snow enthalpy \| J/m2 \|
69	!! - ! e_s_1d ! Snow enthalpy per unit vol. \| J/m3 \|
70	!! \|
71	!!-------------\|-------------\|---------------------------------\|-------\|
72	!! \|
73	!! ** Equivalent variables \|
74	!!-------------\|-------------\|---------------------------------\|-------\|
75	!! \|
76	!! h_i \| h_i_1d \| Ice thickness \| m \|
77	!! h_s ! h_s_1d \| Snow depth \| m \|
78	!! s_i ! s_i_1d \| Sea ice bulk salinity ! ppt \|
79	!! sz_i ! sz_i_1d \| Sea ice salinity profile ! ppt \|
80	!! o_i ! - \| Sea ice Age ! s \|
81	!! t_i ! t_i_1d \| Sea ice temperature ! K \|
82	!! t_s ! t_s_1d \| Snow temperature ! K \|
83	!! t_su ! t_su_1d \| Sea ice surface temperature ! K \|
84	!! \|
85	!! notes: the ice model only sees a bulk (i.e., vertically averaged) \|
86	!! salinity, except in thermodynamic computations, for which \|
87	!! the salinity profile is computed as a function of bulk \|
88	!! salinity \|
89	!! \|
90	!! the sea ice surface temperature is not associated to any \|
91	!! heat content. Therefore, it is not a state variable and \|
92	!! does not have to be advected. Nevertheless, it has to be \|
93	!! computed to determine whether the ice is melting or not \|
94	!! \|
95	!! ******************************************************************* \|
96	!! * Category-summed state variables (diagnostic) * \|
97	!! ******************************************************************* \|
98	!! at_i \| at_i_1d \| Total ice concentration \| \|
99	!! vt_i \| - \| Total ice vol. per unit area \| m \|
100	!! vt_s \| - \| Total snow vol. per unit ar. \| m \|
101	!! sm_i \| - \| Mean sea ice salinity \| ppt \|
102	!! tm_i \| - \| Mean sea ice temperature \| K \|
103	!! tm_s \| - \| Mean snow temperature \| K \|
104	!! et_i ! - ! Total ice enthalpy \| J/m2 \|
105	!! et_s ! - ! Total snow enthalpy \| J/m2 \|
106	!! bv_i ! - ! relative brine volume \| ??? \|
107	!!=====================================================================
108
109	!!----------------------------------------------------------------------
110	!! * Share Module variables
111	!!----------------------------------------------------------------------
112	! !! ice-generic parameters namelist (nampar)
113	INTEGER , PUBLIC :: jpl !: number of ice categories
114	INTEGER , PUBLIC :: nlay_i !: number of ice layers
115	INTEGER , PUBLIC :: nlay_s !: number of snow layers
116	INTEGER , PUBLIC :: nn_virtual_itd !: virtual ITD mono-category parameterizations (1-3) or not (0)
117	LOGICAL , PUBLIC :: ln_icedyn !: flag for ice dynamics (T) or not (F)
118	LOGICAL , PUBLIC :: ln_icethd !: flag for ice thermo (T) or not (F)
119	REAL(wp) , PUBLIC :: rn_amax_n !: maximum ice concentration Northern hemisphere
120	REAL(wp) , PUBLIC :: rn_amax_s !: maximum ice concentration Southern hemisphere
121	CHARACTER(len=256), PUBLIC :: cn_icerst_in !: suffix of ice restart name (input)
122	CHARACTER(len=256), PUBLIC :: cn_icerst_out !: suffix of ice restart name (output)
123	CHARACTER(len=256), PUBLIC :: cn_icerst_indir !: ice restart input directory
124	CHARACTER(len=256), PUBLIC :: cn_icerst_outdir !: ice restart output directory
125
126	! !! ice-itd namelist (namitd)
127	REAL(wp), PUBLIC :: rn_himin !: minimum ice thickness
128
129	! !! ice-dynamics namelist (namdyn)
130	REAL(wp), PUBLIC :: rn_ishlat !: lateral boundary condition for sea-ice
131	LOGICAL , PUBLIC :: ln_landfast_L16 !: landfast ice parameterizationfrom lemieux2016
132	LOGICAL , PUBLIC :: ln_landfast_home !: landfast ice parameterizationfrom home made
133	REAL(wp), PUBLIC :: rn_depfra !: fraction of ocean depth that ice must reach to initiate landfast ice
134	REAL(wp), PUBLIC :: rn_icebfr !: maximum bottom stress per unit area of contact (lemieux2016) or per unit volume (home)
135	REAL(wp), PUBLIC :: rn_lfrelax !: relaxation time scale (s-1) to reach static friction
136	REAL(wp), PUBLIC :: rn_tensile !: isotropic tensile strength
137	!
138	! !! ice-ridging/rafting namelist (namdyn_rdgrft)
139	REAL(wp), PUBLIC :: rn_crhg !: determines changes in ice strength (also used for landfast param)
140	!
141	! !! ice-rheology namelist (namdyn_rhg)
142	LOGICAL , PUBLIC :: ln_aEVP !: using adaptive EVP (T or F)
143	REAL(wp), PUBLIC :: rn_creepl !: creep limit : has to be under 1.0e-9
144	REAL(wp), PUBLIC :: rn_ecc !: eccentricity of the elliptical yield curve
145	INTEGER , PUBLIC :: nn_nevp !: number of iterations for subcycling
146	REAL(wp), PUBLIC :: rn_relast !: ratio => telast/rdt_ice (1/3 or 1/9 depending on nb of subcycling nevp)
147	!
148	! !! ice-surface forcing namelist (namforcing)
149	! -- icethd_dh -- !
150	REAL(wp), PUBLIC :: rn_blow_s !: coef. for partitioning of snowfall between leads and sea ice
151	! -- icethd -- !
152	REAL(wp), PUBLIC :: rn_cio !: drag coefficient for oceanic stress
153	INTEGER , PUBLIC :: nn_flxdist !: Redistribute heat flux over ice categories
154	! ! =-1 Do nothing (needs N(cat) fluxes)
155	! ! = 0 Average N(cat) fluxes then apply the average over the N(cat) ice
156	! ! = 1 Average N(cat) fluxes then redistribute over the N(cat) ice using T-ice and albedo sensitivity
157	! ! = 2 Redistribute a single flux over categories
158	INTEGER , PUBLIC :: nice_jules !: Choice of jules coupling
159	INTEGER , PUBLIC, PARAMETER :: np_jules_OFF = 0 !: no Jules coupling (ice thermodynamics forced via qsr and qns)
160	INTEGER , PUBLIC, PARAMETER :: np_jules_EMULE = 1 !: emulated Jules coupling via icethd_zdf.F90 (BL99) (1st round compute qcn and qsr_tr, 2nd round use it)
161	INTEGER , PUBLIC, PARAMETER :: np_jules_ACTIVE = 2 !: active Jules coupling (SM0L) (compute qcn and qsr_tr via sbcblk.F90 or sbccpl.F90)
162
163	! !! ice-vertical diffusion namelist (namthd_zdf)
164	LOGICAL , PUBLIC :: ln_cndi_U64 !: thermal conductivity: Untersteiner (1964)
165	LOGICAL , PUBLIC :: ln_cndi_P07 !: thermal conductivity: Pringle et al (2007)
166	REAL(wp), PUBLIC :: rn_kappa_i !: coef. for the extinction of radiation Grenfell et al. (2006) [1/m]
167	REAL(wp), PUBLIC :: rn_cnd_s !: thermal conductivity of the snow [W/m/K]
168
169	! !! ice-salinity namelist (namthd_sal)
170	INTEGER , PUBLIC :: nn_icesal !: salinity configuration used in the model
171	! ! 1 - constant salinity in both space and time
172	! ! 2 - prognostic salinity (s(z,t))
173	! ! 3 - salinity profile, constant in time
174	REAL(wp), PUBLIC :: rn_icesal !: bulk salinity (ppt) in case of constant salinity
175	REAL(wp), PUBLIC :: rn_simax !: maximum ice salinity [PSU]
176	REAL(wp), PUBLIC :: rn_simin !: minimum ice salinity [PSU]
177
178	! !!** ice-ponds namelist (namthd_pnd)
179	LOGICAL , PUBLIC :: ln_pnd_H12 !: Melt ponds scheme from Holland et al 2012
180	LOGICAL , PUBLIC :: ln_pnd_fwb !: melt ponds store freshwater
181	LOGICAL , PUBLIC :: ln_pnd_CST !: Melt ponds scheme with constant fraction and depth
182	REAL(wp), PUBLIC :: rn_apnd !: prescribed pond fraction (0<rn_apnd<1)
183	REAL(wp), PUBLIC :: rn_hpnd !: prescribed pond depth (0<rn_hpnd<1)
184	LOGICAL , PUBLIC :: ln_pnd_alb !: melt ponds affect albedo
185
186	! !! ice-diagnostics namelist (namdia)
187	LOGICAL , PUBLIC :: ln_icediachk !: flag for ice diag (T) or not (F)
188	LOGICAL , PUBLIC :: ln_icediahsb !: flag for ice diag (T) or not (F)
189	LOGICAL , PUBLIC :: ln_icectl !: flag for sea-ice points output (T) or not (F)
190	INTEGER , PUBLIC :: iiceprt !: debug i-point
191	INTEGER , PUBLIC :: jiceprt !: debug j-point
192
193	! !!** some other parameters
194	INTEGER , PUBLIC :: kt_ice !: iteration number
195	REAL(wp), PUBLIC :: rdt_ice !: ice time step
196	REAL(wp), PUBLIC :: r1_rdtice !: = 1. / rdt_ice
197	REAL(wp), PUBLIC :: r1_nlay_i !: 1 / nlay_i
198	REAL(wp), PUBLIC :: r1_nlay_s !: 1 / nlay_s
199	REAL(wp), PUBLIC :: rswitch !: switch for the presence of ice (1) or not (0)
200	REAL(wp), PUBLIC :: rdiag_v, rdiag_s, rdiag_t, rdiag_fv, rdiag_fs, rdiag_ft !: conservation diagnostics
201	REAL(wp), PUBLIC, PARAMETER :: epsi06 = 1.e-06_wp !: small number
202	REAL(wp), PUBLIC, PARAMETER :: epsi10 = 1.e-10_wp !: small number
203	REAL(wp), PUBLIC, PARAMETER :: epsi20 = 1.e-20_wp !: small number
204
205
206	! !!** define arrays
207	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_oce,v_oce !: surface ocean velocity used in ice dynamics
208	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: ht_i_new !: ice collection thickness accreted in leads
209	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: strength !: ice strength
210	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: stress1_i, stress2_i, stress12_i !: 1st, 2nd & diagonal stress tensor element
211	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: delta_i !: ice rheology elta factor (Flato & Hibler 95) [s-1]
212	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: divu_i !: Divergence of the velocity field [s-1]
213	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: shear_i !: Shear of the velocity field [s-1]
214	!
215	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: t_bo !: Sea-Ice bottom temperature [Kelvin]
216	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: qlead !: heat balance of the lead (or of the open ocean)
217	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: qsb_ice_bot !: net downward heat flux from the ice to the ocean
218	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: fhld !: heat flux from the lead used for bottom melting
219
220	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw !: snow-ocean mass exchange [kg.m-2.s-1]
221	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sni !: snow ice growth component of wfx_snw [kg.m-2.s-1]
222	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sum !: surface melt component of wfx_snw [kg.m-2.s-1]
223	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_pnd !: melt pond-ocean mass exchange [kg.m-2.s-1]
224	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_spr !: snow precipitation on ice [kg.m-2.s-1]
225	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sub !: sublimation of snow/ice [kg.m-2.s-1]
226	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_sub !: snow sublimation [kg.m-2.s-1]
227	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_ice_sub !: ice sublimation [kg.m-2.s-1]
228
229	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_snw_dyn !: dynamical component of wfx_snw [kg.m-2.s-1]
230
231	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_ice !: ice-ocean mass exchange [kg.m-2.s-1]
232	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sni !: snow ice growth component of wfx_ice [kg.m-2.s-1]
233	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_opw !: lateral ice growth component of wfx_ice [kg.m-2.s-1]
234	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_bog !: bottom ice growth component of wfx_ice [kg.m-2.s-1]
235	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_dyn !: dynamical ice growth component of wfx_ice [kg.m-2.s-1]
236	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_bom !: bottom melt component of wfx_ice [kg.m-2.s-1]
237	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_sum !: surface melt component of wfx_ice [kg.m-2.s-1]
238	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_lam !: lateral melt component of wfx_ice [kg.m-2.s-1]
239	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_res !: residual component of wfx_ice [kg.m-2.s-1]
240
241	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: afx_tot !: ice concentration tendency (total) [s-1]
242
243	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bog !: salt flux due to ice growth/melt [PSU/m2/s]
244	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bom !: salt flux due to ice growth/melt [PSU/m2/s]
245	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_lam !: salt flux due to ice growth/melt [PSU/m2/s]
246	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sum !: salt flux due to ice growth/melt [PSU/m2/s]
247	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sni !: salt flux due to ice growth/melt [PSU/m2/s]
248	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_opw !: salt flux due to ice growth/melt [PSU/m2/s]
249	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_bri !: salt flux due to brine rejection [PSU/m2/s]
250	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_dyn !: salt flux due to porous ridged ice formation [PSU/m2/s]
251	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_res !: residual salt flux due to correction of ice thickness [PSU/m2/s]
252
253	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sfx_sub !: salt flux due to ice sublimation
254
255	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_bog !: total heat flux causing bottom ice growth [W.m-2]
256	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_bom !: total heat flux causing bottom ice melt [W.m-2]
257	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_sum !: total heat flux causing surface ice melt [W.m-2]
258	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_opw !: total heat flux causing open water ice formation [W.m-2]
259	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_dif !: total heat flux causing Temp change in the ice [W.m-2]
260	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_snw !: heat flux for snow melt [W.m-2]
261	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_err_dif !: heat flux remaining due to change in non-solar flux [W.m-2]
262	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_err_rem !: heat flux error after heat remapping [W.m-2]
263	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: qt_atm_oi !: heat flux available for thermo transformations [W.m-2]
264	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: qt_oce_ai !: heat flux remaining at the end of thermo transformations [W.m-2]
265	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: wfx_err_sub !: mass flux error after sublimation [kg.m-2.s-1]
266
267	! heat flux associated with ice-atmosphere mass exchange
268	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_sub !: heat flux for sublimation [W.m-2]
269	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_spr !: heat flux of the snow precipitation [W.m-2]
270
271	! heat flux associated with ice-ocean mass exchange
272	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_thd !: ice-ocean heat flux from thermo processes (icethd_dh) [W.m-2]
273	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_dyn !: ice-ocean heat flux from ridging [W.m-2]
274	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hfx_res !: residual heat flux due to correction of ice thickness [W.m-2]
275
276	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: rn_amax_2d !: maximum ice concentration 2d array
277	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: qtr_ice_bot !: transmitted solar radiation under ice
278	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: t1_ice !: temperature of the first layer (Jules coupling) [K]
279	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: cnd_ice !: effective conductivity at the top of ice/snow (Jules coupling) [W.m-2.K-1]
280
281	!!----------------------------------------------------------------------
282	!! * Ice global state variables
283	!!----------------------------------------------------------------------
284	!! Variables defined for each ice category
285	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_i !: Ice thickness (m)
286	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_i !: Ice fractional areas (concentration)
287	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_i !: Ice volume per unit area (m)
288	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_s !: Snow volume per unit area(m)
289	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_s !: Snow thickness (m)
290	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: t_su !: Sea-Ice Surface Temperature (K)
291	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: s_i !: Sea-Ice Bulk salinity (ppt)
292	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: sv_i !: Sea-Ice Bulk salinity times volume per area (ppt.m)
293	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: o_i !: Sea-Ice Age (s)
294	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: oa_i !: Sea-Ice Age times ice area (s)
295	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: bv_i !: brine volume
296
297	!! Variables summed over all categories, or associated to all the ice in a single grid cell
298	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_ice, v_ice !: components of the ice velocity (m/s)
299	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: vt_i , vt_s !: ice and snow total volume per unit area (m)
300	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_i !: ice total fractional area (ice concentration)
301	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: ato_i !: =1-at_i ; total open water fractional area
302	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: et_i , et_s !: ice and snow total heat content
303	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_i !: mean ice temperature over all categories
304	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_s !: mean snw temperature over all categories
305	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: bvm_i !: brine volume averaged over all categories
306	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: sm_i !: mean sea ice salinity averaged over all categories [PSU]
307	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_su !: mean surface temperature over all categories
308	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hm_i !: mean ice thickness over all categories
309	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: hm_s !: mean snow thickness over all categories
310	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: om_i !: mean ice age over all categories
311	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tau_icebfr !: ice friction with bathy (landfast param activated)
312
313	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: t_s !: Snow temperatures [K]
314	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_s !: Snow enthalpy [J/m2]
315	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: t_i !: ice temperatures [K]
316	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_i !: ice enthalpy [J/m2]
317	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: sz_i !: ice salinity [PSU]
318
319	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_ip !: melt pond fraction per grid cell area
320	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_ip !: melt pond volume per grid cell area [m]
321	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_ip_frac !: melt pond volume per ice area
322	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: h_ip !: melt pond thickness [m]
323
324	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_ip !: total melt pond fraction
325	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: vt_ip !: total melt pond volume per unit area [m]
326
327	!!----------------------------------------------------------------------
328	!! * Old values of global variables
329	!!----------------------------------------------------------------------
330	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: v_s_b, v_i_b, h_s_b, h_i_b !: snow and ice volumes/thickness
331	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: a_i_b, sv_i_b, oa_i_b !:
332	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_s_b !: snow heat content
333	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:,:) :: e_i_b !: ice temperatures
334	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: u_ice_b, v_ice_b !: ice velocity
335	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: at_i_b !: ice concentration (total)
336
337	!!----------------------------------------------------------------------
338	!! * Ice thickness distribution variables
339	!!----------------------------------------------------------------------
340	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:) :: hi_max !: Boundary of ice thickness categories in thickness space
341	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:) :: hi_mean !: Mean ice thickness in catgories
342	!
343	!!----------------------------------------------------------------------
344	!! * Ice diagnostics
345	!!----------------------------------------------------------------------
346	! thd refers to changes induced by thermodynamics
347	! trp '' '' '' advection (transport of ice)
348	!
349	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_vi !: transport of ice volume
350	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_vs !: transport of snw volume
351	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_ei !: transport of ice enthalpy (W/m2)
352	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_es !: transport of snw enthalpy (W/m2)
353	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_trp_sv !: transport of salt content
354	!
355	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_heat !: snw/ice heat content variation [W/m2]
356	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_sice !: ice salt content variation []
357	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_vice !: ice volume variation [m/s]
358	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: diag_vsnw !: snw volume variation [m/s]
359
360	!
361	!!----------------------------------------------------------------------
362	!! * SIMIP extra diagnostics
363	!!----------------------------------------------------------------------
364	! Extra sea ice diagnostics to address the data request
365	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: t_si !: Temperature at Snow-ice interface (K)
366	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:) :: tm_si !: mean temperature at the snow-ice interface (K)
367	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: qcn_ice_bot !: Bottom conduction flux (W/m2)
368	REAL(wp), PUBLIC, ALLOCATABLE, SAVE, DIMENSION(:,:,:) :: qcn_ice_top !: Surface conduction flux (W/m2)
369
370	!
371	!!----------------------------------------------------------------------
372	!! NEMO/ICE 4.0 , NEMO Consortium (2018)
373	!! $Id$
374	!! Software governed by the CeCILL licence (./LICENSE)
375	!!----------------------------------------------------------------------
376	CONTAINS
377
378	FUNCTION ice_alloc()
379	!!-----------------------------------------------------------------
380	!! * Routine ice_alloc *
381	!!-----------------------------------------------------------------
382	INTEGER :: ice_alloc
383	!
384	INTEGER :: ierr(15), ii
385	!!-----------------------------------------------------------------
386	ierr(:) = 0
387
388	ii = 1
389	ALLOCATE( u_oce (jpi,jpj) , v_oce (jpi,jpj) , ht_i_new (jpi,jpj) , strength(jpi,jpj) , &
390	& stress1_i(jpi,jpj) , stress2_i(jpi,jpj) , stress12_i(jpi,jpj) , &
391	& delta_i (jpi,jpj) , divu_i (jpi,jpj) , shear_i (jpi,jpj) , STAT=ierr(ii) )
392
393	ii = ii + 1
394	ALLOCATE( t_bo (jpi,jpj) , wfx_snw_sni(jpi,jpj) , &
395	& wfx_snw (jpi,jpj) , wfx_snw_dyn(jpi,jpj) , wfx_snw_sum(jpi,jpj) , wfx_snw_sub(jpi,jpj) , &
396	& wfx_ice (jpi,jpj) , wfx_sub (jpi,jpj) , wfx_ice_sub(jpi,jpj) , wfx_lam (jpi,jpj) , &
397	& wfx_pnd (jpi,jpj) , &
398	& wfx_bog (jpi,jpj) , wfx_dyn (jpi,jpj) , wfx_bom(jpi,jpj) , wfx_sum(jpi,jpj) , &
399	& wfx_res (jpi,jpj) , wfx_sni (jpi,jpj) , wfx_opw(jpi,jpj) , wfx_spr(jpi,jpj) , &
400	& afx_tot (jpi,jpj) , rn_amax_2d(jpi,jpj), &
401	& qsb_ice_bot(jpi,jpj) , qlead (jpi,jpj) , &
402	& sfx_res (jpi,jpj) , sfx_bri (jpi,jpj) , sfx_dyn(jpi,jpj) , sfx_sub(jpi,jpj) , sfx_lam(jpi,jpj) , &
403	& sfx_bog (jpi,jpj) , sfx_bom (jpi,jpj) , sfx_sum(jpi,jpj) , sfx_sni(jpi,jpj) , sfx_opw(jpi,jpj) , &
404	& hfx_res (jpi,jpj) , hfx_snw (jpi,jpj) , hfx_sub(jpi,jpj) , &
405	& qt_atm_oi (jpi,jpj) , qt_oce_ai (jpi,jpj) , fhld (jpi,jpj) , &
406	& hfx_sum (jpi,jpj) , hfx_bom (jpi,jpj) , hfx_bog(jpi,jpj) , hfx_dif(jpi,jpj) , &
407	& hfx_opw (jpi,jpj) , hfx_thd (jpi,jpj) , hfx_dyn(jpi,jpj) , hfx_spr(jpi,jpj) , &
408	& hfx_err_dif(jpi,jpj) , hfx_err_rem(jpi,jpj) , wfx_err_sub(jpi,jpj) , STAT=ierr(ii) )
409
410	! * Ice global state variables
411	ii = ii + 1
412	ALLOCATE( qtr_ice_bot(jpi,jpj,jpl) , cnd_ice(jpi,jpj,jpl) , t1_ice(jpi,jpj,jpl) , &
413	& h_i (jpi,jpj,jpl) , a_i (jpi,jpj,jpl) , v_i (jpi,jpj,jpl) , &
414	& v_s (jpi,jpj,jpl) , h_s (jpi,jpj,jpl) , t_su (jpi,jpj,jpl) , &
415	& s_i (jpi,jpj,jpl) , sv_i (jpi,jpj,jpl) , o_i (jpi,jpj,jpl) , &
416	& oa_i (jpi,jpj,jpl) , bv_i (jpi,jpj,jpl) , STAT=ierr(ii) )
417
418	ii = ii + 1
419	ALLOCATE( u_ice(jpi,jpj) , v_ice(jpi,jpj) , &
420	& vt_i (jpi,jpj) , vt_s (jpi,jpj) , at_i(jpi,jpj) , ato_i(jpi,jpj) , &
421	& et_i (jpi,jpj) , et_s (jpi,jpj) , tm_i(jpi,jpj) , tm_s (jpi,jpj) , &
422	& sm_i (jpi,jpj) , tm_su(jpi,jpj) , hm_i(jpi,jpj) , hm_s (jpi,jpj) , &
423	& om_i (jpi,jpj) , bvm_i(jpi,jpj) , tau_icebfr(jpi,jpj) , STAT=ierr(ii) )
424
425	ii = ii + 1
426	ALLOCATE( t_s(jpi,jpj,nlay_s,jpl) , e_s(jpi,jpj,nlay_s,jpl) , STAT=ierr(ii) )
427
428	ii = ii + 1
429	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) )
430
431	ii = ii + 1
432	ALLOCATE( a_ip(jpi,jpj,jpl) , v_ip(jpi,jpj,jpl) , a_ip_frac(jpi,jpj,jpl) , h_ip(jpi,jpj,jpl) , STAT = ierr(ii) )
433
434	ii = ii + 1
435	ALLOCATE( at_ip(jpi,jpj) , vt_ip(jpi,jpj) , STAT = ierr(ii) )
436
437	! * Old values of global variables
438	ii = ii + 1
439	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) , &
440	& 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) , &
441	& oa_i_b(jpi,jpj,jpl) , STAT=ierr(ii) )
442
443	ii = ii + 1
444	ALLOCATE( u_ice_b(jpi,jpj) , v_ice_b(jpi,jpj) , at_i_b(jpi,jpj) , STAT=ierr(ii) )
445
446	! * Ice thickness distribution variables
447	ii = ii + 1
448	ALLOCATE( hi_max(0:jpl), hi_mean(jpl), STAT=ierr(ii) )
449
450	! * Ice diagnostics
451	ii = ii + 1
452	ALLOCATE( diag_trp_vi(jpi,jpj) , diag_trp_vs (jpi,jpj) , diag_trp_ei(jpi,jpj), &
453	& diag_trp_es(jpi,jpj) , diag_trp_sv (jpi,jpj) , diag_heat (jpi,jpj), &
454	& diag_sice (jpi,jpj) , diag_vice (jpi,jpj) , diag_vsnw (jpi,jpj), STAT=ierr(ii) )
455
456	! * SIMIP diagnostics
457	ii = ii + 1
458	ALLOCATE( t_si(jpi,jpj,jpl) , tm_si(jpi,jpj) , qcn_ice_bot(jpi,jpj,jpl) , qcn_ice_top(jpi,jpj,jpl) , STAT = ierr(ii) )
459
460	ice_alloc = MAXVAL( ierr(:) )
461	IF( ice_alloc /= 0 ) CALL ctl_warn('ice_alloc: failed to allocate arrays.')
462	!
463	END FUNCTION ice_alloc
464
465	#else
466	!!----------------------------------------------------------------------
467	!! Default option Empty module NO SI3 sea-ice model
468	!!----------------------------------------------------------------------
469	#endif
470
471	!!======================================================================
472	END MODULE ice

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

Download in other formats: