Back to home page

MITgcm
 
 

    

File indexing completed on 2025-09-19 05:08:06 UTC

view on githubraw file Latest commit c3be0435 on 2025-09-18 18:40:16 UTC
ec31157ce3 Jean*0001 C
ac0f2a1690 Chri*0002 CBOP
                0003 C    !ROUTINE: SURFACE.h
                0004 C    !INTERFACE:
                0005 C    include SURFACE.h
                0006 C    !DESCRIPTION: \bv
                0007 C     *==========================================================*
f15994caab Jean*0008 C     | SURFACE.h
                0009 C     | o Header file defining surface-related model variables
ac0f2a1690 Chri*0010 C     *==========================================================*
f15994caab Jean*0011 C     | Contains variables relative to the surface position
                0012 C     | that are held fixed in linear free-surface formulation
                0013 C     | but can vary with time with a non-linear free-surface.
ac0f2a1690 Chri*0014 C     *==========================================================*
                0015 C     \ev
                0016 CEOP
ec31157ce3 Jean*0017 
73af412e33 Jean*0018 C--   COMMON /SURF_FIXED/  fixed surface arrays (Real)
b1cd157538 Jean*0019 C     Bo_surf  :: Buoyancy|1/rho [ocean|atmos] at surface level [=g|alpha(p_o)]
73af412e33 Jean*0020 C     recip_Bo :: 1/Bo_surf
                0021 C     topoZ    :: topographic height [m] (used mainly for atmosphere)
a64427cf14 Alis*0022 C     phi0surf :: starting point for integrating phi_Hyd
be72675163 Jean*0023       COMMON /SURF_FIXED/ Bo_surf, recip_Bo, topoZ, phi0surf
73af412e33 Jean*0024       _RL  Bo_surf (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
ec31157ce3 Jean*0025       _RL  recip_Bo(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
73af412e33 Jean*0026       _RS  topoZ   (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
be72675163 Jean*0027       _RS  phi0surf(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
ec31157ce3 Jean*0028 
f15994caab Jean*0029 C--   COMMON /SURF_CORREC/ Common block for correction of source/sink of
74c7704c2f Davi*0030 C--                        Tracer due to W at the surface with Linear
                0031 C--                        Free Surface
                0032 C     TsurfCor :: Pot.Temp Linear-Free-Surface correction term [K.r_Unit/s]
ba0b047096 Mart*0033 C     SsurfCor :: Salinity Linear-Free-Surface correction term [g/kg.r_Unit/s]
74c7704c2f Davi*0034       COMMON /SURF_CORREC/ TsurfCor, SsurfCor
                0035       _RL TsurfCor
                0036       _RL SsurfCor
                0037 
c3be04357d Jean*0038 C--   COMMON /ETA_UPDATES/ variables related to Eta updates (with exactConserv)
a1bffd2f2d Jean*0039 C     etaHnm1 :: surface r-anomaly, etaH, at previous time level
8dc89a3cca Jean*0040 C     dEtaHdt :: time derivative of total column height [r_unit/s = w unit]
                0041 C     PmEpR   :: keep the fresh water input (=-EmPmR) of the previous time step
c3be04357d Jean*0042       COMMON /ETA_UPDATES/ etaHnm1, dEtaHdt, PmEpR
ccbf39d1a4 Jean*0043       _RL etaHnm1(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0044       _RL dEtaHdt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
c3be04357d Jean*0045       _RL PmEpR  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
09d2417e9e Patr*0046 
7c80d1c2ea Jean*0047 #ifdef NONLIN_FRSURF
00b29feb62 Jean*0048 C--   COMMON /SURF_CHANGE/ transient variables used for Non-Lin Free-Surf
ac0f2a1690 Chri*0049 C     hFac_surfC ::  New thickness factor of the surface level
7c80d1c2ea Jean*0050 C                        center (Tracer point)
ac0f2a1690 Chri*0051 C     hFac_surfW ::  idem, West  interface (U point)
                0052 C     hFac_surfS ::  idem, South interface (V point)
72a058b866 Gael*0053 C     hFac_surfNm1C, etc. :: prior values
7c80d1c2ea Jean*0054       COMMON /SURF_CHANGE/
72a058b866 Gael*0055      &     hFac_surfC, hFac_surfW, hFac_surfS,
                0056      &     hFac_surfNm1C, hFac_surfNm1W, hFac_surfNm1S
7c80d1c2ea Jean*0057       _RS  hFac_surfC(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0058       _RS  hFac_surfW(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0059       _RS  hFac_surfS(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
72a058b866 Gael*0060       _RS  hFac_surfNm1C(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0061       _RS  hFac_surfNm1W(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0062       _RS  hFac_surfNm1S(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
ea4246aae8 Jean*0063 
cdc9f269ae Patr*0064 C     Local variables in common block
f15994caab Jean*0065 C     Rmin_surf :: minimum r_value of the free surface position
cdc9f269ae Patr*0066 C                  that satisfy  the hFacInf criteria
                0067       COMMON /LOCAL_CALC_SURF_DR/ Rmin_surf
                0068       _RL Rmin_surf(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0069 
00b29feb62 Jean*0070 C--   COMMON /RSTAR_CHANGE/ transient variables used with r* Coordinate
                0071 C     rStarFacC :: = dr/dr* = ratio of r-thickness / r*-thickness = h^n / H
                0072 C     rStarFacW :: same but for West  face
                0073 C     rStarFacS :: same but for South face
ccbf39d1a4 Jean*0074 C     pStarFacK :: rStarFacC**atm_kappa (for atmosphere in p* coords)
72a058b866 Gael*0075 C     rStarFacNm1C, etc. :: prior values
00b29feb62 Jean*0076 C     rStarExpC :: column expansion factor = h^n+1/h^n , Centered
                0077 C     rStarExpW :: column expansion factor = h^n+1/h^n , Western  face
                0078 C     rStarExpS :: column expansion factor = h^n+1/h^n , Southern face
f15994caab Jean*0079 C     rStarDhCDt:: relative time derivative of h_Center = d.eta/dt / H
00b29feb62 Jean*0080 C     rStarDhWDt:: relative time derivative of h_West_face  (u.point)
                0081 C     rStarDhSDt:: relative time derivative of h_South_face (v.point)
                0082       COMMON /RSTAR_CHANGE/
ccbf39d1a4 Jean*0083      &     rStarFacC, rStarFacW, rStarFacS, pStarFacK,
72a058b866 Gael*0084      &     rStarFacNm1C, rStarFacNm1W, rStarFacNm1S,
00b29feb62 Jean*0085      &     rStarExpC, rStarExpW, rStarExpS,
                0086      &     rStarDhCDt,rStarDhWDt,rStarDhSDt
                0087       _RL  rStarFacC (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0088       _RL  rStarFacW (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0089       _RL  rStarFacS (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
ccbf39d1a4 Jean*0090       _RL  pStarFacK (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
72a058b866 Gael*0091       _RL  rStarFacNm1C (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0092       _RL  rStarFacNm1W (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0093       _RL  rStarFacNm1S (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
00b29feb62 Jean*0094       _RL  rStarExpC (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0095       _RL  rStarExpW (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0096       _RL  rStarExpS (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0097       _RL  rStarDhCDt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0098       _RL  rStarDhWDt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0099       _RL  rStarDhSDt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0100 
                0101 C--   COMMON /RSTAR_FIXED/ fixed thickness ratio ( r* discretization )
                0102 C     h0FacC :: initial (and fixed in time) hFacC factor
                0103 C     h0FacW :: initial (and fixed in time) hFacW factor
                0104 C     h0FacS :: initial (and fixed in time) hFacS factor
                0105       COMMON /RSTAR_FIXED/
                0106      & h0FacC, h0FacW, h0FacS
                0107       _RS h0FacC(1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr,nSx,nSy)
                0108       _RS h0FacW(1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr,nSx,nSy)
                0109       _RS h0FacS(1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr,nSx,nSy)
                0110 
f15994caab Jean*0111 C--   COMMON /SIGMA_CHANGE/ transient variables used with r* Coordinate
                0112 C     etaHw    :: surface r-anomaly (etaH) at Western  edge (U location)
                0113 C     etaHs    :: surface r-anomaly (etaH) at Southern edge (V location)
                0114 C     dEtaWdt  :: time derivative of etaH at Western  edge (U location)
                0115 C     dEtaSdt  :: time derivative of etaH at Southern edge (V location)
                0116       COMMON /SIGMA_CHANGE/
                0117      &  etaHw, etaHs,
                0118      &  dEtaWdt, dEtaSdt
                0119       _RL  etaHw  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0120       _RL  etaHs  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0121       _RL  dEtaWdt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
                0122       _RL  dEtaSdt(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
7c80d1c2ea Jean*0123 #endif /* NONLIN_FRSURF */
[ Source navigation ] [ Diff markup ] [ Identifier search ] [ general search ]

This page was automatically generated from https://github.com/MITgcm/MITgcm by the 2.2.1-MITgcm-0.1 LXR engine.

The LXR team
Valid CSS 2.1! Valid HTML 4.01!