source: trunk/MESOSCALE_DEV/PLOT/RESERVE/obsolete/out_diagfi.pro @ 207

pro out_diagfi, $
                plot=plot_user, $               ; 'map', 'profile' (default is 'map')
        ;----------------
        ; input fields
        ;----------------
                field1=field_user, $            ; field to contour: 'u', 'v', 'temp', ... etc ...
                field2=fieldc_user, $           ; field to overplot (contour lines, optional)
        ;------------------------------------------------------
        ; 'map' options (no effect when plot is 'profile')
        ;------------------------------------------------------
                topo=topo, $                    ; overplot topography contours (!! must load phisinit !! override field2)
                winds=winds, $                  ; option to overplot winds (e.g. =['U','V'])
                level=level, $                  ; vertical level subscript (starts at 1 ...)(if -1: all levels)
        ;------------------------------------------------------
        ; 'profile' options (no effect when plot is 'map')
        ;------------------------------------------------------
                inprofile=inprofile, $          ; a profile to compare with ... (override field2)
                incolumn=incolumn, $            ; altitudes ... in case /= column
                ;; NB: inprofile and incolumn may be used to output profiles
                ;; ... reset with inprofile=0, incolumn=0
        ;----------------
        ; choose time
        ;----------------
                when=when, $                    ; time subscript (starts at 1 ...)(if -1: first time step)
        ;----------------
        ; plot options
        ;----------------
                range=range_user, $             ; range=[min,max]
                colors=colors, $                ; 16, 32, 64, ... etc
        ;-------------------------
        ; no useless data loading
        ;-------------------------
                save_data=save_data             ; to avoid loading data if already done once


;---------------------------------------------------------------------------
;
; A general routine to plot diagfi.nc GCM outputs
;
; USE: see out_wrf
;
;---------------------------------------------------------------------------
; A. Spiga, August 2007, adding plot keyword September 2007
;---------------------------------------------------------------------------



;-------------------------------------
; default settings and user settings
;-------------------------------------
charend=''
diff_scale=0  ;1
if (n_elements(plot_user) eq 0) then plot_user='map'
if (n_elements(field_user) eq 0) then field_user='all'
if (n_elements(level) eq 0) then level=-1
if (n_elements(when) eq 0) then when=-1
if (n_elements(colors) eq 0) then colors=32
if (n_elements(minfield_init)*n_elements(maxfield_init) eq 0) then begin
        minfield_init = 0.
        maxfield_init = 0.
endif

if (n_elements(range_user) eq 2) then begin
        minfield_init=float(range_user(0))
        maxfield_init=float(range_user(1))
        print, 'setting user limits !', minfield_init, maxfield_init 
        diff_scale=1
endif



;******************************************************************************
;
; BEGIN: different from out_wrf
;
;******************************************************************************

;TEMP TEMP
vert_coord='sigma'
;vert_coord='pressure'
;vert_coord='height'
;TEMP TEMP

;----------------------
; set parameters
;----------------------
file='input.diagfi'
if (n_elements(topo) ne 0) then fieldc_user='phisinit'  ;case with topography



;----------------------------------------------------
; Open diagfi file GCM and get coordinates & field
;----------------------------------------------------
cdfid = ncdf_open(file)

print, 'read coord ...'
varid=ncdf_varid(cdfid,'latitude')
        ncdf_varget, cdfid, varid, lat_gcm
varid=ncdf_varid(cdfid,'longitude')
        ncdf_varget, cdfid, varid, lon_gcm
varid=ncdf_varid(cdfid,'Time')
        ncdf_varget, cdfid, varid, hour
lon=lon_gcm
west_east=n_elements(lon)
lat=lat_gcm
south_north=n_elements(lat)
print, 'done !'
;;print, 'time ...', hour*24 MOD 24, ' hours and day number ', ceil(hour)

; field
if (n_elements(save_data) eq 0) then begin
        print, 'read data ...'
        varid=ncdf_varid(cdfid,field_user)
                ncdf_varget, cdfid, varid, var
                bottom_top=n_elements(var(0,0,*,0))
                time=n_elements(var(0,0,0,*))
;save_array=fltarr(3,west_east,south_north,bottom_top,time)
;save_array(0,*,*,*,*)=var(*,*,*,*)
;;**NB: ralentit beaucoup
        print, 'done !'
endif else begin        
        var=reform(save_data(0,*,*,*,*))
                bottom_top=n_elements(var(0,0,*,0))
                time=n_elements(var(0,0,0,*))
endelse

print, 'vertical levels in file ... ', bottom_top
print, 'time steps in file ...', time



        ;-----------------------------
        ; min/max on the whole field
        ;-----------------------------
        w=where(abs(var) lt 1e30)
        if (w(0) ne -1) then begin
                minfield=min(var[w])
                maxfield=max(var[w])
                        ;;; manage unvalid points
                        ;;;w=where(var eq 1e37)
                        ;;;if (w(0) ne -1) then var[w]=!Values.F_NAN
        endif else begin
                var=0
                print, 'no valid values in this field', charvar 
        endelse



;---------------------
; Get altitude
;---------------------
if (vert_coord ne 'pressure') then begin
        print, 'read altitude ...'
        varid=ncdf_varid(cdfid,'aps')
                ncdf_varget, cdfid, varid, aps
        varid=ncdf_varid(cdfid,'bps')
                ncdf_varget, cdfid, varid, bps
        varid=ncdf_varid(cdfid,'ps')
                ncdf_varget, cdfid, varid, ps
        varid=ncdf_varid(cdfid,'altitude')
                ncdf_varget, cdfid, varid, z
        print, 'done !'
endif else begin
        print, 'read altitude ...'
        varid=ncdf_varid(cdfid,'altitude')
                ncdf_varget, cdfid, varid, z
        z=z/100.   ;mbar
        print, 'done !'
endelse


;-------------
; Get winds
;-------------
if (n_elements(winds) ne 0) then begin
if (n_elements(save_data) eq 0) then begin
        print, 'read winds ...'
        varid=ncdf_varid(cdfid,winds(0))
                ncdf_varget, cdfid, varid, u
        varid=ncdf_varid(cdfid,winds(1))
                ncdf_varget, cdfid, varid, v
        ;save_array(1,*,*,*,*)=u(*,*,*,*)
        ;save_array(2,*,*,*,*)=v(*,*,*,*)
        print, 'done !'
endif else begin        
        u=reform(save_data(1,*,*,*,*))
        v=reform(save_data(2,*,*,*,*))
endelse
endif

;-------------------------------
; Get another field to contour
;-------------------------------
if (n_elements(fieldc_user) ne 0) then begin
        print, 'get alternate field ...'
        varid=ncdf_varid(cdfid,fieldc_user)
                ncdf_varget, cdfid, varid, varcontour
        print, 'done !'
endif


;;-------------------------------
;; Save data for further use ...
;;-------------------------------
;if (n_elements(save_data) eq 0) then begin
;       save_data=save_array
;       save_array=0. ;free 'save_array' array
;endif


;---------------------------------
; Some stuff for continuity
;---------------------------------
;;if (vert_coord ne 'pressure') then surfpres=reform(ps(*,*,nt))
;;A CORRIGER - A METTRE DANS LA BOUCLE
if (vert_coord ne 'pressure') then surfpres=reform(ps(*,*,0))
if (vert_coord eq 'sigma') then begin
        z=aps/surfpres(0,0)+bps
        z=z*100.
        vert_coord='model_level'
endif
charend='_diagfi'

case field_user of 
'temp': charvar='tk'
'u': charvar='U'
'v': charvar='V'
'ps': charvar='PSFC'
else:
endcase

;;
;;


;******************************************************************************
;
; END: different from out_wrf
;
;******************************************************************************



;----------------------
; initialize graphics
;----------------------

!p.charthick = 2.0
!p.thick = 3.0
!x.thick = 2.0
!y.thick = 2.0

if (when ne -1) then charend=charend+string(when, '(I0)')

set_plot, 'ps'
device, filename=plot_user+'_'+vert_coord+'_'+charvar+charend+'.ps', /color

case charvar of
'tk': begin
        title='Temperature (K)'
        pal=3
end
'U': begin
        title='Zonal wind (!Nm!N.s!U-1!N)'
        pal=33
end
'V': begin
        title='Zonal wind (!Nm!N.s!U-1!N)'
        pal=33
end
'pressure': begin
        title='Pressure (hPa)'
        pal=16
end
'height': begin
        title='Height (km)'
        pal=16
end
'T': title='Potential temperature departure from t0 (K)'
'W': title='Vertical wind (!Ncm!N.s!U-1!N)'
else: title=''
endcase
title_save=title



;---------------------------------
; choose positioning ...
;---------------------------------

case plot_user of
'map': begin
;
; 1. map: looping on vertical levels
;
        if (level eq -1) then begin
                theloopmin=0
                theloopmax=bottom_top-1
        endif else begin
                theloopmin=level-1 ;!! IDL arrays starts at 0
                theloopmax=level-1
        endelse 
        if (when eq -1) then nt = 0 else nt=when-1
end
'profile': begin
;
; 2. profile: looping on time
;
        ;;discrete=4
        title_axis=strarr(2)
        title_axis(0)=title_save
        if (when eq -1) then begin
                theloopmin=0
                theloopmax=time-1
        endif else begin
                theloopmin=when-1 ;!! IDL arrays starts at 0
                theloopmax=when-1
        endelse 

        column=z
        case vert_coord of
                'height': title_axis(1)='Altitude (km)'
                'pressure': begin
                        H=10.
                        p0=6.1
                        column=H*alog(p0/z)
                        title_axis(1)='Log-Pressure altitude (km)'
                end
                'model_level': title_axis(1)='Model level'
        endcase

;****TEMP
nx=round(west_east/2)
ny=round(south_north/2)
;****TEMP

        displaylat=float(round(lat(ny)*100))/100.
        displaylon=float(round(lon(nx)*100))/100.
        description='WRF Profile at latitude '+string(displaylat,format='(1F6.2)')+$
        '!Uo'+'!N and longitude '+string(displaylon,format='(1F7.2)')+'!Uo!N '
        title=description

end
else: stop
endcase


;-------------
; plot loop
;-------------  
for theloop=theloopmin,theloopmax do begin

case plot_user of
'map': begin
        ;
        ; case 1: map
        ;       
        case vert_coord of
        'height': charlev=string(round(z(theloop)*1000.),'(I0)')+' m'
        'pressure': charlev=string(round(z(theloop)*100.),'(I0)')+' Pa'
        'model_level': charlev=string(round(z(theloop)),'(I0)')
        endcase
        title=title_save+' at level '+charlev
        print, title

        ;-------------
        ; draw map
        ;-------------

        what_I_plot=var[*,*,theloop,nt]

        if (diff_scale eq 0) then begin
                minfield_init=minfield  ;-same scale for all levels 
                maxfield_init=maxfield  ;-same scale for all levels
        endif
        if (n_elements(fieldc_user) eq 0) then begin
                overcontour=0.
        endif else begin
                if (n_elements(topo) ne 0) then begin
                        overcontour=varcontour[*,*,0,0] ; other levels than 0 are blank !
                endif else begin
                        overcontour=varcontour[*,*,theloop,nt]
                endelse
        endelse
        if (n_elements(winds) eq 0) then begin
                overvector_x=0.
                overvector_y=0.
        endif else begin
                overvector_x=u[*,*,theloop,nt]
                overvector_y=v[*,*,theloop,nt]
        endelse


        map_latlon, $
                what_I_plot, $
                lon, $
                lat, $
                ct=pal, $
                minfield=minfield_init, $
                maxfield=maxfield_init, $
                overcontour=overcontour, $
                overvector_x=overvector_x, $
                overvector_y=overvector_y, $
                colors=colors, $
                title=title
end
'profile': begin
        ;
        ; case 2: profile
        ;
        print, title

        what_I_plot=var[nx,ny,*,theloop]
        if (diff_scale eq 0) then begin
                minfield_init=minfield  ;-same scale for all levels 
                maxfield_init=maxfield  ;-same scale for all levels
        endif
        if (n_elements(fieldc_user) eq 0) then begin
                overcontour=0.
                overcontourz=0.
        endif else begin
                overcontour=varcontour[nx,ny,*,theloop]
                overcontourz=0.
        endelse
        if (n_elements(inprofile) gt 1) then begin
                overcontour=inprofile
                overcontourz=0.
                if (n_elements(incolumn) gt 1) then overcontourz=incolumn
        endif

        profile, $
                what_I_plot, $                          ; 1D vertical profile
                column, $                               ; altitudes     
        ;       alt=alt, $                              ; altitude range [altmin, altmax]
                minfield=minfield_init, $               ; minimum value of plotted field (=0: calculate)
                maxfield=maxfield_init, $               ; maximum value of plotted field (=0: calculate)
                inprofile=overcontour, $                ; another vertical profile to overplot
                incolumn=overcontourz, $                ; altitudes of the other vertical profile (in case /= column)
                title_plot=title, $                     ; title of the plot ('Profile' is default)
                title_axis=title_axis, $                ; title of the [x,y] axis (['Field','Altitude'] is default)
        ;       mention=mention, $                      ; add text precision within the plot window (default is nothing or '')
                discrete=discrete                       ; show the profile points (= type of points in !psym)
end
else: 
endcase



endfor
device, /close

        ; save the profiles for another plot (last of the time loop)
        if ((n_elements(inprofile) le 1) and (plot_user eq 'profile')) then begin
                inprofile=what_I_plot
                incolumn=column
        endif


;******************************************************************************
;
; BEGIN: different from out_wrf
;
;******************************************************************************
;;;skip:
;;;endfor

end