| 1 | C $Header: /u/gcmpack/MITgcm/pkg/seaice/seaice_tracer_phys.F,v 1.8 2012/03/05 14:52:16 gforget Exp $ | 
| 2 | C $Name:  $ | 
| 3 |  | 
| 4 | #include "SEAICE_OPTIONS.h" | 
| 5 |  | 
| 6 | CStartOfInterface | 
| 7 | SUBROUTINE SEAICE_TRACER_PHYS( myTime, myIter, myThid ) | 
| 8 | C     *=======================================================* | 
| 9 | C     | SUBROUTINE seaice_tracer_phys | 
| 10 | C     | o Time step SItr/SItrEFF as a result of | 
| 11 | C     |   seaice thermodynamics and specific tracer physics | 
| 12 | C     *=======================================================* | 
| 13 | IMPLICIT NONE | 
| 14 |  | 
| 15 | C     === Global variables === | 
| 16 | #include "SIZE.h" | 
| 17 | #include "EEPARAMS.h" | 
| 18 | #include "FFIELDS.h" | 
| 19 | #include "DYNVARS.h" | 
| 20 | #include "SEAICE_SIZE.h" | 
| 21 | #include "SEAICE.h" | 
| 22 | #include "SEAICE_PARAMS.h" | 
| 23 | #include "SEAICE_TRACER.h" | 
| 24 | #ifdef ALLOW_SALT_PLUME | 
| 25 | # include "SALT_PLUME.h" | 
| 26 | #endif | 
| 27 |  | 
| 28 | C     === Routine arguments === | 
| 29 | C     INPUT: | 
| 30 | C     myTime  :: Simulation time | 
| 31 | C     myIter  :: Simulation timestep number | 
| 32 | C     myThid  :: Thread no. that called this routine. | 
| 33 | C     OUTPUT: | 
| 34 | _RL myTime | 
| 35 | INTEGER myIter, myThid | 
| 36 | CEndOfInterface | 
| 37 |  | 
| 38 | C     === Local variables === | 
| 39 | #ifdef ALLOW_SITRACER | 
| 40 |  | 
| 41 | INTEGER iTr, jTh, I, J, bi, bj, ks | 
| 42 | _RL SItrFromOcean  (1:sNx,1:sNy) | 
| 43 | _RL SItrFromFlood   (1:sNx,1:sNy) | 
| 44 | _RL HEFFprev, HEFFpost, growFact, meltPart, tmpscal1 | 
| 45 | _RL SItrExpand  (1:sNx,1:sNy) | 
| 46 | _RL AREAprev, AREApost, expandFact | 
| 47 | CHARACTER*8   diagName | 
| 48 |  | 
| 49 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 50 | _RL DIAGarray     (1:sNx,1:sNy,Nr) | 
| 51 | #endif | 
| 52 |  | 
| 53 | cgf for now I do not fully account for ocean-ice fluxes of tracer | 
| 54 | cgf -> I just prescribe it consistent with age tracer | 
| 55 | cgf eventually I will need to handle them as function params | 
| 56 |  | 
| 57 | ks=1 | 
| 58 |  | 
| 59 | DO bj=myByLo(myThid),myByHi(myThid) | 
| 60 | DO bi=myBxLo(myThid),myBxHi(myThid) | 
| 61 | DO iTr=1,SItrNumInUse | 
| 62 |  | 
| 63 | c 0) set ice-ocean and ice-snow exchange values | 
| 64 | c ============================================= | 
| 65 | DO J=1,sNy | 
| 66 | DO I=1,sNx | 
| 67 | SItrFromOcean(i,j)=SItrFromOcean0(iTr) | 
| 68 | SItrFromFlood(i,j)=SItrFromFlood0(iTr) | 
| 69 | SItrExpand(i,j)=SItrExpand0(iTr) | 
| 70 | ENDDO | 
| 71 | ENDDO | 
| 72 | c salinity tracer: | 
| 73 | if ( (SItrName(iTr).EQ.'salinity').AND. | 
| 74 | &      (SItrFromOceanFrac(iTr).GT.ZERO) ) then | 
| 75 | DO J=1,sNy | 
| 76 | DO I=1,sNx | 
| 77 | SItrFromOcean(i,j)=SItrFromOceanFrac(iTr)*salt(I,j,ks,bi,bj) | 
| 78 | SItrFromFlood(i,j)=SItrFromFloodFrac(iTr)*salt(I,j,ks,bi,bj) | 
| 79 | ENDDO | 
| 80 | ENDDO | 
| 81 | endif | 
| 82 | c 1) seaice thermodynamics processes | 
| 83 | c ================================== | 
| 84 | if (SItrMate(iTr).EQ.'HEFF') then | 
| 85 | DO J=1,sNy | 
| 86 | DO I=1,sNx | 
| 87 | HEFFprev=SItrHEFF(i,j,bi,bj,1) | 
| 88 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 89 | DIAGarray(I,J,5+(iTr-1)*5) = | 
| 90 | &    HEFFprev*SItracer(i,j,bi,bj,iTr) + SItrBucket(i,j,bi,bj,iTr) | 
| 91 | #endif | 
| 92 | c apply the sequence of thermodynamics increments to actual traceur | 
| 93 | c (see seaice_growth.F) | 
| 94 | c (jTh=1 tendency due to ice-ocean interaction) | 
| 95 | c (jTh=2 tendency due to the atmosphere, over ice covered part) | 
| 96 | c (jTh=3 tendency due to the atmosphere, over open water part) | 
| 97 | c (jTh=4 tendency due to flooding) | 
| 98 | DO jTh=1,3 | 
| 99 | HEFFprev=SItrHEFF(i,j,bi,bj,jTh) | 
| 100 | HEFFpost=SItrHEFF(i,j,bi,bj,jTh+1) | 
| 101 | c compute ratio in [0. 1.] range for either growth or melt | 
| 102 | growFact=1. _d 0 | 
| 103 | meltPart=0. _d 0 | 
| 104 | if (HEFFpost.GT.HEFFprev) growFact=HEFFprev/HEFFpost | 
| 105 | if (HEFFpost.LT.HEFFprev) meltPart=HEFFprev-HEFFpost | 
| 106 | c update SItr accordingly | 
| 107 | SItracer(i,j,bi,bj,iTr)=SItracer(i,j,bi,bj,iTr)*growFact | 
| 108 | &                      +SItrFromOcean(i,j)*(1. _d 0 - growFact) | 
| 109 | SItrBucket(i,j,bi,bj,iTr)=SItrBucket(i,j,bi,bj,iTr) | 
| 110 | &             -HEFFpost*SItrFromOcean(i,j)*(1. _d 0 - growFact) | 
| 111 | SItrBucket(i,j,bi,bj,iTr)=SItrBucket(i,j,bi,bj,iTr) | 
| 112 | &                            +meltPart*SItracer(i,j,bi,bj,iTr) | 
| 113 | ENDDO | 
| 114 | c apply flooding term | 
| 115 | growFact=1. _d 0 | 
| 116 | HEFFprev=SItrHEFF(i,j,bi,bj,4) | 
| 117 | HEFFpost=SItrHEFF(i,j,bi,bj,5) | 
| 118 | if (HEFFpost.GT.HEFFprev) growFact=HEFFprev/HEFFpost | 
| 119 | SItracer(i,j,bi,bj,iTr)=SItracer(i,j,bi,bj,iTr)*growFact | 
| 120 | &                     +SItrFromFlood(i,j) *(1. _d 0 - growFact) | 
| 121 | c rk: flooding can only imply an ocean-ice tracer exchange, as long | 
| 122 | c as we dont have snow tracers, so it goes through SItrBucket. | 
| 123 | SItrBucket(i,j,bi,bj,iTr)=SItrBucket(i,j,bi,bj,iTr) | 
| 124 | &             -HEFFpost*SItrFromFlood(i,j)*(1. _d 0 - growFact) | 
| 125 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 126 | DIAGarray(I,J,5+(iTr-1)*5) = HEFFpost*SItracer(i,j,bi,bj,iTr) | 
| 127 | &  +SItrBucket(i,j,bi,bj,iTr)-DIAGarray(I,J,5+(iTr-1)*5) | 
| 128 | #endif | 
| 129 | ENDDO | 
| 130 | ENDDO | 
| 131 | c TAF?      if (SItrMate(iTr).EQ.'AREA') then | 
| 132 | else | 
| 133 | c 1) or seaice cover expansion | 
| 134 | c ============================ | 
| 135 | c this is much simpler than for ice volume/mass tracers, because | 
| 136 | c properties of the ice surface are not be conserved across the | 
| 137 | c ocean-ice system, the contraction/expansion terms are all | 
| 138 | c simultaneous (which is sane), and the only generic effect | 
| 139 | c is due to expansion (new cover). | 
| 140 | DO J=1,sNy | 
| 141 | DO I=1,sNx | 
| 142 | c apply expansion | 
| 143 | AREAprev=SItrAREA(i,j,bi,bj,2) | 
| 144 | AREApost=SItrAREA(i,j,bi,bj,3) | 
| 145 | c compute ratio in [0. 1.] range for expansion/contraction | 
| 146 | expandFact=1. _d 0 | 
| 147 | if (AREApost.GT.AREAprev) expandFact=AREAprev/AREApost | 
| 148 | c update SItr accordingly | 
| 149 | SItracer(i,j,bi,bj,iTr)=SItracer(i,j,bi,bj,iTr)*expandFact | 
| 150 | &                      +SItrExpand(i,j)*(1. _d 0 - expandFact) | 
| 151 | ENDDO | 
| 152 | ENDDO | 
| 153 | endif | 
| 154 | c 2) very ice tracer processes | 
| 155 | c ============================ | 
| 156 | if (SItrName(iTr).EQ.'age') then | 
| 157 | c age tracer: grow old as time passes by | 
| 158 | DO J=1,sNy | 
| 159 | DO I=1,sNx | 
| 160 | if (( (SItrHEFF(i,j,bi,bj,5).GT.0. _d 0).AND.(SItrMate(iTr) | 
| 161 | &     .EQ.'HEFF') ).OR.( (SItrAREA(i,j,bi,bj,3).GT.0. _d 0).AND. | 
| 162 | &     (SItrMate(iTr).EQ.'AREA') )) then | 
| 163 | SItracer(i,j,bi,bj,iTr)= | 
| 164 | &      SItracer(i,j,bi,bj,iTr)+SEAICE_deltaTtherm | 
| 165 | else | 
| 166 | SItracer(i,j,bi,bj,iTr)=0. _d 0 | 
| 167 | endif | 
| 168 | ENDDO | 
| 169 | ENDDO | 
| 170 | elseif (SItrName(iTr).EQ.'salinity') then | 
| 171 | c salinity tracer: no specific process | 
| 172 | elseif (SItrName(iTr).EQ.'one') then | 
| 173 | c "ice concentration" tracer: no specific process | 
| 174 | elseif (SItrName(iTr).EQ.'ridge') then | 
| 175 | c simple, made up, ice surface roughness index prototype | 
| 176 | DO J=1,sNy | 
| 177 | DO I=1,sNx | 
| 178 | c ridging increases roughness | 
| 179 | SItracer(i,j,bi,bj,iTr)=SItracer(i,j,bi,bj,iTr)+ | 
| 180 | &    MAX(0. _d 0, SItrAREA(i,j,bi,bj,1)-SItrAREA(i,j,bi,bj,2)) | 
| 181 | c ice melt reduces ridges/roughness | 
| 182 | HEFFprev=SItrHEFF(i,j,bi,bj,1) | 
| 183 | HEFFpost=SItrHEFF(i,j,bi,bj,4) | 
| 184 | tmpscal1=1. _d 0 | 
| 185 | if (HEFFprev.GT.HEFFpost) tmpscal1=HEFFpost/HEFFprev | 
| 186 | SItracer(i,j,bi,bj,iTr)=SItracer(i,j,bi,bj,iTr)*tmpscal1 | 
| 187 | ENDDO | 
| 188 | ENDDO | 
| 189 | endif | 
| 190 | c 3) ice-ocean tracer exchange/mapping to external variables | 
| 191 | c ========================================================== | 
| 192 | #ifdef ALLOW_DIAGNOSTICS | 
| 193 | if (SItrMate(iTr).EQ.'HEFF') then | 
| 194 | WRITE(diagName,'(A4,I2.2,A2)') 'SItr',iTr,'Fx' | 
| 195 | tmpscal1=-ONE/SEAICE_deltaTtherm*SEAICE_rhoIce | 
| 196 | CALL DIAGNOSTICS_SCALE_FILL(SItrBucket(1-OLx,1-OLy,bi,bj,iTr), | 
| 197 | &   tmpscal1, 1, diagName,0,1,2,bi,bj,myThid) | 
| 198 | endif | 
| 199 | #endif | 
| 200 |  | 
| 201 | if ( (SItrName(iTr).EQ.'salinity').AND. | 
| 202 | &     (SEAICE_salinityTracer) ) then | 
| 203 | c salinity tracer: salt flux | 
| 204 | DO J=1,sNy | 
| 205 | DO I=1,sNx | 
| 206 | saltFlux(I,J,bi,bj) = - SItrBucket(i,j,bi,bj,iTr) | 
| 207 | &      *HEFFM(I,J,bi,bj)/SEAICE_deltaTtherm*SEAICE_rhoIce | 
| 208 | c note: at this point of the time step, that is the correct sign | 
| 209 | #ifdef ALLOW_SALT_PLUME | 
| 210 | c should work for both constant and variable ice salinity -- to be tested | 
| 211 | saltPlumeFlux(I,J,bi,bj) = MAX(ZERO,saltFlux(I,J,bi,bj)) | 
| 212 | &      *SPsalFRAC*(salt(I,j,ks,bi,bj)-SItrFromOcean(i,j)) | 
| 213 | #endif | 
| 214 | ENDDO | 
| 215 | ENDDO | 
| 216 | endif | 
| 217 |  | 
| 218 | DO J=1,sNy | 
| 219 | DO I=1,sNx | 
| 220 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 221 | DIAGarray(I,J,4+(iTr-1)*5) = - SItrBucket(i,j,bi,bj,iTr) | 
| 222 | &  *HEFFM(I,J,bi,bj)/SEAICE_deltaTtherm*SEAICE_rhoIce | 
| 223 | #endif | 
| 224 | c empty bucket | 
| 225 | SItrBucket(i,j,bi,bj,iTr)=0. _d 0 | 
| 226 | ENDDO | 
| 227 | ENDDO | 
| 228 |  | 
| 229 | c TAF? elseif (SItrMate(iTr).EQ.'AREA') then | 
| 230 |  | 
| 231 | c 4) diagnostics | 
| 232 | c ============== | 
| 233 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 234 | if (SItrMate(iTr).EQ.'HEFF') then | 
| 235 | DO J=1,sNy | 
| 236 | DO I=1,sNx | 
| 237 | HEFFpost=SItrHEFF(i,j,bi,bj,5) | 
| 238 | DIAGarray(I,J,1+(iTr-1)*5) = SItracer(i,j,bi,bj,iTr) | 
| 239 | DIAGarray(I,J,2+(iTr-1)*5) = SItracer(i,j,bi,bj,iTr)*HEFFpost | 
| 240 | c DIAGarray(:,:,3) is the term of comparison for DIAGarray(:,:,2) | 
| 241 | if (SItrName(iTr).EQ.'salinity') then | 
| 242 | DIAGarray(I,J,3+(iTr-1)*5) = HSALT(i,j,bi,bj)/SEAICE_rhoIce | 
| 243 | elseif (SItrName(iTr).EQ.'one') then | 
| 244 | DIAGarray(I,J,3+(iTr-1)*5) = HEFFpost | 
| 245 | endif | 
| 246 | c DIAGarray(:,:,4) allows check of conservation : del(SItrBucket)+del(SItr*HEFF)=0. over do_phys | 
| 247 | c DIAGarray(:,:,5) is the tracer flux from the ocean (<0 incr. ocean tracer) | 
| 248 | ENDDO | 
| 249 | ENDDO | 
| 250 | else | 
| 251 | DO J=1,sNy | 
| 252 | DO I=1,sNx | 
| 253 | AREApost=SItrAREA(i,j,bi,bj,3) | 
| 254 | DIAGarray(I,J,1+(iTr-1)*5) = SItracer(i,j,bi,bj,iTr) | 
| 255 | DIAGarray(I,J,2+(iTr-1)*5) = SItracer(i,j,bi,bj,iTr)*AREApost | 
| 256 | ENDDO | 
| 257 | ENDDO | 
| 258 | endif | 
| 259 | #endif | 
| 260 | ENDDO | 
| 261 | #ifdef ALLOW_SITRACER_DEBUG_DIAG | 
| 262 | c     CALL DIAGNOSTICS_FILL(DIAGarray,'UDIAG1  ',0,Nr,3,bi,bj,myThid) | 
| 263 | #endif | 
| 264 | ENDDO | 
| 265 | ENDDO | 
| 266 |  | 
| 267 | #endif /* ALLOW_SITRACER */ | 
| 268 |  | 
| 269 | RETURN | 
| 270 | END |