pro read_haloe_vpmc_climatology,file,$
        yeargrid,doygrid,latgrid,z1,$
        nob_grid,fpmc_grid,$
       pmcz_grid,pmcz_sd_grid,$
     pmcemx_grid,pmcemx_sd_grid,$
       
         t_gridz,    t_sd_gridz,$
         p_gridz,    p_sd_gridz,$
       h2o_gridz,  h2o_sd_gridz,$
        o3_gridz,   o3_sd_gridz,$
        no_gridz,   no_sd_gridz,$
      a245_gridz, a245_sd_gridz,$
      a340_gridz, a340_sd_gridz,$
      a346_gridz, a346_sd_gridz,$
      a526_gridz, a526_sd_gridz,$
      a626_gridz, a626_sd_gridz

;--------------------------------------------------------------------------------
;
; Restores a HALOE Vpmc climatology file and returns the variables.
;
; The HALOE files are available online at:  
; http://gwest.gats-inc.com/haloe_pmc_project/HALOE_PMC_project.html
;
; Input:
;   file......complete path + name of the HALOE climatology file
;
; Output:
;   yeargrid......year for the time axis
;   doygrid.......day of year for the time axis
;   lat_grid......the latitude axis, deg
;   z1............altitude, km
;
;   The following are all arrays of (time, latitude):
;   nob_grid........# HALOE observations in each lat-time bin
;   fpmc_grid.......PMC frequency in each bin, %
;   pmcz_grid.......mean PMC altitude in each bin, km
;   pmcz_sd_grid....std. deviation of PMC altitude, km
;   pmcemx_grid.....mean of brightest 3.40 micron PMC extinction in each bin, 1/km
;   pmcemc_sd_grid..std. deviation of brightest 3.40 micron PMC extinction, 1/km

;   The following are all arrays of (time, latitude, altitude):
;   t_gridz.......temperature, K
;   t_sd_gridz....temperature standard deviation, K
;   p_gridz.......pressure, mb
;   p_sd_gridz....pressure standard deviation, mb
;   h2o_gridz.......H2O, ppmv
;   h2o_sd_gridz....H2O standard deviation, ppmv
;   o3_gridz.......o3, ppmv
;   o3_sd_gridz....o3 standard deviation, ppmv
;   no_gridz.......NO, ppbv
;   no_sd_gridz....NO standard deviation, ppbv
;   a245_gridz.......2.45 mmicron PMC extinction, 1/km
;   a245_sd_gridz....2.45 um ext. standard deviation, 1/km
;   etc...
;
; Source: Mark Hervig
;
;--------------------------------------------------------------------------------

;- restore the HALOE Vpmc climatology file

   restore,filename=file
   
;- done
   
   return
   end