source: trunk/SRC/ToBeReviewed/GRILLE/t2v.pro @ 370

;+
;
; @file_comments
; Allows to pass a field referring to the grid T on the grid V, 
; thanks to the average res = 0.5*(res + shift(res, 0, -1))
; 
; @categories 
; Grid
;
; @param TEMP {in}{required}
; a 2d, 3d or 4d array
;
; @returns
; a 2d, 3d or 4d array
;
; @uses
; <pro>common</pro>
;
; @restrictions 
; Force parameters of the zoom on the grid V to be the same as 
; those on the grid T.
;
; @restrictions 
; Points which can not be calculated are put at the value NaN 
; consecrated by IDL: !values.f_nan
;
; @history
; From Marina Levy's programs
; Sebastien Masson (smasson\@lodyc.jussieu.fr):
; Validation. 5/6/2000
;
; @version
; $Id$
;
;-
FUNCTION t2v, temp
;
  compile_opt idl2, strictarrsubs
;
@cm_4mesh
@cm_4data
@cm_4cal
  IF NOT keyword_set(key_forgetold) THEN BEGIN
@updatenew
  ENDIF
;---------------------------------------------------------
   res = temp

;We force nxt=nxv, etc ...
   firstxv = firstxt
   lastxv = lastxt
   firstyv = firstyt
   lastyv = lastyt
   nxv = nxt
   nyv = nyt
   vargrid = 'V'
   if NOT keyword_set(valmask) then valmask = 1e20
   lat1 = gphit[0, firstyt]
   lat2 = gphiv[0, lastyv]

; case on tha array's size and application
   taille = size(temp)
   CASE taille[0] OF 
      1: res = -1
      2: BEGIN 
         case 1 of
            taille[1] eq nxt and taille[2] eq nyt:
            taille[1] eq jpi and taille[2] eq jpj: $
             res=res[firstxt:lastxt, firstyt:lastyt]
            else: $
             return, report('Probleme d''adequation entre les tailles du domaine et de la boite.')
         endcase
         mask = tmask[firstxt:lastxt, firstyt:lastyt, 0]
         terre = where(mask EQ 0) 
         IF terre[0] NE -1 THEN res[terre] = !values.f_nan
         res = 0.5*(res + shift(res, 0, -1))
         res[*, nyt-1] = !values.f_nan
         mask = (vmask())[firstxt:lastxt, firstyt:lastyt, 0]
         terre = where(mask EQ 0) 
         IF terre[0] NE -1 THEN res[terre] = valmask
      END
      3: BEGIN 
         case 1 of
            taille[1] eq nxt and taille[2] eq nyt AND taille[3] EQ nzt:
            taille[1] eq nxt and taille[2] eq nyt AND taille[3] EQ jpk: $
             res=res[*, *, firstzt:lastzt]
            taille[1] eq nxt and taille[2] eq nyt AND taille[3] EQ jpt:
            taille[1] eq jpi and taille[2] eq jpj AND taille[3] EQ jpk: $
             res=res[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt]
            taille[1] eq jpi and taille[2] eq jpj AND taille[3] EQ jpt: $
             res=res[firstxt:lastxt, firstyt:lastyt, *]
            else: $
             return, report('Probleme d''adequation entre les tailles du domaine et de la boite.')
         ENDCASE
         if taille[3] EQ jpt then begin
            mask = tmask[firstxt:lastxt, firstyt:lastyt, lastzt*(nzt NE jpk)]
            mask = temporary(mask[*])#replicate(1, jpt)
            mask = reform(mask, nxt, nyt, jpt, /over)
         ENDIF ELSE mask = tmask[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt]
         terre = where(temporary(mask) EQ 0) 
         IF terre[0] NE -1 THEN res[temporary(terre)] = !values.f_nan
         res = 0.5*(res + shift(res, 0, -1, 0))
         res[*, nyt-1, *] = !values.f_nan
         if taille[3] EQ jpt then BEGIN
            mask = (vmask())[firstxt:lastxt, firstyt:lastyt, lastzt*(nzt NE jpk)]
            mask = temporary(mask[*])#replicate(1, jpt)
            mask = reform(mask, nxt, nyt, jpt, /over)
         ENDIF ELSE mask = (vmask())[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt]
         terre = where(temporary(mask) EQ 0) 
         IF terre[0] NE -1 THEN res[temporary(terre)] = valmask
      END
      4: BEGIN 
         case 1 of
            taille[1] eq nxt and taille[2] eq nyt AND taille[3] EQ nzt AND taille[4] EQ jpt:
            taille[1] eq nxt and taille[2] eq nyt AND taille[3] EQ jpk AND taille[4] EQ jpt: $
             res=res[*, *, firstzt:lastzt, *]
            taille[1] eq jpi and taille[2] eq jpj AND taille[3] EQ jpk AND taille[4] EQ jpt: $
             res=res[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt, *]
            else: $
             return, report('Probleme d''adequation entre les tailles du domaine et de la boite.')
         ENDCASE
         mask = tmask[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt]
         mask = temporary(mask[*])#replicate(1, jpt)
         mask = reform(mask, nxt, nyt, nzt, jpt, /over)
         terre = where(temporary(mask) EQ 0) 
         IF terre[0] NE -1 THEN res[temporary(terre)] = !values.f_nan
         res = 0.5*(res + shift(res, 0, -1, 0, 0))
         res[*, nyt-1, *, *] = !values.f_nan
         mask = (vmask())[firstxt:lastxt, firstyt:lastyt, firstzt:lastzt]
         mask = temporary(mask[*])#replicate(1, jpt)
         mask = reform(mask, nxt, nyt, nzt, jpt, /over)
         terre = where(temporary(mask) EQ 0) 
         IF terre[0] NE -1 THEN res[temporary(terre)] = valmask
      END
    ENDCASE

  IF NOT keyword_set(key_forgetold) THEN BEGIN
   @updateold
  ENDIF 

   return, res
END