/[MITgcm]/MITgcm/pkg/diagnostics/diagnostics_fract_fill.F
ViewVC logotype

Annotation of /MITgcm/pkg/diagnostics/diagnostics_fract_fill.F

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.4 - (hide annotations) (download)
Mon Jul 31 16:26:32 2006 UTC (17 years, 10 months ago) by jmc
Branch: MAIN
CVS Tags: mitgcm_mapl_00, checkpoint58u_post, checkpoint58w_post, checkpoint58r_post, checkpoint58n_post, checkpoint58x_post, checkpoint58t_post, checkpoint58q_post, checkpoint59e, checkpoint59d, checkpoint59g, checkpoint59f, checkpoint59a, checkpoint59c, checkpoint59b, checkpoint59m, checkpoint59l, checkpoint59i, checkpoint59h, checkpoint59k, checkpoint59j, checkpoint59, checkpoint58o_post, checkpoint58y_post, checkpoint58v_post, checkpoint58s_post, checkpoint58p_post
Changes since 1.3: +3 -3 lines
safer in multi-threaded environment

1 jmc 1.4 C $Header: /u/gcmpack/MITgcm/pkg/diagnostics/diagnostics_fract_fill.F,v 1.3 2006/06/05 18:17:22 jmc Exp $
2 jmc 1.1 C $Name: $
3    
4     #include "DIAG_OPTIONS.h"
5    
6     CBOP
7     C !ROUTINE: DIAGNOSTICS_FRACT_FILL
8     C !INTERFACE:
9     SUBROUTINE DIAGNOSTICS_FRACT_FILL(
10 jmc 1.2 I inpFld, fractFld, scaleFact, power, chardiag,
11     I kLev, nLevs, bibjFlg, biArg, bjArg, myThid)
12 jmc 1.1
13     C !DESCRIPTION:
14     C***********************************************************************
15     C Wrapper routine to increment the diagnostics arrays with a field
16 jmc 1.2 C using a scaling factor & square option (power=2)
17     C and using a fraction-weight (assumed to be the counter-mate
18     C of the current diagnostics)
19 jmc 1.1 C Note: 1) fraction-weight has to correspond to the diagnostics
20     C counter-mate (filled independently with a call to
21     C DIAGNOSTICS_FILL)
22     C 2) assume for now that inpFld & fractFld are both _RL and
23     C have the same horizontal shape (overlap,bi,bj ...)
24     C***********************************************************************
25     C !USES:
26     IMPLICIT NONE
27    
28     C == Global variables ===
29     #include "EEPARAMS.h"
30     #include "SIZE.h"
31     #include "DIAGNOSTICS_SIZE.h"
32     #include "DIAGNOSTICS.h"
33    
34     C !INPUT PARAMETERS:
35     C***********************************************************************
36     C Arguments Description
37     C ----------------------
38     C inpFld :: Field to increment diagnostics array
39     C fractFld :: fraction used for weighted average diagnostics
40     C scaleFact :: scaling factor
41 jmc 1.2 C power :: option to fill-in with the field square (power=2)
42 jmc 1.1 C chardiag :: Character expression for diag to fill
43     C kLev :: Integer flag for vertical levels:
44     C > 0 (any integer): WHICH single level to increment in qdiag.
45     C 0,-1 to increment "nLevs" levels in qdiag,
46     C 0 : fill-in in the same order as the input array
47     C -1: fill-in in reverse order.
48     C nLevs :: indicates Number of levels of the input field array
49     C (whether to fill-in all the levels (kLev<1) or just one (kLev>0))
50     C bibjFlg :: Integer flag to indicate instructions for bi bj loop
51     C 0 indicates that the bi-bj loop must be done here
52     C 1 indicates that the bi-bj loop is done OUTSIDE
53     C 2 indicates that the bi-bj loop is done OUTSIDE
54     C AND that we have been sent a local array (with overlap regions)
55     C 3 indicates that the bi-bj loop is done OUTSIDE
56     C AND that we have been sent a local array
57     C AND that the array has no overlap region (interior only)
58     C NOTE - bibjFlg can be NEGATIVE to indicate not to increment counter
59     C biArg :: X-direction tile number - used for bibjFlg=1-3
60     C bjArg :: Y-direction tile number - used for bibjFlg=1-3
61     C myThid :: my thread Id number
62     C***********************************************************************
63     C NOTE: User beware! If a local (1 tile only) array
64     C is sent here, bibjFlg MUST NOT be set to 0
65     C or there will be out of bounds problems!
66     C***********************************************************************
67     _RL inpFld(*)
68     _RL fractFld(*)
69     _RL scaleFact
70 jmc 1.2 INTEGER power
71 jmc 1.1 CHARACTER*8 chardiag
72     INTEGER kLev, nLevs, bibjFlg, biArg, bjArg
73     INTEGER myThid
74     CEOP
75    
76     C !LOCAL VARIABLES:
77     C ndId :: diagnostic Id number (in available diagnostics list)
78     C ===============
79     INTEGER m, n, j, k, l, bi, bj
80     INTEGER ndId, ipt, iSp
81     INTEGER region2fill(0:nRegions)
82     INTEGER mate, nLevFract
83     CHARACTER*8 parms1
84     CHARACTER*(MAX_LEN_MBUF) msgBuf
85    
86     IF ( bibjFlg.EQ.0 ) THEN
87 jmc 1.4 bi = myBxLo(myThid)
88     bj = myByLo(myThid)
89 jmc 1.1 ELSE
90     bi = biArg
91     bj = bjArg
92     ENDIF
93     C-- 2D/3D Diagnostics :
94     C Run through list of active diagnostics to make sure
95     C we are trying to fill a valid diagnostic
96     DO n=1,nlists
97     DO m=1,nActive(n)
98     IF ( chardiag.EQ.flds(m,n) .AND. idiag(m,n).GT.0 ) THEN
99     ipt = idiag(m,n)
100     IF ( ndiag(ipt,bi,bj).GE.0 ) THEN
101     ndId = jdiag(m,n)
102 jmc 1.3 ipt = ipt + pdiag(n,bi,bj)*kdiag(ndId)
103 jmc 1.1 C- check for a counter-mate:
104     mate = 0
105     parms1 = gdiag(ndId)(1:8)
106     IF ( parms1(5:5).EQ.'C' ) READ(parms1,'(5X,I3)') mate
107     IF ( mdiag(m,n).EQ.0 ) mate = 0
108     IF ( mate.LE.0 ) THEN
109     WRITE(msgBuf,'(2A)') 'DIAGNOSTICS_FRACT_FILL: ',
110     & 'did not find a valid counter-mate'
111     CALL PRINT_ERROR( msgBuf , myThid )
112     WRITE(msgBuf,'(2A,I4,2A)') 'DIAGNOSTICS_FRACT_FILL: ',
113     & 'for diag(#',ndId,' ) :', chardiag
114     CALL PRINT_ERROR( msgBuf , myThid )
115     STOP 'ABNORMAL END: S/R DIAGNOSTICS_FRACT_FILL'
116     ENDIF
117     C- set the nb of levels of fraction-weight field (not > kdiag(mate))
118     nLevFract = MIN(nLevs,kdiag(mate))
119     C- diagnostic is valid & active, has a counter-mate, do the filling:
120     CALL DIAGNOSTICS_FILL_FIELD(
121 jmc 1.2 I inpFld, fractFld, scaleFact, power, nLevFract,
122     I ndId, ipt, kLev, nLevs,
123     I bibjFlg, biArg, bjArg, myThid )
124 jmc 1.1 ENDIF
125     ENDIF
126     ENDDO
127     ENDDO
128    
129     C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|
130     C-- Global/Regional Statistics :
131    
132     C Run through list of active statistics-diagnostics to make sure
133     C we are trying to compute & fill a valid diagnostic
134    
135     DO n=1,diagSt_nbLists
136     DO m=1,diagSt_nbActv(n)
137     IF ( chardiag.EQ.diagSt_Flds(m,n) .AND. iSdiag(m,n).GT.0 ) THEN
138     iSp = iSdiag(m,n)
139     IF ( qSdiag(0,0,iSp,bi,bj).GE.0. ) THEN
140     ndId = jSdiag(m,n)
141     C- check for a counter-mate:
142     mate = 0
143     parms1 = gdiag(ndId)(1:8)
144     IF ( parms1(5:5).EQ.'C' ) READ(parms1,'(5X,I3)') mate
145     IF ( mSdiag(m,n).EQ.0 ) mate = 0
146     IF ( mate.LE.0 ) THEN
147     WRITE(msgBuf,'(2A)') 'DIAGNOSTICS_FRACT_FILL: ',
148     & 'did not find a valid counter-mate'
149     CALL PRINT_ERROR( msgBuf , myThid )
150     WRITE(msgBuf,'(2A,I4,2A)') 'DIAGNOSTICS_FRACT_FILL: ',
151     & 'for diag(#',ndId,' ) :', chardiag
152     CALL PRINT_ERROR( msgBuf , myThid )
153     STOP 'ABNORMAL END: S/R DIAGNOSTICS_FRACT_FILL'
154     ENDIF
155     C- set the nb of levels of fraction-weight field (not > kdiag(mate))
156     nLevFract = MIN(nLevs,kdiag(mate))
157     C- Find list of regions to fill:
158     DO j=0,nRegions
159     region2fill(j) = diagSt_region(j,n)
160     ENDDO
161     C- if this diagnostics appears in several lists (with same freq)
162     C then add regions from other lists
163     DO l=1,diagSt_nbLists
164     DO k=1,diagSt_nbActv(l)
165     IF ( iSdiag(k,l).EQ.-iSp ) THEN
166     DO j=0,nRegions
167     region2fill(j) = MAX(region2fill(j),diagSt_region(j,l))
168     ENDDO
169     ENDIF
170     ENDDO
171     ENDDO
172     C- diagnostics is valid and Active, has a counter mate: Now do the filling
173     CALL DIAGSTATS_FILL(
174 jmc 1.2 I inpFld, fractFld, scaleFact, power, nLevFract,
175     I ndId, iSp, region2fill, kLev, nLevs,
176     I bibjFlg, biArg, bjArg, myThid )
177 jmc 1.1 ENDIF
178     ENDIF
179     ENDDO
180     ENDDO
181    
182     RETURN
183     END

  ViewVC Help
Powered by ViewVC 1.1.22