source: LMDZ6/trunk/libf/phylmd/cospv2/quickbeam.f90 @ 5444

Last change on this file since 5444 was 5268, checked in by abarral, 2 months ago

.f90 <-> .F90 depending on cpp key use

File size: 31.2 KB
Line 
1! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2! Copyright (c) 2015, Regents of the University of Colorado
3! All rights reserved.
4!
5! Redistribution and use in source and binary forms, with or without modification, are
6! permitted provided that the following conditions are met:
7!
8! 1. Redistributions of source code must retain the above copyright notice, this list of
9!    conditions and the following disclaimer.
10!
11! 2. Redistributions in binary form must reproduce the above copyright notice, this list
12!    of conditions and the following disclaimer in the documentation and/or other
13!    materials provided with the distribution.
14!
15! 3. Neither the name of the copyright holder nor the names of its contributors may be
16!    used to endorse or promote products derived from this software without specific prior
17!    written permission.
18!
19! THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
20! EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21! MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
22! THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
24! OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25! INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26! LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27! OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28!
29! History
30! 11/2005: John Haynes - Created
31! 09/2006  placed into subroutine form (Roger Marchand,JMH)
32! 08/2007  added equivalent volume spheres, Z and N scalling most distrubtion types (Roger Marchand)
33! 01/2008  'Do while' to determine if hydrometeor(s) present in volume
34!           changed for vectorization purposes (A. Bodas-Salcedo)
35!
36! 07/2010  V3.0 ... Modified to load or save scale factors to disk as a Look-Up Table (LUT)
37!  ... All hydrometeor and radar simulator properties now included in hp structure
38!  ... hp structure should be initialized by call to radar_simulator_init prior
39!  ... to calling this subroutine. 
40!     Also ... Support of Morrison 2-moment style microphyscis (Np_matrix) added
41!  ... Changes implement by Roj Marchand following work by Laura Fowler
42!
43!   10/2011  Modified ngate loop to go in either direction depending on flag
44!     hp%radar_at_layer_one.  This affects the direction in which attenuation is summed.
45!
46!     Also removed called to AVINT for gas and hydrometeor attenuation and replaced with simple
47!     summation. (Roger Marchand)
48! May 2015 - D. Swales - Modified for COSPv2.0
49! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
50module quickbeam
51  USE COSP_KINDS,           ONLY: wp
52  USE MOD_COSP_CONFIG,      ONLY: R_UNDEF,cloudsat_histRef,use_vgrid,vgrid_zl,vgrid_zu,&
53                                  pClass_noPrecip, pClass_Rain1, pClass_Rain2, pClass_Rain3,&
54                                  pClass_Snow1, pClass_Snow2, pClass_Mixed1, pClass_Mixed2, &
55                                  pClass_Rain4, pClass_default, Zenonbinval, Zbinvallnd,    &
56                                  N_HYDRO,nCloudsatPrecipClass !,cloudsat_preclvl !PREC_BUG
57  USE MOD_COSP_STATS,       ONLY: COSP_LIDAR_ONLY_CLOUD,hist1D,COSP_CHANGE_VERTICAL_GRID
58  implicit none
59
60  integer,parameter :: &
61       maxhclass     = 20,  & ! Qucikbeam maximum number of hydrometeor classes.
62       nRe_types     = 550, & ! Quickbeam maximum number or Re size bins allowed in N and Z_scaled look up table.
63       nd            = 85,  & ! Qucikbeam number of discrete particles used in construction DSDs.
64       mt_ntt        = 39,  & ! Quickbeam number of temperatures in mie LUT.
65       Re_BIN_LENGTH = 10,  & ! Quickbeam minimum Re interval in scale LUTs 
66       Re_MAX_BIN    = 250    ! Quickbeam maximum Re interval in scale LUTs
67  real(wp),parameter :: &
68       dmin          = 0.1, & ! Quickbeam minimum size of discrete particle
69       dmax          = 10000. ! Quickbeam maximum size of discrete particle
70 
71  !djs logical :: radar_at_layer_one   ! If true radar is assume to be at the edge
72                                  ! of the first layer, if the first layer is the
73                                  ! surface than a ground-based radar.   If the
74                                  ! first layer is the top-of-atmosphere, then
75                                  ! a space borne radar.
76
77  ! ##############################################################################################
78  type radar_cfg
79     ! Radar properties
80     real(wp) :: freq,k2
81     integer  :: nhclass               ! Number of hydrometeor classes in use
82     integer  :: use_gas_abs, do_ray
83     logical  :: radar_at_layer_one    ! If true radar is assume to be at the edge
84                                       ! of the first layer, if the first layer is the
85                                       ! surface than a ground-based radar.   If the
86                                       ! first layer is the top-of-atmosphere, then
87                                       ! a space borne radar.
88     
89     ! Variables used to store Z scale factors
90     character(len=240)                             :: scale_LUT_file_name
91     logical                                        :: load_scale_LUTs, update_scale_LUTs
92     logical, dimension(maxhclass,nRe_types)        :: N_scale_flag
93     logical, dimension(maxhclass,mt_ntt,nRe_types) :: Z_scale_flag,Z_scale_added_flag
94     real(wp),dimension(maxhclass,mt_ntt,nRe_types) :: Ze_scaled,Zr_scaled,kr_scaled
95     real(wp),dimension(maxhclass,nd,nRe_types)     :: fc, rho_eff
96     real(wp),dimension(Re_MAX_BIN)                 :: base_list,step_list
97
98  end type radar_cfg
99
100contains
101  ! ######################################################################################
102  ! SUBROUTINE quickbeam_subcolumn
103  ! ######################################################################################
104  subroutine quickbeam_subcolumn(rcfg,nprof,ngate,hgt_matrix,z_vol,kr_vol,g_vol,dBZe,Ze_non)
105
106    ! INPUTS
107    type(radar_cfg),intent(inout) :: &
108         rcfg             ! Derived type for radar simulator setup
109    integer,intent(in) :: &
110         nprof,         & ! Number of hydrometeor profiles
111         ngate            ! Number of vertical layers
112    real(wp),intent(in),dimension(nprof,ngate) :: &
113         hgt_matrix,    & ! Height of hydrometeors (km)
114         z_vol,         & ! Effective reflectivity factor (mm^6/m^3)
115         kr_vol,        & ! Attenuation coefficient hydro (dB/km)
116         g_vol            ! Attenuation coefficient gases (dB/km)
117   
118    ! OUTPUTS
119    real(wp), intent(out),dimension(nprof,ngate) :: &
120         Ze_non,        & ! Radar reflectivity without attenuation (dBZ)
121         dBZe             ! Effective radar reflectivity factor (dBZ)
122
123    ! LOCAL VARIABLES
124    integer :: k,pr,start_gate,end_gate,d_gate
125    real(wp),dimension(nprof,ngate) :: &
126         Ze_ray,        & ! Rayleigh reflectivity (dBZ)
127         g_to_vol,      & ! Gaseous atteunation, radar to vol (dB)
128         a_to_vol,      & ! Hydromets attenuation, radar to vol (dB)
129         z_ray            ! Reflectivity factor, Rayleigh only (mm^6/m^3)
130
131    ! Load scaling matricies from disk -- but only the first time this subroutine is called
132    if(rcfg%load_scale_LUTs) then
133       call load_scale_LUTs(rcfg)
134       rcfg%load_scale_LUTs=.false.
135       rcfg%Z_scale_added_flag = .false. ! will be set true if scaling Look Up Tables are modified during run
136    endif
137
138    ! Initialization
139    g_to_vol = 0._wp
140    a_to_vol = 0._wp
141
142    ! Loop over each range gate (ngate) ... starting with layer closest to the radar !
143    if(rcfg%radar_at_layer_one) then
144       start_gate = 1
145       end_gate   = ngate
146       d_gate     = 1
147    else
148       start_gate = ngate
149       end_gate   = 1
150       d_gate     = -1
151    endif
152    do k=start_gate,end_gate,d_gate
153       ! Loop over each profile (nprof)
154       do pr=1,nprof
155          ! Attenuation due to hydrometeors between radar and volume
156         
157          ! NOTE old scheme integrates attenuation only for the layers ABOVE
158          ! the current layer ... i.e. 1 to k-1 rather than 1 to k ...
159          ! which may be a problem.   ROJ
160          ! in the new scheme I assign half the attenuation to the current layer
161          if(d_gate==1) then
162             ! dheight calcuations assumes hgt_matrix points are the cell mid-points.
163             if (k>2) then
164                ! add to previous value to half of above layer + half of current layer
165                a_to_vol(pr,k)=  a_to_vol(pr,k-1) + &
166                     (kr_vol(pr,k-1)+kr_vol(pr,k))*(hgt_matrix(pr,k-1)-hgt_matrix(pr,k))
167             else
168                a_to_vol(pr,k)=  kr_vol(pr,k)*(hgt_matrix(pr,k)-hgt_matrix(pr,k+1))
169             endif
170          else   ! d_gate==-1
171             if(k<ngate) then
172                ! Add to previous value half of above layer + half of current layer
173                a_to_vol(pr,k) = a_to_vol(pr,k+1) + &
174                     (kr_vol(pr,k+1)+kr_vol(pr,k))*(hgt_matrix(pr,k+1)-hgt_matrix(pr,k))
175             else
176                a_to_vol(pr,k)= kr_vol(pr,k)*(hgt_matrix(pr,k)-hgt_matrix(pr,k-1))
177             endif
178          endif
179         
180          ! Attenuation due to gaseous absorption between radar and volume
181          if ((rcfg%use_gas_abs == 1) .or. (rcfg%use_gas_abs == 2 .and. pr .eq. 1)) then
182             if (d_gate==1) then
183                if (k>1) then
184                   ! Add to previous value to half of above layer + half of current layer
185                   g_to_vol(pr,k) =  g_to_vol(pr,k-1) + &
186                        0.5*(g_vol(pr,k-1)+g_vol(pr,k))*(hgt_matrix(pr,k-1)-hgt_matrix(pr,k))
187                else
188                   g_to_vol(pr,k)=  0.5_wp*g_vol(pr,k)*(hgt_matrix(pr,k)-hgt_matrix(pr,k+1))
189                endif
190             else   ! d_gate==-1
191                if (k<ngate) then
192                   ! Add to previous value to half of above layer + half of current layer
193                   g_to_vol(pr,k) = g_to_vol(pr,k+1) + &
194                        0.5_wp*(g_vol(pr,k+1)+g_vol(pr,k))*(hgt_matrix(pr,k+1)-hgt_matrix(pr,k))
195                else
196                   g_to_vol(pr,k)= 0.5_wp*g_vol(pr,k)*(hgt_matrix(pr,k)-hgt_matrix(pr,k-1))
197                endif
198             endif
199          elseif(rcfg%use_gas_abs == 2) then
200             ! Using value calculated for the first column
201             g_to_vol(pr,k) = g_to_vol(1,k)
202          elseif (rcfg%use_gas_abs == 0) then
203             g_to_vol(pr,k) = 0._wp
204          endif
205       enddo   ! End loop over pr (profile)
206    enddo ! End loop of k (range gate)
207   
208    ! Compute Rayleigh reflectivity, and full, attenuated reflectivity
209    if(rcfg%do_ray == 1) then
210       where(z_ray(1:nprof,1:ngate) > 0._wp)
211          Ze_ray(1:nprof,1:ngate) = 10._wp*log10(z_ray(1:nprof,1:ngate))
212       elsewhere
213          Ze_Ray(1:nprof,1:ngate) = 0._wp
214       endwhere
215    else
216      Ze_ray(1:nprof,1:ngate) = R_UNDEF
217    end if
218
219    where(z_vol(1:nprof,1:ngate) > 0._wp)
220      Ze_non(1:nprof,1:ngate) = 10._wp*log10(z_vol(1:nprof,1:ngate))
221      dBZe(1:nprof,1:ngate) = Ze_non(1:nprof,1:ngate)-a_to_vol(1:nprof,1:ngate)-g_to_vol(1:nprof,1:ngate)
222    elsewhere
223      dBZe(1:nprof,1:ngate) = R_UNDEF
224      Ze_non(1:nprof,1:ngate) = R_UNDEF
225    end where
226
227    ! Save any updates made
228    if (rcfg%update_scale_LUTs) call save_scale_LUTs(rcfg)
229 
230  end subroutine quickbeam_subcolumn
231  ! ######################################################################################
232  ! SUBROUTINE quickbeam_column
233  ! ######################################################################################
234  subroutine quickbeam_column(npoints, ncolumns, nlevels, llm, DBZE_BINS, platform,      &
235       Ze_tot, Ze_tot_non, land, surfelev, t2m, fracPrecipIce, zlev, zlev_half, cfad_ze, & !PREC_BUG
236       cloudsat_precip_cover, cloudsat_pia)
237    ! Inputs
238    integer,intent(in) :: &
239         npoints,    & ! Number of horizontal grid points
240         ncolumns,   & ! Number of subcolumns
241         nlevels,    & ! Number of vertical layers in OLD grid
242         llm,        & ! Number of vertical layers in NEW grid
243         DBZE_BINS     ! Number of bins for cfad.
244    character(len=*),intent(in) :: &
245         platform      ! Name of platform (e.g. cloudsat)
246    real(wp),dimension(Npoints),intent(in) :: &
247         land,               & ! Land/Sea mask. (1/0)
248         surfelev,           & ! Surface Elevation (m) !PREC_BUG
249         t2m                   ! Near-surface temperature
250    real(wp),dimension(Npoints,Ncolumns),intent(in) :: &
251         fracPrecipIce         ! Fraction of precipitation which is frozen.     (1)
252    real(wp),intent(in),dimension(npoints,ncolumns,Nlevels) :: &
253         Ze_tot,     & ! Effective reflectivity factor                 (dBZ)
254         Ze_tot_non    ! Effective reflectivity factor w/o attenuation (dBZ)
255    real(wp),intent(in),dimension(npoints,Nlevels) :: &
256         zlev          ! Model full levels
257    real(wp),intent(in),dimension(npoints,Nlevels+1) :: &
258         zlev_half     ! Model half levels
259         
260    ! Outputs
261    real(wp),intent(inout),dimension(npoints,DBZE_BINS,llm) :: &
262         cfad_ze    !
263    real(wp),dimension(Npoints,nCloudsatPrecipClass),intent(out) :: &
264         cloudsat_precip_cover ! Model precip rate in by CloudSat precip flag
265    real(wp),dimension(Npoints),intent(out) :: &
266         cloudsat_pia          ! Cloudsat path integrated attenuation
267   
268    ! Local variables
269    integer :: i,j
270    real(wp),dimension(npoints,ncolumns,llm) :: ze_toti,ze_noni
271    logical :: lcloudsat = .false.
272
273    ! Which platforms to create diagnostics for?
274    if (platform .eq. 'cloudsat') lcloudsat=.true.
275
276    ! Create Cloudsat diagnostics.
277    if (lcloudsat) then
278       if (use_vgrid) then
279          ! Regrid in the vertical (*NOTE* This routine requires SFC-2-TOA ordering, so flip
280          ! inputs and outputs to maintain TOA-2-SFC ordering convention in COSP2.)
281          call cosp_change_vertical_grid(Npoints,Ncolumns,Nlevels,zlev(:,nlevels:1:-1),&
282               zlev_half(:,nlevels:1:-1),Ze_tot(:,:,nlevels:1:-1),llm,vgrid_zl(llm:1:-1),&
283               vgrid_zu(llm:1:-1),Ze_toti(:,:,llm:1:-1),log_units=.true.)
284         
285          ! Effective reflectivity histogram
286          do i=1,Npoints
287             do j=1,llm
288                cfad_ze(i,:,j) = hist1D(Ncolumns,Ze_toti(i,:,j),DBZE_BINS,cloudsat_histRef)
289             enddo
290          enddo
291          where(cfad_ze .ne. R_UNDEF) cfad_ze = cfad_ze/Ncolumns
292
293          ! Compute cloudsat near-surface precipitation diagnostics
294          ! First, regrid in the vertical Ze_tot_non.
295          call cosp_change_vertical_grid(Npoints,Ncolumns,Nlevels,zlev(:,nlevels:1:-1),&
296               zlev_half(:,nlevels:1:-1),Ze_tot_non(:,:,nlevels:1:-1),llm,vgrid_zl(llm:1:-1),&
297               vgrid_zu(llm:1:-1),Ze_noni(:,:,llm:1:-1),log_units=.true.)
298          ! Not call routine to generate diagnostics.
299          call cloudsat_precipOccurence(Npoints, Ncolumns, llm, N_HYDRO, Ze_toti, Ze_noni, &
300               land, surfelev, t2m, fracPrecipIce, cloudsat_precip_cover, cloudsat_pia) !PREC_BUG
301       else
302          ! Effective reflectivity histogram
303          do i=1,Npoints
304             do j=1,llm
305                cfad_ze(i,:,j) = hist1D(Ncolumns,Ze_tot(i,:,j),DBZE_BINS,cloudsat_histRef)
306             enddo
307          enddo
308          where(cfad_ze .ne. R_UNDEF) cfad_ze = cfad_ze/Ncolumns
309       endif
310    endif
311
312  end subroutine quickbeam_column
313  ! ##############################################################################################
314  ! ##############################################################################################
315  ! ######################################################################################
316  ! SUBROUTINE cloudsat_precipOccurence
317  !
318  ! Notes from July 2016: Add precip flag also looped over subcolumns
319  ! Modified by Tristan L'Ecuyer (TSL) to add precipitation flagging
320  ! based on CloudSat's 2C-PRECIP-COLUMN algorithm (Haynes et al, JGR, 2009).
321  ! To mimic the satellite algorithm, this code applies thresholds to non-attenuated
322  ! reflectivities, Ze_non, consistent with those outlined in Haynes et al, JGR (2009).
323  !
324  ! Procedures/Notes:
325  !
326  ! (1) If the 2-way attenuation exceeds 40 dB, the pixel will be flagged as 'heavy rain'
327  ! consistent with the multiple-scattering analysis of Battaglia et al, JGR (2008).
328  ! (2) Rain, snow, and mixed precipitation scenes are separated according to the fraction
329  ! of the total precipitation hydrometeor mixing ratio that exists as ice.
330  ! (3) The entire analysis is applied to the range gate from 480-960 m to be consistent with
331  ! CloudSat's 720 m ground-clutter.
332  ! (4) Only a single flag is assigned to each model grid since there is no variation in
333  ! hydrometeor contents across a single model level.  Unlike CFADs, whose variation enters
334  ! due to differening attenuation corrections from hydrometeors aloft, the non-attenuated
335  ! reflectivities used in the computation of this flag cannot vary across sub-columns.
336  !
337  ! radar_prec_flag = 1-Rain possible 2-Rain probable 3-Rain certain
338  !                   4-Snow possible 5-Snow certain
339  !                   6-Mixed possible 7-Mixed certain
340  !                   8-Heavy Rain
341  !                   9- default value
342  !
343  ! Modified by Dustin Swales (University of Colorado) for use with COSP2.
344  ! *NOTE* All inputs (Ze_out, Ze_non_out, fracPrecipIce) are at a single level from the
345  !        statistical output grid used by Cloudsat. This level is controlled by the
346  !        parameter cloudsat_preclvl, defined in src/cosp_config.F90
347  ! ######################################################################################
348  subroutine cloudsat_precipOccurence(Npoints, Ncolumns, llm, Nhydro, Ze_out, Ze_non_out, &
349       land, surfelev, t2m, fracPrecipIce,  cloudsat_precip_cover, cloudsat_pia) !PREC_BUG
350 
351    ! Inputs
352    integer,intent(in) :: &
353         Npoints,            & ! Number of columns
354         Ncolumns,           & ! Numner of subcolumns
355         Nhydro,             & ! Number of hydrometeor types
356         llm                   ! Number of levels
357    real(wp),dimension(Npoints),intent(in) :: &
358         land,               & ! Land/Sea mask. (1/0)
359         surfelev,           & ! Surface Elevation (m) !PREC_BUG
360         t2m                   ! Near-surface temperature
361    real(wp),dimension(Npoints,Ncolumns,llm),intent(in) :: &
362         Ze_out,             & ! Effective reflectivity factor                  (dBZ)
363         Ze_non_out            ! Effective reflectivity factor, w/o attenuation (dBZ)
364    real(wp),dimension(Npoints,Ncolumns),intent(in) :: &
365         fracPrecipIce         ! Fraction of precipitation which is frozen.     (1)
366
367    ! Outputs
368    real(wp),dimension(Npoints,nCloudsatPrecipClass),intent(out) :: &
369         cloudsat_precip_cover ! Model precip rate in by CloudSat precip flag
370    real(wp),dimension(Npoints),intent(out) :: &
371         cloudsat_pia          ! Cloudsat path integrated attenuation
372   
373    ! Local variables
374    integer,dimension(Npoints,Ncolumns) :: &
375         cloudsat_pflag,      & ! Subcolumn precipitation flag
376         cloudsat_precip_pia    ! Subcolumn path integrated attenutation.
377    integer,dimension(Npoints) :: &                                           !PREC_BUG
378         cloudsat_preclvl_index ! Altitude index for precip flags calculation !PREC_BUG
379                                ! in 40-level grid (2nd layer above surfelev) !PREC_BUG
380    integer :: pr,i,k,m,j,cloudsat_preclvl                                    !PREC_BUG
381    real(wp) :: Zmax
382   
383    ! Initialize
384    cloudsat_pflag(:,:)        = pClass_default
385    cloudsat_precip_pia(:,:)   = 0._wp
386    cloudsat_precip_cover(:,:) = 0._wp
387    cloudsat_pia(:)            = 0._wp
388    cloudsat_preclvl_index(:)  = 0._wp !PREC_BUG
389
390
391!!! Computing altitude index for precip flags calculation  !PREC_BUG
392cloudsat_preclvl_index(:) = 39 - floor( surfelev(:)/480. ) !PREC_BUG
393
394    ! ######################################################################################
395    ! SUBCOLUMN processing
396    ! ######################################################################################
397    do i=1, Npoints
398
399       cloudsat_preclvl = cloudsat_preclvl_index(i) !PREC_BUG
400!       print*, 'i, surfelev(i), cloudsat_preclvl : ', i, surfelev(i), cloudsat_preclvl !PREC_BUG
401
402       do pr=1,Ncolumns
403          ! 1) Compute the PIA in all profiles containing hydrometeors
404          if ( (Ze_non_out(i,pr,cloudsat_preclvl).gt.-100) .and. (Ze_out(i,pr,cloudsat_preclvl).gt.-100) ) then
405             if ( (Ze_non_out(i,pr,cloudsat_preclvl).lt.100) .and. (Ze_out(i,pr,cloudsat_preclvl).lt.100) ) then
406                cloudsat_precip_pia(i,pr) = Ze_non_out(i,pr,cloudsat_preclvl) - Ze_out(i,pr,cloudsat_preclvl)
407             endif
408          endif
409         
410          ! 2) Compute precipitation flag
411          ! ################################################################################
412          ! 2a) Oceanic points.
413          ! ################################################################################
414          if (land(i) .eq. 0) then
415!             print*, 'aaa i, pr, fracPrecipIce(i,pr) : ', i, pr, fracPrecipIce(i,pr) !Artem
416             ! Snow
417             if(fracPrecipIce(i,pr).gt.0.9) then
418                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(2)) then
419                   cloudsat_pflag(i,pr) = pClass_Snow2                   ! TSL: Snow certain
420                endif
421                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(4).and. &
422                     Ze_non_out(i,pr,cloudsat_preclvl).le.Zenonbinval(2)) then
423                   cloudsat_pflag(i,pr) = pClass_Snow1                   ! TSL: Snow possible
424                endif
425             endif
426             
427             ! Mixed
428             if(fracPrecipIce(i,pr).gt.0.1.and.fracPrecipIce(i,pr).le.0.9) then
429                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(2)) then
430                   cloudsat_pflag(i,pr) = pClass_Mixed2                  ! TSL: Mixed certain
431                endif
432                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(4).and. &
433                     Ze_non_out(i,pr,cloudsat_preclvl).le.Zenonbinval(2)) then
434                   cloudsat_pflag(i,pr) = pClass_Mixed1                  ! TSL: Mixed possible
435                endif
436             endif
437             
438             ! Rain
439             if(fracPrecipIce(i,pr).le.0.1) then
440                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(1)) then
441                   cloudsat_pflag(i,pr) = pClass_Rain3                   ! TSL: Rain certain
442                endif
443                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(3).and. &
444                     Ze_non_out(i,pr,cloudsat_preclvl).le.Zenonbinval(1)) then
445                   cloudsat_pflag(i,pr) = pClass_Rain2                   ! TSL: Rain probable
446                endif
447                if(Ze_non_out(i,pr,cloudsat_preclvl).gt.Zenonbinval(4).and. &
448                     Ze_non_out(i,pr,cloudsat_preclvl).le.Zenonbinval(3)) then
449                   cloudsat_pflag(i,pr) = pClass_Rain1                   ! TSL: Rain possible
450                endif
451                if(cloudsat_precip_pia(i,pr).gt.40) then
452                   cloudsat_pflag(i,pr) = pClass_Rain4                   ! TSL: Heavy Rain
453                endif
454             endif
455             
456             ! No precipitation
457             if(Ze_non_out(i,pr,cloudsat_preclvl).le.-15) then
458                cloudsat_pflag(i,pr) = pClass_noPrecip                   ! TSL: Not Raining
459             endif
460          endif ! Ocean points
461         
462          ! ################################################################################
463          ! 2b) Land points.
464          ! ################################################################################
465          if (land(i) .eq. 1) then
466             ! Find Zmax, the maximum reflectivity value in the attenuated profile (Ze_out);
467             Zmax=maxval(Ze_out(i,pr,:))
468
469             ! Snow (T<273)
470             if(t2m(i) .lt. 273._wp) then
471                if(Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(5)) then
472                   cloudsat_pflag(i,pr) = pClass_Snow2                      ! JEK: Snow certain
473                endif
474                if(Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(6) .and. &
475                     Ze_out(i,pr,cloudsat_preclvl).le.Zbinvallnd(5)) then
476                   cloudsat_pflag(i,pr) = pClass_Snow1                      ! JEK: Snow possible
477                endif
478             endif
479             
480             ! Mized phase (273<T<275)
481             if(t2m(i) .ge. 273._wp .and. t2m(i) .le. 275._wp) then
482                if ((Zmax .gt. Zbinvallnd(1) .and. cloudsat_precip_pia(i,pr).gt.30) .or. &
483                     (Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(4))) then
484                   cloudsat_pflag(i,pr) = pClass_Mixed2                     ! JEK: Mixed certain
485                endif
486                if ((Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(6)  .and. &
487                     Ze_out(i,pr,cloudsat_preclvl) .le. Zbinvallnd(4)) .and. &
488                     (Zmax .gt. Zbinvallnd(5)) ) then
489                   cloudsat_pflag(i,pr) = pClass_Mixed1                     ! JEK: Mixed possible
490                endif
491             endif
492
493             ! Rain (T>275)
494             if(t2m(i) .gt. 275) then
495                if ((Zmax .gt. Zbinvallnd(1) .and. cloudsat_precip_pia(i,pr).gt.30) .or. &
496                     (Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(2))) then
497                   cloudsat_pflag(i,pr) = pClass_Rain3                      ! JEK: Rain certain
498                endif
499                if((Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(6)) .and. &
500                     (Zmax .gt. Zbinvallnd(3))) then
501                   cloudsat_pflag(i,pr) = pClass_Rain2                      ! JEK: Rain probable
502                endif
503                if((Ze_out(i,pr,cloudsat_preclvl) .gt. Zbinvallnd(6)) .and. &
504                     (Zmax.lt.Zbinvallnd(3))) then
505                   cloudsat_pflag(i,pr) = pClass_Rain1                      ! JEK: Rain possible
506                endif
507                if(cloudsat_precip_pia(i,pr).gt.40) then
508                   cloudsat_pflag(i,pr) = pClass_Rain4                      ! JEK: Heavy Rain
509                endif
510             endif
511             
512             ! No precipitation
513             if(Ze_out(i,pr,cloudsat_preclvl).le.-15) then
514                cloudsat_pflag(i,pr) =  pClass_noPrecip                     ! JEK: Not Precipitating
515             endif         
516          endif ! Land points
517       enddo ! Sub-columns
518    enddo    ! Gridpoints
519
520    ! ######################################################################################
521    ! COLUMN processing
522    ! ######################################################################################
523
524    ! Aggregate subcolumns
525    do i=1,Npoints
526       ! Gridmean precipitation fraction for each precipitation type
527       do k=1,nCloudsatPrecipClass
528          if (any(cloudsat_pflag(i,:) .eq. k-1)) then
529             cloudsat_precip_cover(i,k) = count(cloudsat_pflag(i,:) .eq. k-1)
530          endif
531       enddo
532
533       ! Gridmean path integrated attenuation (pia)
534       cloudsat_pia(i)=sum(cloudsat_precip_pia(i,:))
535    enddo
536 
537    ! Normalize by number of subcolumns
538    where ((cloudsat_precip_cover /= R_UNDEF).and.(cloudsat_precip_cover /= 0.0)) &
539         cloudsat_precip_cover = cloudsat_precip_cover / Ncolumns
540    where ((cloudsat_pia/= R_UNDEF).and.(cloudsat_pia/= 0.0)) &
541         cloudsat_pia = cloudsat_pia / Ncolumns
542
543  end subroutine cloudsat_precipOccurence
544 
545  ! ##############################################################################################
546  ! ##############################################################################################
547  subroutine load_scale_LUTs(rcfg)
548   
549    type(radar_cfg), intent(inout) :: rcfg
550    logical                        :: LUT_file_exists
551    integer                        :: i,j,k,ind
552   
553    ! Load scale LUT from file
554    inquire(file=trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat', &
555         exist=LUT_file_exists)
556   
557    if(.not.LUT_file_exists) then 
558       write(*,*) '*************************************************'
559       write(*,*) 'Warning: Could NOT FIND radar LUT file: ', &
560            trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat'       
561       write(*,*) 'Will calculated LUT values as needed'
562       write(*,*) '*************************************************'
563       return
564    else
565       OPEN(unit=12,file=trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat',&
566            form='unformatted', &
567            err= 89, &
568            access='DIRECT',&
569            recl=28)
570       write(*,*) 'Loading radar LUT file: ', &
571            trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat'
572       
573       do i=1,maxhclass
574          do j=1,mt_ntt
575             do k=1,nRe_types
576                ind = i+(j-1)*maxhclass+(k-1)*(nRe_types*mt_ntt)
577                read(12,rec=ind) rcfg%Z_scale_flag(i,j,k), &
578                     rcfg%Ze_scaled(i,j,k), &
579                     rcfg%Zr_scaled(i,j,k), &
580                     rcfg%kr_scaled(i,j,k)
581             enddo
582          enddo
583       enddo
584       close(unit=12)
585       return
586    endif
587   
58889  write(*,*) 'Error: Found but could NOT READ radar LUT file: ', &
589         trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat'
590   
591  end subroutine load_scale_LUTs
592 
593  ! ##############################################################################################
594  ! ##############################################################################################
595  subroutine save_scale_LUTs(rcfg)
596    type(radar_cfg), intent(inout) :: rcfg
597    logical                        :: LUT_file_exists
598    integer                        :: i,j,k,ind
599   
600    inquire(file=trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat', &
601         exist=LUT_file_exists)
602   
603    OPEN(unit=12,file=trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat',&
604         form='unformatted',err= 99,access='DIRECT',recl=28)
605   
606    write(*,*) 'Creating or Updating radar LUT file: ', &
607         trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat'
608   
609    do i=1,maxhclass
610       do j=1,mt_ntt
611          do k=1,nRe_types
612             ind = i+(j-1)*maxhclass+(k-1)*(nRe_types*mt_ntt)
613             if(.not.LUT_file_exists .or. rcfg%Z_scale_added_flag(i,j,k)) then
614                rcfg%Z_scale_added_flag(i,j,k)=.false.
615                write(12,rec=ind) rcfg%Z_scale_flag(i,j,k), &
616                     rcfg%Ze_scaled(i,j,k), &
617                     rcfg%Zr_scaled(i,j,k), &
618                     rcfg%kr_scaled(i,j,k)
619             endif
620          enddo
621       enddo
622    enddo
623    close(unit=12)
624    return
625   
62699  write(*,*) 'Error: Unable to create/update radar LUT file: ', &
627         trim(rcfg%scale_LUT_file_name) // '_radar_Z_scale_LUT.dat'
628    return 
629   
630  end subroutine save_scale_LUTs
631  ! ##############################################################################################
632  ! ##############################################################################################
633  subroutine quickbeam_init()
634
635   
636  end subroutine quickBeam_init
637  ! ##############################################################################################
638  ! ##############################################################################################
639
640
641end module quickbeam
642
643
Note: See TracBrowser for help on using the repository browser.