| 1 | 
dgoldberg | 
1.1 | 
C $Header: /u/gcmpack/MITgcm/pkg/shelfice/SHELFICE.h,v 1.13 2013/10/15 20:33:58 dimitri Exp $ | 
| 2 | 
  | 
  | 
C $Name:  $ | 
| 3 | 
  | 
  | 
 | 
| 4 | 
  | 
  | 
#ifdef ALLOW_SHELFICE | 
| 5 | 
  | 
  | 
 | 
| 6 | 
  | 
  | 
CBOP | 
| 7 | 
  | 
  | 
C !ROUTINE: SHELFICE.h | 
| 8 | 
  | 
  | 
 | 
| 9 | 
  | 
  | 
C !DESCRIPTION: \bv | 
| 10 | 
  | 
  | 
C     *==========================================================* | 
| 11 | 
  | 
  | 
C     | SHELFICE.h | 
| 12 | 
  | 
  | 
C     | o Basic header thermodnynamic shelf ice package. | 
| 13 | 
  | 
  | 
C     |   Contains all SHELFICE field declarations. | 
| 14 | 
  | 
  | 
C     *==========================================================* | 
| 15 | 
  | 
  | 
 | 
| 16 | 
  | 
  | 
C----------------------------------------------------------------------- | 
| 17 | 
  | 
  | 
C | 
| 18 | 
  | 
  | 
C--   Constants that can be set in data.shelfice | 
| 19 | 
  | 
  | 
C     SHELFICEtopoFile         :: File containing the topography of the | 
| 20 | 
  | 
  | 
C                                 shelfice draught (unit=m) | 
| 21 | 
  | 
  | 
C     SHELFICEmassFile         :: name of shelfice Mass file | 
| 22 | 
  | 
  | 
C     SHELFICEloadAnomalyFile  :: name of shelfice load anomaly file | 
| 23 | 
  | 
  | 
C     SHELFICEDynamicsFile     :: file to read for ice mass dynamics | 
| 24 | 
  | 
  | 
C     SHELFICEDragLinear       :: linear drag at bottom shelfice (1/s) | 
| 25 | 
  | 
  | 
C     SHELFICEDragQuadratic    :: quadratic drag at bottom shelfice (1/m) | 
| 26 | 
  | 
  | 
C     SHELFICEheatTransCoeff   :: heat transfer coefficient that determines | 
| 27 | 
  | 
  | 
C                                 heat flux into shelfice (m/s) | 
| 28 | 
  | 
  | 
C     SHELFICEsaltTransCoeff   :: salinity transfer coefficient that determines | 
| 29 | 
  | 
  | 
C                                 salt flux into shelfice (m/s) | 
| 30 | 
  | 
  | 
C     SHELFICElatentHeat       :: latent heat of fusion (J/kg) | 
| 31 | 
  | 
  | 
C     useISOMIPTD              :: use simple ISOMIP thermodynamics | 
| 32 | 
  | 
  | 
C     SHELFICEconserve         :: use conservative form of H&O-thermodynamics | 
| 33 | 
  | 
  | 
C                                 following Jenkins et al. (2001, JPO) | 
| 34 | 
  | 
  | 
C     SHELFICEallowThinIceMass :: flag to allow thinning/thickening of ice shelf by melt/freeze/ice dynamics | 
| 35 | 
  | 
  | 
C     SHELFICEboundaryLayer    :: turn on vertical merging of cells to for a | 
| 36 | 
  | 
  | 
C                                 boundary layer of drF thickness | 
| 37 | 
  | 
  | 
C     SHELFICEadvDiffHeatFlux  :: use advective-diffusive heat flux into the ice shelf | 
| 38 | 
  | 
  | 
C                                 instead of diffusive heat flux (default), see Holland | 
| 39 | 
  | 
  | 
C                                 and Jenkins (1999), eq.21,22,26,31 | 
| 40 | 
  | 
  | 
C     SHELFICEuseGammaFrict    :: use velocity dependent exchange coefficients, | 
| 41 | 
  | 
  | 
C                                 see Holland and Jenkins (1999), eq.11-18 | 
| 42 | 
  | 
  | 
C     no_slip_shelfice         :: set slip conditions for shelfice separately, | 
| 43 | 
  | 
  | 
C                                 (by default the same as no_slip_bottom) | 
| 44 | 
  | 
  | 
C     SHELFICEwriteState       :: enable output | 
| 45 | 
  | 
  | 
C     SHELFICE_dump_mnc        :: use netcdf for snapshot output | 
| 46 | 
  | 
  | 
C     SHELFICE_tave_mnc        :: use netcdf for time-averaged output | 
| 47 | 
  | 
  | 
C     SHELFICE_dumpFreq        :: analoguous to dumpFreq (= default) | 
| 48 | 
  | 
  | 
C     SHELFICE_taveFreq        :: analoguous to taveFreq (= default) | 
| 49 | 
  | 
  | 
C | 
| 50 | 
  | 
  | 
C--   Fields | 
| 51 | 
  | 
  | 
C     ktopC                  :: index of the top "wet cell" (2D) | 
| 52 | 
  | 
  | 
C     R_shelfIce             :: shelfice topography [m] | 
| 53 | 
  | 
  | 
C     shelficeMassInit       :: ice-shelf mass (per unit area) [kg/m^2] | 
| 54 | 
  | 
  | 
C     shelficeMass           :: ice-shelf mass (per unit area) [kg/m^2] | 
| 55 | 
  | 
  | 
C     shelficeMassDynamics    :: artificial divergence of ice shelf transport to simulate dynamic thinning | 
| 56 | 
  | 
  | 
C     shelficeLoadAnomaly    :: pressure load anomaly of shelfice [Pa] | 
| 57 | 
  | 
  | 
C     shelficeHeatFlux       :: upward heat flux [W/m^2] | 
| 58 | 
  | 
  | 
C     shelficeFreshWaterFlux :: upward fresh water flux (virt. salt flux) [kg/m^2/s] | 
| 59 | 
  | 
  | 
C     shelficeForcingT       :: analogue of surfaceForcingT | 
| 60 | 
  | 
  | 
C                               units are  r_unit.Kelvin/s (=Kelvin.m/s if r=z) | 
| 61 | 
  | 
  | 
C     shelficeForcingS       :: analogue of surfaceForcingS | 
| 62 | 
  | 
  | 
C                               units are  r_unit.psu/s (=psu.m/s if r=z) | 
| 63 | 
  | 
  | 
C----------------------------------------------------------------------- | 
| 64 | 
  | 
  | 
C \ev | 
| 65 | 
  | 
  | 
CEOP | 
| 66 | 
  | 
  | 
 | 
| 67 | 
  | 
  | 
      COMMON /SHELFICE_PARMS_I/  kTopC | 
| 68 | 
  | 
  | 
      INTEGER kTopC (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 69 | 
  | 
  | 
 | 
| 70 | 
  | 
  | 
      COMMON /SHELFICE_PARMS_R/ | 
| 71 | 
  | 
  | 
     &     SHELFICE_dumpFreq, SHELFICE_taveFreq, | 
| 72 | 
  | 
  | 
     &     SHELFICEheatTransCoeff, SHELFICEsaltTransCoeff, | 
| 73 | 
  | 
  | 
     &     rhoShelfice, SHELFICEkappa, | 
| 74 | 
  | 
  | 
     &     SHELFICElatentHeat, recip_SHELFICElatentHeat, | 
| 75 | 
  | 
  | 
     &     SHELFICEheatCapacity_Cp, | 
| 76 | 
  | 
  | 
     &     SHELFICEthetaSurface, | 
| 77 | 
  | 
  | 
     &     SHELFICEDragLinear, SHELFICEDragQuadratic, | 
| 78 | 
  | 
  | 
     &     shiCdrag, shiZetaN, shiRc, | 
| 79 | 
  | 
  | 
     &     shiPrandtl, shiSchmidt, shiKinVisc | 
| 80 | 
  | 
  | 
 | 
| 81 | 
  | 
  | 
      _RL SHELFICE_dumpFreq, SHELFICE_taveFreq | 
| 82 | 
  | 
  | 
      _RL SHELFICEheatTransCoeff | 
| 83 | 
  | 
  | 
      _RL SHELFICEsaltTransCoeff | 
| 84 | 
  | 
  | 
      _RL SHELFICElatentHeat | 
| 85 | 
  | 
  | 
      _RL SHELFICEheatCapacity_Cp | 
| 86 | 
  | 
  | 
      _RL rhoShelfice | 
| 87 | 
  | 
  | 
      _RL SHELFICEkappa | 
| 88 | 
  | 
  | 
      _RL recip_SHELFICElatentHeat | 
| 89 | 
  | 
  | 
      _RL SHELFICEDragLinear | 
| 90 | 
  | 
  | 
      _RL SHELFICEDragQuadratic | 
| 91 | 
  | 
  | 
      _RL SHELFICEthetaSurface | 
| 92 | 
  | 
  | 
      _RL shiCdrag, shiZetaN, shiRc | 
| 93 | 
  | 
  | 
      _RL shiPrandtl, shiSchmidt, shiKinVisc | 
| 94 | 
  | 
  | 
 | 
| 95 | 
  | 
  | 
      COMMON /SHELFICE_FIELDS_RL/ | 
| 96 | 
  | 
  | 
     &     shelficeForcingT, shelficeForcingS, | 
| 97 | 
  | 
  | 
     &     shiTransCoeffT, shiTransCoeffS | 
| 98 | 
  | 
  | 
      _RL shelficeForcingT      (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 99 | 
  | 
  | 
      _RL shelficeForcingS      (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 100 | 
  | 
  | 
      _RL shiTransCoeffT        (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 101 | 
  | 
  | 
      _RL shiTransCoeffS        (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 102 | 
  | 
  | 
 | 
| 103 | 
  | 
  | 
      COMMON /SHELFICE_FIELDS_RS/ | 
| 104 | 
  | 
  | 
     &     R_shelfIce, | 
| 105 | 
  | 
  | 
     &     shelficeMassInit, | 
| 106 | 
  | 
  | 
     &     shelficeMass, | 
| 107 | 
  | 
  | 
     &     shelficeLoadAnomaly, | 
| 108 | 
  | 
  | 
     &     shelficeHeatFlux, | 
| 109 | 
  | 
  | 
     &     shelfIceFreshWaterFlux, | 
| 110 | 
  | 
  | 
     &     shelficeMassDynamics | 
| 111 | 
  | 
  | 
      _RS R_shelfIce            (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 112 | 
  | 
  | 
      _RS shelficeMass          (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 113 | 
  | 
  | 
      _RS shelficeMassInit      (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 114 | 
  | 
  | 
      _RS shelficeLoadAnomaly   (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 115 | 
  | 
  | 
      _RS shelficeHeatFlux      (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 116 | 
  | 
  | 
      _RS shelficeFreshWaterFlux(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 117 | 
  | 
  | 
      _RS shelficeMassDynamics  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy) | 
| 118 | 
  | 
  | 
 | 
| 119 | 
  | 
  | 
#ifdef ALLOW_SHIFWFLX_CONTROL | 
| 120 | 
  | 
  | 
      COMMON /SHELFICE_MASKS_CTRL/ maskSHI | 
| 121 | 
  | 
  | 
      _RS maskSHI  (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr,nSx,nSy) | 
| 122 | 
  | 
  | 
#endif /* ALLOW_SHIFWFLX_CONTROL */ | 
| 123 | 
  | 
  | 
 | 
| 124 | 
  | 
  | 
      LOGICAL SHELFICEisOn | 
| 125 | 
  | 
  | 
      LOGICAL useISOMIPTD | 
| 126 | 
  | 
  | 
      LOGICAL SHELFICEconserve | 
| 127 | 
  | 
  | 
      LOGICAL SHELFICEboundaryLayer | 
| 128 | 
  | 
  | 
      LOGICAL no_slip_shelfice | 
| 129 | 
  | 
  | 
      LOGICAL SHELFICEwriteState | 
| 130 | 
  | 
  | 
      LOGICAL SHELFICE_dump_mdsio | 
| 131 | 
  | 
  | 
      LOGICAL SHELFICE_tave_mdsio | 
| 132 | 
  | 
  | 
      LOGICAL SHELFICE_dump_mnc | 
| 133 | 
  | 
  | 
      LOGICAL SHELFICE_tave_mnc | 
| 134 | 
  | 
  | 
      LOGICAL SHELFICEadvDiffHeatFlux | 
| 135 | 
  | 
  | 
      LOGICAL SHELFICEuseGammaFrict | 
| 136 | 
  | 
  | 
      LOGICAL SHELFICEallowThinIceMass | 
| 137 | 
  | 
  | 
      COMMON /SHELFICE_PARMS_L/ | 
| 138 | 
  | 
  | 
     &     SHELFICEisOn, | 
| 139 | 
  | 
  | 
     &     useISOMIPTD, | 
| 140 | 
  | 
  | 
     &     SHELFICEconserve, | 
| 141 | 
  | 
  | 
     &     SHELFICEboundaryLayer, | 
| 142 | 
  | 
  | 
     &     no_slip_shelfice, | 
| 143 | 
  | 
  | 
     &     SHELFICEwriteState, | 
| 144 | 
  | 
  | 
     &     SHELFICE_dump_mdsio, | 
| 145 | 
  | 
  | 
     &     SHELFICE_tave_mdsio, | 
| 146 | 
  | 
  | 
     &     SHELFICE_dump_mnc, | 
| 147 | 
  | 
  | 
     &     SHELFICE_tave_mnc, | 
| 148 | 
  | 
  | 
     &     SHELFICEadvDiffHeatFlux, | 
| 149 | 
  | 
  | 
     &     SHELFICEuseGammaFrict, | 
| 150 | 
  | 
  | 
     &     SHELFICEallowThinIceMass | 
| 151 | 
  | 
  | 
 | 
| 152 | 
  | 
  | 
      CHARACTER*(MAX_LEN_FNAM) SHELFICEloadAnomalyFile | 
| 153 | 
  | 
  | 
      CHARACTER*(MAX_LEN_FNAM) SHELFICEmassFile | 
| 154 | 
  | 
  | 
      CHARACTER*(MAX_LEN_FNAM) SHELFICEtopoFile | 
| 155 | 
  | 
  | 
      CHARACTER*(MAX_LEN_FNAM) SHELFICEDynamicsFile | 
| 156 | 
  | 
  | 
      COMMON /SHELFICE_PARM_C/ | 
| 157 | 
  | 
  | 
     &     SHELFICEloadAnomalyFile, | 
| 158 | 
  | 
  | 
     &     SHELFICEmassFile, | 
| 159 | 
  | 
  | 
     &     SHELFICEtopoFile, | 
| 160 | 
  | 
  | 
     &     SHELFICEDynamicsFile | 
| 161 | 
  | 
  | 
 | 
| 162 | 
  | 
  | 
#endif /* ALLOW_SHELFICE */ |