NAME: thm_asi_Imager_Readfile PURPOSE: This is intended to be a general tool for reading THEMIS-GBO imager data. At the moment it only deals with PGM files and has only been lightly tested on full (256x256) and row2 (376x1) frames. CATEGORY: Themis, Imager, File reading CALLING SEQUENCE: THM_ASI_IMAGER_READFILE,Filename,Images,[Metadata] INPUTS: Filename a string or array of strings containing valid image filenames or wildcard search expressions as used in "findfile". KEYWORDS: COUNT returns the number of image frames ALL_METADATA set to obtain more metadata, much slower (default=0) DEBUG set to increase verbosity (default=0) OUTPUTS: Images a WIDTH x HEIGHT x NFRAMES array of unsigned integers or bytes Metadata a NFRAMES element array of structures RESTRICTIONS: TBD EXAMPLES: Get one file, watch frames as movie filename="20051225_1100_whit_themis07_full.pgm.gz" THM_ASI_IMAGER_READFILE,filename,images,metadata,COUNT=nframes FOR indx=0,nframes-1 DO TVSCL,images[*,*,indx] Get 1 hour of data, summarize and display as keogram directory="\\themis-data\data\themis\imager\stream0\2005\12\25\whit_themis07\ut11\" THM_ASI_IMAGER_READFILE,directory+"*full.*",images,metadata,COUNT=nframes,/DEBUG keogram= TRANSPOSE(TOTAL(images[96:159,*,*],1)) TVSCL,keogram,ORDER=1 NOTES: PGM format is described on NetPBM home page at http://netpbm.sourceforge.net gzipped files (*.pgm.gz) can be read directly in IDL, bzip2 cannot early data (eg. ATHA 2004) were in PNG format with 1 frame per file MODIFICATION HISTORY: 2006-03-09 Bjj assembly and preliminary documentation VERSION: $LastChangedBy$ $LastChangedDate$ $LastChangedRevision$ $URL$