trunk/phylmd/diagetpq.f

module diagetpq_m

  IMPLICIT NONE

contains

  SUBROUTINE diagetpq(airephy, tit, iprt, idiag, idiag2, dtime, t, q, ql, &
       u, v, paprs, d_h_vcol, d_qt, d_ec)

    ! From LMDZ4/libf/phylmd/diagphy.F, version 1.1.1.1, 2004/05/19 12:53:08

    ! Purpose:

    ! Calcule la différence d'enthalpie et de masse d'eau entre deux
    ! appels et calcule le flux de chaleur et le flux d'eau
    ! nécessaires à ces changements. Ces valeurs sont moyennées sur la
    ! surface de tout le globe et sont exprimées en W/m2 et
    ! kg/s/m2. Outil pour diagnostiquer la conservation de l'énergie
    ! et de la masse dans la physique. Suppose que les niveaux de
    ! pression entre les couches ne varient pas entre deux appels.

    ! Plusieurs de ces diagnostics peuvent être faits en parallèle :
    ! les bilans sont sauvegardés dans des tableaux indices. On
    ! parlera "d'indice de diagnostic".

    ! Jean-Louis Dufresne, July 2002

    USE dimphy, ONLY: klev, klon
    USE suphec_m, ONLY: rcpd, rcpv, rcs, rcw, rg, rlstt, rlvtt

    ! Arguments: 

    ! Input variables
    real, intent(in):: airephy(klon) ! grid area
    CHARACTER(len=*), intent(in):: tit ! comment added in PRINT
    INTEGER, intent(in):: iprt ! PRINT level ( <=1 : no PRINT)

    INTEGER, intent(in):: idiag
    ! indice dans lequel seront rangés les nouveaux bilans d'enthalpie et
    ! de masse

    INTEGER, intent(in):: idiag2
    ! Les nouveaux bilans d'enthalpie et de masse sont comparés au
    ! bilan de d'enthalpie de masse de l'indice numéro idiag2. Cas
    ! particulier : si idiag2=0, pas de comparaison, on sort
    ! directement les bilans d'enthalpie et de masse.

    REAL, intent(in):: dtime ! time step (s)
    REAL, intent(in):: t(klon, klev) ! temperature (K)
    REAL, intent(in):: q(klon, klev) ! vapeur d'eau (kg/kg)
    REAL, intent(in):: ql(klon, klev) ! liquid water (kg/kg)
    REAL, intent(in):: u(klon, klev), v(klon, klev) ! vitesse
    REAL, intent(in):: paprs(klon, klev+1) ! pression a intercouche (Pa)

    ! The following total values are computed per UNIT of Earth surface

    REAL, intent(out):: d_h_vcol
    ! heat flux (W/m2) defined as the enthalpy change (J/m2) during
    ! one time step (dtime) for the whole atmosphere (air, water
    ! vapour, liquid and solid)

    REAL, intent(out):: d_qt
    ! total water mass flux (kg/m2/s) defined as the 
    ! total water (kg/m2) change during one time step (dtime)

    REAL, intent(out):: d_ec
    ! kinetic energy budget (W/m2) for vertical air column

    ! Local:

    REAL d_qw
    ! water vapour mass flux (kg/m2/s) defined as the water vapour
    ! (kg/m2) change during one time step (dtime)

    REAL d_ql ! same, for the liquid water only (kg/m2/s)

    REAL h_vcol_tot
    ! total enthalpy of vertical air column (air with water vapour,
    ! liquid and solid) (J/m2)

    REAL h_dair_tot ! total enthalpy of dry air (J/m2)
    REAL h_qw_tot ! total enthalpy of water vapour (J/m2)
    REAL h_ql_tot ! total enthalpy of liquid water (J/m2)
    REAL qw_tot ! total mass of water vapour (kg/m2)
    REAL ql_tot ! total mass of liquid water (kg/m2)
    real ec_tot ! total kinetic energy (kg/m2)
    REAL zairm(klon, klev) ! layer air mass (kg/m2)
    REAL zqw_col(klon)
    REAL zql_col(klon)
    REAL zec_col(klon)
    REAL zh_dair_col(klon)
    REAL zh_qw_col(klon), zh_ql_col(klon)
    REAL d_h_dair, d_h_qw, d_h_ql
    REAL airetot, zcpvap, zcwat, zcice
    INTEGER i, k
    INTEGER, PARAMETER:: ndiag = 10 ! max number of diagnostic in parallel
    integer:: pas(ndiag) = 0
    REAL, save:: h_vcol_pre(ndiag), h_dair_pre(ndiag), h_qw_pre(ndiag)
    REAL, save:: h_ql_pre(ndiag), qw_pre(ndiag), ql_pre(ndiag)
    REAL, save:: ec_pre(ndiag)

    !-------------------------------------------------------------

    DO k = 1, klev
       DO i = 1, klon
          zairm(i, k) = (paprs(i, k)-paprs(i, k+1))/RG
       ENDDO
    END DO

    ! Reset variables
    DO i = 1, klon
       zqw_col(i)=0.
       zql_col(i)=0.
       zec_col(i) = 0.
       zh_dair_col(i) = 0.
       zh_qw_col(i) = 0.
       zh_ql_col(i) = 0.
    ENDDO

    zcpvap=RCPV
    zcwat=RCW
    zcice=RCS

    ! Compute vertical sum for each atmospheric column
    DO k = 1, klev
       DO i = 1, klon
          ! Water mass
          zqw_col(i) = zqw_col(i) + q(i, k)*zairm(i, k)
          zql_col(i) = zql_col(i) + ql(i, k)*zairm(i, k)
          ! Kinetic Energy
          zec_col(i) = zec_col(i) +0.5*(u(i, k)**2+v(i, k)**2)*zairm(i, k)
          ! Air enthalpy
          zh_dair_col(i) = zh_dair_col(i) &
               + RCPD*(1.-q(i, k)-ql(i, k))*zairm(i, k)*t(i, k)
          zh_qw_col(i) = zh_qw_col(i) + zcpvap*q(i, k)*zairm(i, k)*t(i, k) 
          zh_ql_col(i) = zh_ql_col(i) &
               + zcwat*ql(i, k)*zairm(i, k)*t(i, k) &
               - RLVTT*ql(i, k)*zairm(i, k)
       END DO
    ENDDO

    ! Mean over the planet surface
    qw_tot = 0.
    ql_tot = 0.
    ec_tot = 0.
    h_vcol_tot = 0.
    h_dair_tot = 0.
    h_qw_tot = 0.
    h_ql_tot = 0.
    airetot=0.

    do i=1, klon
       qw_tot = qw_tot + zqw_col(i)*airephy(i)
       ql_tot = ql_tot + zql_col(i)*airephy(i)
       ec_tot = ec_tot + zec_col(i)*airephy(i)
       h_dair_tot = h_dair_tot + zh_dair_col(i)*airephy(i)
       h_qw_tot = h_qw_tot + zh_qw_col(i)*airephy(i)
       h_ql_tot = h_ql_tot + zh_ql_col(i)*airephy(i)
       airetot=airetot+airephy(i)
    END DO

    qw_tot = qw_tot/airetot
    ql_tot = ql_tot/airetot
    ec_tot = ec_tot/airetot
    h_dair_tot = h_dair_tot/airetot
    h_qw_tot = h_qw_tot/airetot
    h_ql_tot = h_ql_tot/airetot

    h_vcol_tot = h_dair_tot+h_qw_tot+h_ql_tot

    ! Compute the change of the atmospheric state compared to the one
    ! stored in "idiag2", and convert it in flux. This computation is
    ! performed if idiag2 /= 0 and if it is not the first call for
    ! "idiag".

    IF (idiag2 > 0 .and. pas(idiag2) /= 0) THEN
       d_h_vcol = (h_vcol_tot - h_vcol_pre(idiag2) )/dtime
       d_h_dair = (h_dair_tot- h_dair_pre(idiag2))/dtime
       d_h_qw = (h_qw_tot - h_qw_pre(idiag2) )/dtime
       d_h_ql = (h_ql_tot - h_ql_pre(idiag2) )/dtime 
       d_qw = (qw_tot - qw_pre(idiag2) )/dtime
       d_ql = (ql_tot - ql_pre(idiag2) )/dtime
       d_ec = (ec_tot - ec_pre(idiag2) )/dtime
       d_qt = d_qw + d_ql
    ELSE 
       d_h_vcol = 0.
       d_h_dair = 0.
       d_h_qw = 0.
       d_h_ql = 0.
       d_qw = 0.
       d_ql = 0.
       d_ec = 0.
       d_qt = 0.
    ENDIF

    IF (iprt >= 2) THEN
       print 9000, tit, pas(idiag), d_qt, d_qw, d_ql
       print 9001, tit, pas(idiag), d_h_vcol
       print 9002, tit, pas(idiag), d_ec
    END IF

    ! Store the new atmospheric state in "idiag"
    pas(idiag)=pas(idiag)+1
    h_vcol_pre(idiag) = h_vcol_tot
    h_dair_pre(idiag) = h_dair_tot
    h_qw_pre(idiag) = h_qw_tot
    h_ql_pre(idiag) = h_ql_tot
    qw_pre(idiag) = qw_tot
    ql_pre(idiag) = ql_tot
    ec_pre (idiag) = ec_tot

9000 format('Physics water mass budget (kg/m2/s)', A15, 1i6, 10(1pE14.6))
9001 format('Physics enthalpy budget (W/m2) ', A15, 1i6, 10(F8.2))
9002 format('Physics kinetic energy budget (W/m2) ', A15, 1i6, 10(F8.2))

  END SUBROUTINE diagetpq

end module diagetpq_m
1	module diagetpq_m
2
3	IMPLICIT NONE
4
5	contains
6
7	SUBROUTINE diagetpq(airephy, tit, iprt, idiag, idiag2, dtime, t, q, ql, &
8	u, v, paprs, d_h_vcol, d_qt, d_ec)
9
10	! From LMDZ4/libf/phylmd/diagphy.F, version 1.1.1.1, 2004/05/19 12:53:08
11
12	! Purpose:
13
14	! Calcule la différence d'enthalpie et de masse d'eau entre deux
15	! appels et calcule le flux de chaleur et le flux d'eau
16	! nécessaires à ces changements. Ces valeurs sont moyennées sur la
17	! surface de tout le globe et sont exprimées en W/m2 et
18	! kg/s/m2. Outil pour diagnostiquer la conservation de l'énergie
19	! et de la masse dans la physique. Suppose que les niveaux de
20	! pression entre les couches ne varient pas entre deux appels.
21
22	! Plusieurs de ces diagnostics peuvent être faits en parallèle :
23	! les bilans sont sauvegardés dans des tableaux indices. On
24	! parlera "d'indice de diagnostic".
25
26	! Jean-Louis Dufresne, July 2002
27
28	USE dimphy, ONLY: klev, klon
29	USE suphec_m, ONLY: rcpd, rcpv, rcs, rcw, rg, rlstt, rlvtt
30
31	! Arguments:
32
33	! Input variables
34	real, intent(in):: airephy(klon) ! grid area
35	CHARACTER(len=*), intent(in):: tit ! comment added in PRINT
36	INTEGER, intent(in):: iprt ! PRINT level ( <=1 : no PRINT)
37
38	INTEGER, intent(in):: idiag
39	! indice dans lequel seront rangés les nouveaux bilans d'enthalpie et
40	! de masse
41
42	INTEGER, intent(in):: idiag2
43	! Les nouveaux bilans d'enthalpie et de masse sont comparés au
44	! bilan de d'enthalpie de masse de l'indice numéro idiag2. Cas
45	! particulier : si idiag2=0, pas de comparaison, on sort
46	! directement les bilans d'enthalpie et de masse.
47
48	REAL, intent(in):: dtime ! time step (s)
49	REAL, intent(in):: t(klon, klev) ! temperature (K)
50	REAL, intent(in):: q(klon, klev) ! vapeur d'eau (kg/kg)
51	REAL, intent(in):: ql(klon, klev) ! liquid water (kg/kg)
52	REAL, intent(in):: u(klon, klev), v(klon, klev) ! vitesse
53	REAL, intent(in):: paprs(klon, klev+1) ! pression a intercouche (Pa)
54
55	! The following total values are computed per UNIT of Earth surface
56
57	REAL, intent(out):: d_h_vcol
58	! heat flux (W/m2) defined as the enthalpy change (J/m2) during
59	! one time step (dtime) for the whole atmosphere (air, water
60	! vapour, liquid and solid)
61
62	REAL, intent(out):: d_qt
63	! total water mass flux (kg/m2/s) defined as the
64	! total water (kg/m2) change during one time step (dtime)
65
66	REAL, intent(out):: d_ec
67	! kinetic energy budget (W/m2) for vertical air column
68
69	! Local:
70
71	REAL d_qw
72	! water vapour mass flux (kg/m2/s) defined as the water vapour
73	! (kg/m2) change during one time step (dtime)
74
75	REAL d_ql ! same, for the liquid water only (kg/m2/s)
76
77	REAL h_vcol_tot
78	! total enthalpy of vertical air column (air with water vapour,
79	! liquid and solid) (J/m2)
80
81	REAL h_dair_tot ! total enthalpy of dry air (J/m2)
82	REAL h_qw_tot ! total enthalpy of water vapour (J/m2)
83	REAL h_ql_tot ! total enthalpy of liquid water (J/m2)
84	REAL qw_tot ! total mass of water vapour (kg/m2)
85	REAL ql_tot ! total mass of liquid water (kg/m2)
86	real ec_tot ! total kinetic energy (kg/m2)
87	REAL zairm(klon, klev) ! layer air mass (kg/m2)
88	REAL zqw_col(klon)
89	REAL zql_col(klon)
90	REAL zec_col(klon)
91	REAL zh_dair_col(klon)
92	REAL zh_qw_col(klon), zh_ql_col(klon)
93	REAL d_h_dair, d_h_qw, d_h_ql
94	REAL airetot, zcpvap, zcwat, zcice
95	INTEGER i, k
96	INTEGER, PARAMETER:: ndiag = 10 ! max number of diagnostic in parallel
97	integer:: pas(ndiag) = 0
98	REAL, save:: h_vcol_pre(ndiag), h_dair_pre(ndiag), h_qw_pre(ndiag)
99	REAL, save:: h_ql_pre(ndiag), qw_pre(ndiag), ql_pre(ndiag)
100	REAL, save:: ec_pre(ndiag)
101
102	!-------------------------------------------------------------
103
104	DO k = 1, klev
105	DO i = 1, klon
106	zairm(i, k) = (paprs(i, k)-paprs(i, k+1))/RG
107	ENDDO
108	END DO
109
110	! Reset variables
111	DO i = 1, klon
112	zqw_col(i)=0.
113	zql_col(i)=0.
114	zec_col(i) = 0.
115	zh_dair_col(i) = 0.
116	zh_qw_col(i) = 0.
117	zh_ql_col(i) = 0.
118	ENDDO
119
120	zcpvap=RCPV
121	zcwat=RCW
122	zcice=RCS
123
124	! Compute vertical sum for each atmospheric column
125	DO k = 1, klev
126	DO i = 1, klon
127	! Water mass
128	zqw_col(i) = zqw_col(i) + q(i, k)*zairm(i, k)
129	zql_col(i) = zql_col(i) + ql(i, k)*zairm(i, k)
130	! Kinetic Energy
131	zec_col(i) = zec_col(i) +0.5(u(i, k)2+v(i, k)2)zairm(i, k)
132	! Air enthalpy
133	zh_dair_col(i) = zh_dair_col(i) &
134	+ RCPD(1.-q(i, k)-ql(i, k))zairm(i, k)*t(i, k)
135	zh_qw_col(i) = zh_qw_col(i) + zcpvapq(i, k)zairm(i, k)*t(i, k)
136	zh_ql_col(i) = zh_ql_col(i) &
137	+ zcwatql(i, k)zairm(i, k)*t(i, k) &
138	- RLVTTql(i, k)zairm(i, k)
139	END DO
140	ENDDO
141
142	! Mean over the planet surface
143	qw_tot = 0.
144	ql_tot = 0.
145	ec_tot = 0.
146	h_vcol_tot = 0.
147	h_dair_tot = 0.
148	h_qw_tot = 0.
149	h_ql_tot = 0.
150	airetot=0.
151
152	do i=1, klon
153	qw_tot = qw_tot + zqw_col(i)*airephy(i)
154	ql_tot = ql_tot + zql_col(i)*airephy(i)
155	ec_tot = ec_tot + zec_col(i)*airephy(i)
156	h_dair_tot = h_dair_tot + zh_dair_col(i)*airephy(i)
157	h_qw_tot = h_qw_tot + zh_qw_col(i)*airephy(i)
158	h_ql_tot = h_ql_tot + zh_ql_col(i)*airephy(i)
159	airetot=airetot+airephy(i)
160	END DO
161
162	qw_tot = qw_tot/airetot
163	ql_tot = ql_tot/airetot
164	ec_tot = ec_tot/airetot
165	h_dair_tot = h_dair_tot/airetot
166	h_qw_tot = h_qw_tot/airetot
167	h_ql_tot = h_ql_tot/airetot
168
169	h_vcol_tot = h_dair_tot+h_qw_tot+h_ql_tot
170
171	! Compute the change of the atmospheric state compared to the one
172	! stored in "idiag2", and convert it in flux. This computation is
173	! performed if idiag2 /= 0 and if it is not the first call for
174	! "idiag".
175
176	IF (idiag2 > 0 .and. pas(idiag2) /= 0) THEN
177	d_h_vcol = (h_vcol_tot - h_vcol_pre(idiag2) )/dtime
178	d_h_dair = (h_dair_tot- h_dair_pre(idiag2))/dtime
179	d_h_qw = (h_qw_tot - h_qw_pre(idiag2) )/dtime
180	d_h_ql = (h_ql_tot - h_ql_pre(idiag2) )/dtime
181	d_qw = (qw_tot - qw_pre(idiag2) )/dtime
182	d_ql = (ql_tot - ql_pre(idiag2) )/dtime
183	d_ec = (ec_tot - ec_pre(idiag2) )/dtime
184	d_qt = d_qw + d_ql
185	ELSE
186	d_h_vcol = 0.
187	d_h_dair = 0.
188	d_h_qw = 0.
189	d_h_ql = 0.
190	d_qw = 0.
191	d_ql = 0.
192	d_ec = 0.
193	d_qt = 0.
194	ENDIF
195
196	IF (iprt >= 2) THEN
197	print 9000, tit, pas(idiag), d_qt, d_qw, d_ql
198	print 9001, tit, pas(idiag), d_h_vcol
199	print 9002, tit, pas(idiag), d_ec
200	END IF
201
202	! Store the new atmospheric state in "idiag"
203	pas(idiag)=pas(idiag)+1
204	h_vcol_pre(idiag) = h_vcol_tot
205	h_dair_pre(idiag) = h_dair_tot
206	h_qw_pre(idiag) = h_qw_tot
207	h_ql_pre(idiag) = h_ql_tot
208	qw_pre(idiag) = qw_tot
209	ql_pre(idiag) = ql_tot
210	ec_pre (idiag) = ec_tot
211
212	9000 format('Physics water mass budget (kg/m2/s)', A15, 1i6, 10(1pE14.6))
213	9001 format('Physics enthalpy budget (W/m2) ', A15, 1i6, 10(F8.2))
214	9002 format('Physics kinetic energy budget (W/m2) ', A15, 1i6, 10(F8.2))
215
216	END SUBROUTINE diagetpq
217
218	end module diagetpq_m