1 |
C $Header: /u/gcmpack/MITgcm/pkg/diagnostics/diagnostics_out.F,v 1.60 2013/01/13 22:46:38 jmc Exp $ |
2 |
C $Name: $ |
3 |
|
4 |
#include "DIAG_OPTIONS.h" |
5 |
|
6 |
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |
7 |
CBOP 0 |
8 |
C !ROUTINE: DIAGNOSTICS_OUT |
9 |
|
10 |
C !INTERFACE: |
11 |
SUBROUTINE DIAGNOSTICS_OUT( |
12 |
I listId, |
13 |
I myTime, |
14 |
I myIter, |
15 |
I myThid ) |
16 |
|
17 |
C !DESCRIPTION: |
18 |
C Write output for diagnostics fields. |
19 |
|
20 |
C !USES: |
21 |
IMPLICIT NONE |
22 |
#include "SIZE.h" |
23 |
#include "EEPARAMS.h" |
24 |
#include "PARAMS.h" |
25 |
#include "GRID.h" |
26 |
#include "DIAGNOSTICS_SIZE.h" |
27 |
#include "DIAGNOSTICS.h" |
28 |
|
29 |
INTEGER NrMax |
30 |
PARAMETER( NrMax = numLevels ) |
31 |
|
32 |
C !INPUT PARAMETERS: |
33 |
C listId :: Diagnostics list number being written |
34 |
C myIter :: current iteration number |
35 |
C myTime :: current time of simulation (s) |
36 |
C myThid :: my Thread Id number |
37 |
_RL myTime |
38 |
INTEGER listId, myIter, myThid |
39 |
CEOP |
40 |
|
41 |
C !FUNCTIONS: |
42 |
INTEGER ILNBLNK |
43 |
EXTERNAL ILNBLNK |
44 |
|
45 |
C !LOCAL VARIABLES: |
46 |
C i,j,k :: loop indices |
47 |
C bi,bj :: tile indices |
48 |
C lm :: loop index (averageCycle) |
49 |
C md :: field number in the list "listId". |
50 |
C ndId :: diagnostics Id number (in available diagnostics list) |
51 |
C ip :: diagnostics pointer to storage array |
52 |
C im :: counter-mate pointer to storage array |
53 |
C mate :: counter mate Id number (in available diagnostics list) |
54 |
C mDbl :: processing mate Id number (in case processing requires 2 diags) |
55 |
C mVec :: vector mate Id number |
56 |
C ppFld :: post-processed diag or not (=0): =1 stored in qtmp1 ; =2 in qtmp2 |
57 |
C isComputed :: previous post-processed diag (still available in qtmp) |
58 |
C nLevOutp :: number of levels to write in output file |
59 |
C |
60 |
C-- COMMON /LOCAL_DIAGNOSTICS_OUT/ local common block (for multi-threaded) |
61 |
C qtmp1 :: temporary array; used to store a copy of diag. output field. |
62 |
C qtmp2 :: temporary array; used to store a copy of a 2nd diag. field. |
63 |
C- Note: local common block no longer needed. |
64 |
c COMMON /LOCAL_DIAGNOSTICS_OUT/ qtmp1 |
65 |
_RL qtmp1(1-OLx:sNx+OLx,1-OLy:sNy+OLy,NrMax,nSx,nSy) |
66 |
_RL qtmp2(1-OLx:sNx+OLx,1-OLy:sNy+OLy,NrMax,nSx,nSy) |
67 |
|
68 |
INTEGER i, j, k, lm |
69 |
INTEGER bi, bj |
70 |
INTEGER md, ndId, nn, ip, im |
71 |
INTEGER mate, mDbl, mVec |
72 |
INTEGER ppFld, isComputed |
73 |
CHARACTER*10 gcode |
74 |
_RL undefRL |
75 |
INTEGER nLevOutp, kLev |
76 |
|
77 |
INTEGER iLen |
78 |
INTEGER ioUnit |
79 |
CHARACTER*(MAX_LEN_FNAM) fn |
80 |
CHARACTER*(MAX_LEN_MBUF) suff |
81 |
CHARACTER*(MAX_LEN_MBUF) msgBuf |
82 |
INTEGER prec, nRec, nTimRec |
83 |
_RL timeRec(2) |
84 |
_RL tmpLoc |
85 |
#ifdef ALLOW_MDSIO |
86 |
LOGICAL glf |
87 |
#endif |
88 |
#ifdef ALLOW_MNC |
89 |
CHARACTER*(MAX_LEN_FNAM) diag_mnc_bn |
90 |
#endif /* ALLOW_MNC */ |
91 |
|
92 |
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |
93 |
|
94 |
C--- set file properties |
95 |
ioUnit= standardMessageUnit |
96 |
undefRL = misValFlt(listId) |
97 |
|
98 |
WRITE(suff,'(I10.10)') myIter |
99 |
iLen = ILNBLNK(fnames(listId)) |
100 |
WRITE( fn, '(A,A,A)' ) fnames(listId)(1:iLen),'.',suff(1:10) |
101 |
C- for now, if integrate vertically, output field has just 1 level: |
102 |
nLevOutp = nlevels(listId) |
103 |
IF ( fflags(listId)(2:2).EQ.'I' ) nLevOutp = 1 |
104 |
|
105 |
C-- Set time information: |
106 |
IF ( freq(listId).LT.0. ) THEN |
107 |
C- Snap-shot: store a unique time (which is consistent with State-Var timing) |
108 |
nTimRec = 1 |
109 |
timeRec(1) = myTime |
110 |
ELSE |
111 |
C- Time-average: store the 2 edges of the time-averaging interval. |
112 |
C this time is consitent with intermediate Var (i.e., non-state, e.g, flux, |
113 |
C tendencies) timing. For State-Var, this is shifted by + halt time-step. |
114 |
nTimRec = 2 |
115 |
|
116 |
C- end of time-averaging interval: |
117 |
timeRec(2) = myTime |
118 |
|
119 |
C- begining of time-averaging interval: |
120 |
c timeRec(1) = myTime - freq(listId) |
121 |
C a) find the time of the previous multiple of output freq: |
122 |
timeRec(1) = myTime-deltaTClock*0.5 _d 0 |
123 |
timeRec(1) = (timeRec(1)-phase(listId))/freq(listId) |
124 |
i = INT( timeRec(1) ) |
125 |
IF ( timeRec(1).LT.0. ) THEN |
126 |
tmpLoc = FLOAT(i) |
127 |
IF ( timeRec(1).NE.tmpLoc ) i = i - 1 |
128 |
ENDIF |
129 |
timeRec(1) = phase(listId) + freq(listId)*FLOAT(i) |
130 |
c if ( listId.eq.2 ) write(0,*) 'f',i,timeRec(1)/deltaTClock |
131 |
timeRec(1) = MAX( timeRec(1), startTime ) |
132 |
|
133 |
C b) round off to nearest multiple of time-step: |
134 |
timeRec(1) = (timeRec(1)-baseTime)/deltaTClock |
135 |
i = NINT( timeRec(1) ) |
136 |
C if just half way, NINT will return the next time-step: correct this |
137 |
tmpLoc = FLOAT(i) - 0.5 _d 0 |
138 |
IF ( timeRec(1).EQ.tmpLoc ) i = i - 1 |
139 |
timeRec(1) = baseTime + deltaTClock*FLOAT(i) |
140 |
c if ( listId.eq.2 ) write(0,*) i,timeRec(1)/deltaTClock |
141 |
ENDIF |
142 |
C-- Convert time to iteration number (debug) |
143 |
c DO i=1,nTimRec |
144 |
c timeRec(i) = timeRec(i)/deltaTClock |
145 |
c ENDDO |
146 |
|
147 |
C-- Place the loop on lm (= averagePeriod) outside the loop on md (= field): |
148 |
DO lm=1,averageCycle(listId) |
149 |
|
150 |
#ifdef ALLOW_MNC |
151 |
IF (useMNC .AND. diag_mnc) THEN |
152 |
CALL DIAGNOSTICS_MNC_SET( |
153 |
I nLevOutp, listId, lm, |
154 |
O diag_mnc_bn, |
155 |
I undefRL, myTime, myIter, myThid ) |
156 |
ENDIF |
157 |
#endif /* ALLOW_MNC */ |
158 |
|
159 |
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |
160 |
|
161 |
isComputed = 0 |
162 |
DO md = 1,nfields(listId) |
163 |
ndId = jdiag(md,listId) |
164 |
gcode = gdiag(ndId)(1:10) |
165 |
mate = 0 |
166 |
mVec = 0 |
167 |
mDbl = 0 |
168 |
ppFld = 0 |
169 |
IF ( gcode(5:5).EQ.'C' ) THEN |
170 |
C- Check for Mate of a Counter Diagnostic |
171 |
mate = hdiag(ndId) |
172 |
ELSEIF ( gcode(5:5).EQ.'P' ) THEN |
173 |
ppFld = 1 |
174 |
IF ( gdiag(hdiag(ndId))(5:5).EQ.'P' ) ppFld = 2 |
175 |
C- Also load the mate (if stored) for Post-Processing |
176 |
nn = ndId |
177 |
DO WHILE ( gdiag(nn)(5:5).EQ.'P' ) |
178 |
nn = hdiag(nn) |
179 |
ENDDO |
180 |
IF ( mdiag(md,listId).NE.0 ) mDbl = hdiag(nn) |
181 |
c write(0,*) ppFld,' ndId=', ndId, nn, mDbl, isComputed |
182 |
ELSEIF ( gcode(1:1).EQ.'U' .OR. gcode(1:1).EQ.'V' ) THEN |
183 |
C- Check for Mate of a Vector Diagnostic |
184 |
mVec = hdiag(ndId) |
185 |
ENDIF |
186 |
IF ( idiag(md,listId).NE.0 .AND. gcode(5:5).NE.'D' ) THEN |
187 |
C-- Start processing 1 Fld : |
188 |
|
189 |
ip = ABS(idiag(md,listId)) + kdiag(ndId)*(lm-1) |
190 |
im = mdiag(md,listId) |
191 |
IF (mate.GT.0) im = im + kdiag(mate)*(lm-1) |
192 |
IF (mDbl.GT.0) im = im + kdiag(mDbl)*(lm-1) |
193 |
IF (mVec.GT.0) im = im + kdiag(mVec)*(lm-1) |
194 |
|
195 |
IF ( ppFld.EQ.2 .AND. isComputed.EQ.hdiag(ndId) ) THEN |
196 |
C- Post-Processed diag from an other Post-Processed diag -and- |
197 |
C both of them have just been calculated and are still stored in qtmp: |
198 |
C => skip computation and just write qtmp2 |
199 |
IF ( debugLevel.GE.debLevB .AND. myThid.EQ.1 ) THEN |
200 |
WRITE(ioUnit,'(A,I6,3A,I6)') |
201 |
& ' get Post-Proc. Diag # ', ndId, ' ', cdiag(ndId), |
202 |
& ' from previous computation of Diag # ', isComputed |
203 |
ENDIF |
204 |
isComputed = 0 |
205 |
ELSEIF ( ndiag(ip,1,1).EQ.0 ) THEN |
206 |
C- Empty diagnostics case : |
207 |
isComputed = 0 |
208 |
|
209 |
_BEGIN_MASTER( myThid ) |
210 |
WRITE(msgBuf,'(A,I10)') |
211 |
& '- WARNING - from DIAGNOSTICS_OUT at iter=', myIter |
212 |
CALL PRINT_MESSAGE( msgBuf, errorMessageUnit, |
213 |
& SQUEEZE_RIGHT, myThid) |
214 |
WRITE(msgBuf,'(A,I6,3A,I4,2A)') |
215 |
& '- WARNING - diag.#',ndId, ' : ',flds(md,listId), |
216 |
& ' (#',md,' ) in outp.Stream: ',fnames(listId) |
217 |
CALL PRINT_MESSAGE( msgBuf, errorMessageUnit, |
218 |
& SQUEEZE_RIGHT, myThid) |
219 |
IF ( averageCycle(listId).GT.1 ) THEN |
220 |
WRITE(msgBuf,'(A,2(I3,A))') |
221 |
& '- WARNING - has not been filled (ndiag(lm=',lm,')=', |
222 |
& ndiag(ip,1,1), ' )' |
223 |
ELSE |
224 |
WRITE(msgBuf,'(A,2(I3,A))') |
225 |
& '- WARNING - has not been filled (ndiag=', |
226 |
& ndiag(ip,1,1), ' )' |
227 |
ENDIF |
228 |
CALL PRINT_MESSAGE( msgBuf, errorMessageUnit, |
229 |
& SQUEEZE_RIGHT, myThid) |
230 |
WRITE(msgBuf,'(A)') |
231 |
& 'WARNING DIAGNOSTICS_OUT => write ZEROS instead' |
232 |
CALL PRINT_MESSAGE( msgBuf, errorMessageUnit, |
233 |
& SQUEEZE_RIGHT, myThid) |
234 |
_END_MASTER( myThid ) |
235 |
DO bj = myByLo(myThid), myByHi(myThid) |
236 |
DO bi = myBxLo(myThid), myBxHi(myThid) |
237 |
DO k = 1,nLevOutp |
238 |
DO j = 1-OLy,sNy+OLy |
239 |
DO i = 1-OLx,sNx+OLx |
240 |
qtmp1(i,j,k,bi,bj) = 0. _d 0 |
241 |
ENDDO |
242 |
ENDDO |
243 |
ENDDO |
244 |
ENDDO |
245 |
ENDDO |
246 |
|
247 |
ELSE |
248 |
C- diagnostics is not empty : |
249 |
isComputed = 0 |
250 |
|
251 |
IF ( debugLevel.GE.debLevB .AND. myThid.EQ.1 ) THEN |
252 |
IF ( ppFld.GE.1 ) THEN |
253 |
WRITE(ioUnit,'(A,I6,7A,I8,2A)') |
254 |
& ' Post-Processing Diag # ', ndId, ' ', cdiag(ndId), |
255 |
& ' Parms: ',gdiag(ndId) |
256 |
IF ( mDbl.EQ.0 ) THEN |
257 |
WRITE(ioUnit,'(2(3A,I6,A,I8))') ' from diag: ', |
258 |
& cdiag(nn), ' (#', nn, ') Cnt=', ndiag(ip,1,1) |
259 |
ELSE |
260 |
WRITE(ioUnit,'(2(3A,I6,A,I8))') ' from diag: ', |
261 |
& cdiag(nn), ' (#', nn, ') Cnt=', ndiag(ip,1,1), |
262 |
& ' and diag: ', |
263 |
& cdiag(mDbl),' (#',mDbl,') Cnt=',ndiag(im,1,1) |
264 |
ENDIF |
265 |
ELSE |
266 |
WRITE(ioUnit,'(A,I6,3A,I8,2A)') |
267 |
& ' Computing Diagnostic # ', ndId, ' ', cdiag(ndId), |
268 |
& ' Counter:',ndiag(ip,1,1),' Parms: ',gdiag(ndId) |
269 |
ENDIF |
270 |
IF ( mate.GT.0 ) THEN |
271 |
WRITE(ioUnit,'(3A,I6,2A)') |
272 |
& ' use Counter Mate for ', cdiag(ndId), |
273 |
& ' Diagnostic # ',mate, ' ', cdiag(mate) |
274 |
ELSEIF ( mVec.GT.0 ) THEN |
275 |
IF ( im.GT.0 .AND. ndiag(MAX(1,im),1,1).GT.0 ) THEN |
276 |
WRITE(ioUnit,'(3A,I6,3A)') |
277 |
& ' Vector Mate for ', cdiag(ndId), |
278 |
& ' Diagnostic # ',mVec, ' ', cdiag(mVec), |
279 |
& ' exists ' |
280 |
ELSE |
281 |
WRITE(ioUnit,'(3A,I6,3A)') |
282 |
& ' Vector Mate for ', cdiag(ndId), |
283 |
& ' Diagnostic # ',mVec, ' ', cdiag(mVec), |
284 |
& ' not enabled' |
285 |
ENDIF |
286 |
ENDIF |
287 |
ENDIF |
288 |
|
289 |
IF ( fflags(listId)(2:2).EQ.' ' ) THEN |
290 |
C- get only selected levels: |
291 |
DO bj = myByLo(myThid), myByHi(myThid) |
292 |
DO bi = myBxLo(myThid), myBxHi(myThid) |
293 |
DO k = 1,nlevels(listId) |
294 |
kLev = NINT(levs(k,listId)) |
295 |
CALL DIAGNOSTICS_GET_DIAG( |
296 |
I kLev, undefRL, |
297 |
O qtmp1(1-OLx,1-OLy,k,bi,bj), |
298 |
I ndId, mate, ip, im, bi, bj, myThid ) |
299 |
ENDDO |
300 |
ENDDO |
301 |
ENDDO |
302 |
IF ( mDbl.GT.0 ) THEN |
303 |
DO bj = myByLo(myThid), myByHi(myThid) |
304 |
DO bi = myBxLo(myThid), myBxHi(myThid) |
305 |
DO k = 1,nlevels(listId) |
306 |
kLev = NINT(levs(k,listId)) |
307 |
CALL DIAGNOSTICS_GET_DIAG( |
308 |
I kLev, undefRL, |
309 |
O qtmp2(1-OLx,1-OLy,k,bi,bj), |
310 |
I mDbl, 0, im, 0, bi, bj, myThid ) |
311 |
ENDDO |
312 |
ENDDO |
313 |
ENDDO |
314 |
ENDIF |
315 |
ELSE |
316 |
C- get all the levels (for vertical post-processing) |
317 |
DO bj = myByLo(myThid), myByHi(myThid) |
318 |
DO bi = myBxLo(myThid), myBxHi(myThid) |
319 |
CALL DIAGNOSTICS_GET_DIAG( |
320 |
I 0, undefRL, |
321 |
O qtmp1(1-OLx,1-OLy,1,bi,bj), |
322 |
I ndId, mate, ip, im, bi, bj, myThid ) |
323 |
ENDDO |
324 |
ENDDO |
325 |
IF ( mDbl.GT.0 ) THEN |
326 |
DO bj = myByLo(myThid), myByHi(myThid) |
327 |
DO bi = myBxLo(myThid), myBxHi(myThid) |
328 |
CALL DIAGNOSTICS_GET_DIAG( |
329 |
I 0, undefRL, |
330 |
O qtmp2(1-OLx,1-OLy,1,bi,bj), |
331 |
I mDbl, 0, im, 0, bi, bj, myThid ) |
332 |
ENDDO |
333 |
ENDDO |
334 |
ENDIF |
335 |
ENDIF |
336 |
|
337 |
C----------------------------------------------------------------------- |
338 |
C-- Apply specific post-processing (e.g., interpolate) before output |
339 |
C----------------------------------------------------------------------- |
340 |
IF ( fflags(listId)(2:2).EQ.'P' ) THEN |
341 |
C- Do vertical interpolation: |
342 |
IF ( fluidIsAir ) THEN |
343 |
C jmc: for now, this can only work in an atmospheric set-up (fluidIsAir); |
344 |
CALL DIAGNOSTICS_INTERP_VERT( |
345 |
I listId, md, ndId, ip, im, lm, |
346 |
U qtmp1, qtmp2, |
347 |
I undefRL, myTime, myIter, myThid ) |
348 |
ELSE |
349 |
WRITE(msgBuf,'(2A)') 'DIAGNOSTICS_OUT: ', |
350 |
& 'INTERP_VERT not allowed in this config' |
351 |
CALL PRINT_ERROR( msgBuf , myThid ) |
352 |
STOP 'ABNORMAL END: S/R DIAGNOSTICS_OUT' |
353 |
ENDIF |
354 |
ENDIF |
355 |
IF ( fflags(listId)(2:2).EQ.'I' ) THEN |
356 |
C- Integrate vertically: for now, output field has just 1 level: |
357 |
CALL DIAGNOSTICS_SUM_LEVELS( |
358 |
I listId, md, ndId, ip, im, lm, |
359 |
U qtmp1, |
360 |
I undefRL, myTime, myIter, myThid ) |
361 |
ENDIF |
362 |
IF ( ppFld.GE.1 ) THEN |
363 |
C- Do Post-Processing: |
364 |
IF ( flds(md,listId).EQ.'PhiVEL ' |
365 |
& .OR. flds(md,listId).EQ.'PsiVEL ' |
366 |
& ) THEN |
367 |
CALL DIAGNOSTICS_CALC_PHIVEL( |
368 |
I listId, md, ndId, ip, im, lm, |
369 |
I NrMax, |
370 |
U qtmp1, qtmp2, |
371 |
I myTime, myIter, myThid ) |
372 |
isComputed = ndId |
373 |
ELSE |
374 |
WRITE(msgBuf,'(2A)') 'DIAGNOSTICS_OUT: ', |
375 |
& 'unknown Processing method for diag="',cdiag(ndId),'"' |
376 |
CALL PRINT_ERROR( msgBuf , myThid ) |
377 |
STOP 'ABNORMAL END: S/R DIAGNOSTICS_OUT' |
378 |
ENDIF |
379 |
ENDIF |
380 |
|
381 |
C-- End of empty diag / not-empty diag block |
382 |
ENDIF |
383 |
|
384 |
C-- Ready to write field "md", element "lm" in averageCycle(listId) |
385 |
|
386 |
C- write to binary file, using MDSIO pkg: |
387 |
IF ( diag_mdsio ) THEN |
388 |
c nRec = lm + (md-1)*averageCycle(listId) |
389 |
nRec = md + (lm-1)*nfields(listId) |
390 |
C default precision for output files |
391 |
prec = writeBinaryPrec |
392 |
C fFlag(1)=R(or D): force it to be 32-bit(or 64) precision |
393 |
IF ( fflags(listId)(1:1).EQ.'R' ) prec = precFloat32 |
394 |
IF ( fflags(listId)(1:1).EQ.'D' ) prec = precFloat64 |
395 |
C a hack not to write meta files now: pass -nRec < 0 to MDS_WRITE S/R |
396 |
IF ( ppFld.LE.1 ) THEN |
397 |
CALL WRITE_REC_LEV_RL( |
398 |
I fn, prec, |
399 |
I NrMax, 1, nLevOutp, |
400 |
I qtmp1, -nRec, myIter, myThid ) |
401 |
ELSE |
402 |
CALL WRITE_REC_LEV_RL( |
403 |
I fn, prec, |
404 |
I NrMax, 1, nLevOutp, |
405 |
I qtmp2, -nRec, myIter, myThid ) |
406 |
ENDIF |
407 |
ENDIF |
408 |
|
409 |
#ifdef ALLOW_MNC |
410 |
IF (useMNC .AND. diag_mnc) THEN |
411 |
IF ( ppFld.LE.1 ) THEN |
412 |
CALL DIAGNOSTICS_MNC_OUT( |
413 |
I NrMax, nLevOutp, listId, ndId, mate, |
414 |
I diag_mnc_bn, qtmp1, |
415 |
I undefRL, myTime, myIter, myThid ) |
416 |
ELSE |
417 |
CALL DIAGNOSTICS_MNC_OUT( |
418 |
I NrMax, nLevOutp, listId, ndId, mate, |
419 |
I diag_mnc_bn, qtmp2, |
420 |
I undefRL, myTime, myIter, myThid ) |
421 |
ENDIF |
422 |
ENDIF |
423 |
#endif /* ALLOW_MNC */ |
424 |
|
425 |
C-- end of Processing Fld # md |
426 |
ENDIF |
427 |
ENDDO |
428 |
|
429 |
C-- end loop on lm counter (= averagePeriod) |
430 |
ENDDO |
431 |
|
432 |
#ifdef ALLOW_MDSIO |
433 |
IF (diag_mdsio) THEN |
434 |
C- Note: temporary: since it is a pain to add more arguments to |
435 |
C all MDSIO S/R, uses instead this specific S/R to write only |
436 |
C meta files but with more informations in it. |
437 |
glf = globalFiles |
438 |
nRec = averageCycle(listId)*nfields(listId) |
439 |
CALL MDS_WR_METAFILES(fn, prec, glf, .FALSE., |
440 |
& 0, 0, nLevOutp, ' ', |
441 |
& nfields(listId), flds(1,listId), |
442 |
& nTimRec, timeRec, undefRL, |
443 |
& nRec, myIter, myThid) |
444 |
ENDIF |
445 |
#endif /* ALLOW_MDSIO */ |
446 |
|
447 |
RETURN |
448 |
END |
449 |
|
450 |
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----| |