Back to home page

darwin3

 
 

    


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