Warning, /doc/old_doc/diags_changes.txt is written in an unsupported language. File is not indexed.
view on githubraw file Latest commit ad38444b on 2018-01-31 20:35:48 UTC
faaf90f2c5 Jean*0001 ================================================================
0002 Apr 03, 2010
0003 1) add diagnostics for KPP non-local flux of Temp, Salt and pTracers
0004 (respectively: KPPg_TH, KPPg_SLT and KPPgTrXX for tracer number XX)
0005 This allows to close the tracer budget when using KPP.
0006
0007 2) Change the diagnostic for KPP non-local term:
0008 name: description:
0009 KPPghat Nonlocal transport coefficient (s/m^2)
0010 (correspond to KPP ghat field, from which the non-local
0011 flux of tracer (T,S,pTr) is computed, as the product of
0012 ghat , KPPdiffKz and surface flux.)
0013 replaced by:
0014 KPPghatK ratio of KPP non-local (salt) flux relative to surface-flux
0015 (correspond to the product: KPP_ghat * KPPdiffKzS
0016 which gives the fraction of the the surface flux of Salt
0017 that KPP return as non local flux; also valid for any passive
0018 tracer, but could be different for Temp., see comment below)
0019
0020 comments (from mitgcm-devel list):
0021 I was also tempted to replace the KPPghat diagnostics
0022 with something more useful which incorporates the KPPdiffKz:
0023 Since it is the product KPPghat*KPPdiffKz which matters,
0024 and given that short time variations of both (which have no
0025 reason not to be correlated) can be significant,
0026 the product of the 2 time-ave is very likely to be quiet
0027 far from the time-ave of the product.
0028 It has also the advantage of a simpler interpretation:
0029 the product is just the fraction of the surface flux which is
0030 treated as non local (no unit, instead of this funny s/m^2
0031 for KPPghat).
0032
0033 Then I would propose to just pick one KPPdiffKz (for instance,
0034 KPPdiffKzS for salinity, since it's also used for Ptracers),
0035 and have only 1 diag: "KPPghatK" for KPPghat*KPPdiffKzS (no unit).
0036
0037 For temperature (KPPghat*KPPdiffKzT), it's probably not too different
0038 from the one computed for salinity (might be in fact a better
0039 time-ave value that what we have now, for the reason above).
0040 And to get a precise diagnostic of KPP-non-local effect
0041 on temperature, there would be this new diagnostic directly from
0042 kpp_transport_t.F (which can be used to close a Temp. budget).
0043
0044 ================================================================
14ff2fe9e4 Dimi*0045 Jun 21, 2009
0046 Some redundancies and relations for model diagnostics:
0047
0048 1) Qnet = QNETtave = - oceQnet = SIqnet
0049
54ac884ead Dimi*0050 2) For open-ocean, i.e., when there is no sea ice:
0051 Qnet = QNETtave = - oceQnet = SIqnet = EXFqnet = SIqneto = SIatmQnt
14ff2fe9e4 Dimi*0052
54ac884ead Dimi*0053 3) EXFqnet = EXFlwnet + EXFswnet - EXFhl - EXFhs
14ff2fe9e4 Dimi*0054
54ac884ead Dimi*0055 4) Qsw = QSWtave = - oceQsw = SIqsw
0056
0057 5) For open-ocean, i.e., when there is no sea ice:
0058 Qsw = QSWtave = - oceQsw = SIqsw = EXFswnet
0059
0060 6) EmPmR = EmPmRtave = -oceFWflx = SIempmr
14ff2fe9e4 Dimi*0061
0062 ================================================================
0063
0064 Nov 19, 2006 (after tag checkpoint58r_post)
0065
0066 I) Some diagnostics have been renamed (essentially, to better
0067 match the content):
0068
0069 1) name: description (oceanic set-up):
0070 PRESSURE Cell-Center Height
0071 replaced by:
0072 RCENTER Cell-Center Height
0073
0074 2) name: description (oceanic set-up):
0075 TICE heat from melt/freeze of sea-ice, >0 increases theta
0076 replaced by:
0077 oceFreez heating from freezing of sea-water (allowFreezing=T)
0078
0079 3) name: description (oceanic set-up):
0080 TAUX zonal surface wind stress, >0 increases uVel
0081 TAUY meridional surf. wind stress, >0 increases vVel
0082 replaced by:
0083 oceTAUX zonal surface wind stress, >0 increases uVel
0084 oceTAUY meridional surf. wind stress, >0 increases vVel
0085
0086 4) name: description (oceanic set-up):
0087 SWFLUX net upward SW radiation, >0 increases theta
0088 replaced by:
0089 oceQsw net Short-Wave radiation (+=down), >0 increases theta
0090
0091 5) name: description (oceanic set-up):
0092 DIFx_TH Zonal Diffusive Flux of Pot.Temperature
0093 DIFy_TH Meridional Diffusive Flux of Pot.Temperature
0094 replaced by:
0095 DFxE_TH Zonal Diffusive Flux of Pot.Temperature
0096 DFyE_TH Meridional Diffusive Flux of Pot.Temperature
0097
0098 6) name: description (oceanic set-up):
0099 DIFx_SLT Zonal Diffusive Flux of Salinity
0100 DIFy_SLT Meridional Diffusive Flux of Salinity
0101 replaced by:
0102 DFxE_SLT Zonal Diffusive Flux of Salinity
0103 DFyE_SLT Meridional Diffusive Flux of Salinity
0104
0105 -----------------------------------------------
0106 II) Change description of existing diagnostics:
0107
0108 name: old description (oceanic set-up):
0109 TFLUX net surface heat flux, >0 increases theta
0110 SFLUX net surface salt flux, >0 increases salt
0111 name: new description (oceanic set-up):
0112 TFLUX total heat flux (match heat-content variations), >0 increases theta
0113 SFLUX total salt flux (match salt-content variations), >0 increases salt
0114
0115 -----------------------------------------------
0116 III) New diagnostics have been added:
0117
0118 name: description (oceanic set-up):
0119 atmPload Atmospheric pressure loading
0120 sIceLoad sea-ice loading (in Mass of ice+snow / area unit)
0121 oceQnet net surface heat flux into the ocean (+=down), >0 increases theta
0122 oceFWflx net surface Fresh-Water flux into the ocean (+=down), >0 decreases salinity
0123 oceSflux net surface Salt flux into the ocean (+=down), >0 increases salinity
0124 surForcT model surface forcing for Temperature, >0 increases theta
0125 surForcS model surface forcing for Salinity, >0 increases salinity
0126
0127 --------------------------------------------------------------------------
0128 Relation between surForcT,surForcS and others surface forcing diagnostics:
0129 [x] = average of model variable "x" over the diagnostic time interval
0130
0131 a) if useRealFreshWaterFlux=F or (nonlinFreeSurf=0 & usingZCoords=T)
0132 surForcT = oceQnet + TRELAX - oceQsw
0133 surForcS = oceSflux + SRELAX - [PmEpR*So]
0134 (with So = local Sea-Surface Salinity (SSS) if convertFW2Salt=-1
0135 and So = convertFW2Salt otherwise)
0136 oceFWflx = [PmEpR]
0137 TFLUX = surForcT + oceQsw + oceFreez
0138 SFLUX = surForcS
0139
0140 b) if useRealFreshWaterFlux=T & (nonlinFreeSurf>0 or usingPCoords=T),
0141 In general:
0142 surForcT = oceQnet + TRELAX - oceQsw + [T_dilution_effect]*Cp
0143 surForcS = oceSflux + SRELAX + [S_dilution_effect]
0144 where T_dilution_effect = PmEpR*( temp_EvPrRn - SST )
0145 and S_dilution_effect = PmEpR*( salt_EvPrRn - SSS )
0146 oceFWflx = [PmEpR]
0147 TFLUX = surForcT + oceQsw + oceFreez + [PmEpR*SST]*Cp
0148 SFLUX = surForcS + [PmEpR*SSS]
0149
0150 And with the default value: salt_EvPrRn=0. & temp_EvPrRn=UNSET_RL
0151 (=> no dilution effect on Temp.):
0152 surForcT = oceQnet + TRELAX - oceQsw
0153 surForcS = oceSflux + SRELAX - [PmEpR*SSS]
0154
0155 Notes:
d9ed7f50c5 Dimi*0156 1) Here PmEpR is assumed to be the fresh-water mass flux
0157 per surface area [units: kg/m^2/s] whereas the model variable
0158 EmPmR is still a volume flux per surface area [units: m/s].
0159 2) With Linear FreeSurf, there is a small loss of heat/salt/tracer at the
0160 surface (d/dt(Eta) inconsistent with fixed surf grid cell thickness:
0161 a) if linFSConserveTr is set to true (file "data"), then the model
0162 corrects for this (see S/R calc_wsurf_tr.F).
0163 b) if linFSConserveTr=False (=the default), the term corresponding
0164 to w_surface*SST,SSS is missing in TFLUX,SFLUX to match exactly the
0165 Heat and Salt budget evolution so need to account for this term in
0166 the budget, which can be obtained from the 1rst level
0167 of WTHMASS / WSLTMASS diagnostics (diagnostics ADVr_TH / ADVr_SLT
0168 is not the right one for this purpose, it's just zero at k=1).
0169 3) There is just one more undocumented/hidden case
0170 (nonlinFreeSurf=0 & select_rStar=-1) which is not covered.
3fd0679845 Patr*0171 4) For extended diagnostics in the presence of sea-ice and using
0172 pkg/seaice/ (in particular atmosphere-ice and ice-ocean fluxes)
0173 see online documentation, section 6.6.2.6 "SEAICE diagnostics"
0174