NAME:
	qsmei_hdr
 PURPOSE:
	Plot time series for quantities in SMEI frame headers
 CATEGORY:
	camera/idl/toolbox/hdr
 CALLING SEQUENCE:
	PRO qsmei_hdr, hdr, _extra=_extra, usedb=usedb, get=get
 INPUTS:
	hdr_or_time	array; type: header or time structure
			    a time structure is passed to smei_getfile
			    to get the matching headers.
 OPTIONAL INPUTS:
	/usedb	    by default the "hdr" data base is used.
		    If /usedb is set then the CCD frames are read instead
	get=get     array; type: string
		    default: ['FRAME_NR','MODE','SHUTTER','LED_ENABLED','FLAT_ENABLED','CCD_TEMP']
		    list of entries to be plotted
		    To get a list of valid entries type:
		    print, tag_names({smei_frm_hdr})
 OUTPUTS:
	(to draw widget)
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	InitVar, IsTime, IsType, qLine, smei_getfile, smei_hdr_get, smei_property
 PROCEDURE:
 MODIFICATION HISTORY:
	JUN-2004, Paul Hick (UCSD/CASS)
	JAN-2006, Paul Hick (UCSD/CASS; pphick@ucsd.edu)
	    More general implementation. The old one only plotted
	    the current default 'get' entries.

 NAME:
	qsmei_sky
 PURPOSE:
	Widget 'wrapper' for the compound widget qImage_cw
 CATEGORY:
	Widgets
 CALLING SEQUENCE:
	qsmei_sky, filter, image=image, group=group, img_offset=img_offset, wid_base=wid_base
 INPUTS:
	filter		scalar; type: string; default: *.*
			    file name filter for file selection
			    If the filter does not contain a wildcard (i.e. is the
			    name of a single file) then an attempt is made to load
			    the image from the file.
 OPTIONAL INPUT PARAMETERS:
	group=group	scalar; type: long integer
			    group leader passed to XMANAGER
	image=image	array[n,m]; type: any
			    image array to be displayed. If specified this image
			    is displayed, overriding the filter specification.
	wid_base=wid_base
			scalar; type: long integer
			    if this is the widget ID of a valid widget, then
			    qImage assumes that it is an existing instance of
			    itself and will use it to display the image
			    Otherwise qImage will create a new instance.
 OUTPUTS:
	(to widget)
 CALLS: ***
	CW_FIELD, FILEPATH, InitVar, IsType, QSMEI_SKY_CLEAN, QSMEI_SKY_EVENT
	QSMEI_SKY_GAIN, QSMEI_SKY_SAVE, QSMEI_SKY_TRACKPEAK, XMANAGER, qImage_cw
	qsmei_sky_FileInfo, qsmei_sky_pick, smei_sky_field, unexpected_event
 PROCEDURE:
	The state structure is as follows:

	state = {STATE_QSMEI_SKY,   $
	    wid_send	    : 0L,   $	    Row base widget
					    user value: widget ID of widget to receive QIMAGE_SEND
						events (set by qImage_SendDestination)
	    wid_exit	    : 0L,   $	    'Done' button
					    user value: none
	    wid_pick	    : 0L,   $	    'Image' button for selection of image file
					    user value: none
	    wid_filter	    : 0L,   $	    cw_field for entering file filter for image file selection
					    user value: none
	    wid_qimage_cw   : 0L,   $	    compound widget qimage_cw
					    user value: none
	    wid_info	    : 0L,   $	    'Info' button to display information about the current image
					    user value: string array containing information about image
	    wid_clean	    : 0L,   $
	    wid_save	    : 0L,   $
	    wid_magnify     : 0L,   $
	    foreign	    : 0     $	    set by qImage_SendDestination using keyword 'foreign'; controls how
					    qImage reacts to QIMAGE_CW_UPDATE events from qImage_cw compound widget.
					    foreign=0: ignore events
					    foreign=1,2: call qImage_TrackPeak (used by the 'Track' option in qView).
	    boxes	    : fltarr(2,2,2)	$
	    }
 MODIFICATION HISTORY:
	FEB-2000, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	qsmei_sky_FileInfo
 PURPOSE:
	Display information about current image file
 CATEGORY:
	Widget qImage
 CALLING SEQUENCE:
	PRO qsmei_sky_FileInfo, state
 INPUTS:
	state	    array[1]; type: structure
			qImage state structure
 OUTPUTS:
	(to message dialog)
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	IsType
 CALLED BY:
	qsmei_sky
 PROCEDURE:
	Displays the string stored in the user value of state.wid_info in
	a message dialog box when the state.wid_info is pushed.
	The user value is set by qImage_Pick.
 STATE INFO USED:
	widget_control, state.wid_info, get_uvalue=info
 MODIFICATION HISTORY:
	FEB-2000, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	qsmei_sky_pick
 PURPOSE:
	Called by qsmei_sky_Event to select a new image using the IDL 'pickfile' dialog.
 CATEGORY:
	I/O
 CALLING SEQUENCE:
	FUNCTION qsmei_sky_pick, state, event, skymap
 INPUTS:
	state		scalar, type: structure
			    the state structure for the qImage widget
 OUTPUTS:
	status	    scalar; type: byte
			0: if no image read
			1: if image available
	image	    array[n,m]; type: any
			2D array if image file succesfully read, or doesn't exist
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	GetFileSpec, IsTime, IsType, TimeGet, flt_string, hide_env, smei_filename, smei_sky
	smei_sky_field, strreverse, unhide_env, unique_only
 CALLED BY:
	qsmei_sky
 PROCEDURE:
 >	The value of state.wid_filter (displayed in the widget) is checked for
	wildcards.
 >	If a wildcard is found then the filter isused to initialize the 'pickfile'
	dialog, pick a file and read the file
 >	If no wildcard is present then the file is read
 >	The return value is 0 or 1 depending on whether an image was read succesfully.
 >	The user value of state.wid_info is set with a string containing
	file name, image dimensions and (optionally) image info (if present).
 STATE INFO USED:
	widget_control, state.wid_filter, get_value=filter
 STATE INFO MODIFIED:
	widget_control, state.wid_info, set_uvalue=info, /no_copy
 MODIFICATION HISTORY:
	FEB-2000, Paul Hick (UCSD/CASS)