NAME:
	even_light
 PURPOSE:
	Program used for the certification of the SMEI cameras using
	the light box data take in the 3th floor clean room.
 CATEGORY:
	stuff
 CALLING SEQUENCE:
 INPUTS:
 OPTIONAL INPUT PARAMETERS:
 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:
 CALLS: ***
	ArrayLocation, BadValue, CV_COORD, CenterOfMass, EVEN_LIGHT_BIN_PHI
	EVEN_LIGHT_BIN_RAD, EVEN_LIGHT_CENTROID, EVEN_LIGHT_FIRSTGUESS
	EVEN_LIGHT_GEOMETRIC_FIX, EVEN_LIGHT_PRORATE, EVEN_LIGHT_SHIFT
	EVEN_LIGHT_VIEW, FILEPATH, InitVar, Inside_Wedge, MEAN, REVERSE, SuperArray, TimeOp
	TimeSystem, TimeUnit, WhatIs, bin_read, bin_write, destroyvar, even_light_background
	even_light_corrections, even_light_pedestal, even_light_photometry
	even_light_registration, flat_centerofmass, gridgen, img_read, lsqCircleFit
	lsqQuadraticFit, twin, view, wedge_bounding_box
 PROCEDURE:
 MODIFICATION HISTORY:
	???-200?, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_background
 PURPOSE:
 INPUTS:
	adus
	gain
	P1
	P2
 OUTPUTS:
	Background corrected adus
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLED BY:
	even_light, even_light_info
 PROCEDURE:
	Calculate (adus-P1)/gain-P2
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_corrections
 PURPOSE:
 CATEGORY:
 INPUTS:
	hhvv		    identifies frame sequence
	spot_centroid	    x-y coordinates of spot centroids (relative to center0)
	good_spot	    list of spot indices to be used for obtaining corrections
	bins_axis
	bins_step
	img_nr
	center0 	    center of fov arc (pix)
 OUTPUTS:
	center0
	dcenter
	optaxis0
	doptaxis
	binwidth
	dbinwidth
	y_run
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	CV_COORD, FILEPATH, InitVar, IsDisplay, MEAN, SuperArray, get_page, lsqCircleFit
	lsqQuadraticFit, qset_page, set_page, twin
 CALLED BY:
	even_light, even_light_info
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_figures
 PURPOSE:
	Draw stuff
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
CALLS
InitVar
 CALLS: ***
	InitVar, MEAN, QBARGRAPH, STDDEV, flt_read, gridgen, plot3darc, plot3dline, plot3dtext
	setup3d, twin
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_info
 PURPOSE:
 CATEGORY:
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	BadValue, CORRELATE, FILEPATH, InitVar, IsType, MEAN, QPLOT, STDDEV, SuperArray, bargraph
	bin_read, destroyvar, even_light_background, even_light_corrections
	even_light_pedestal, even_light_photometry, even_light_plot
	even_light_registration, lsqNormalFit, twin
 PROCEDURE:
  0: prints table of geometric constants to screen
	    /widget	calls qplot widget
  1: scatter plot: X0 vs. Y0
  2: scatter plot: phi0 vs. R0
  3: scatter plot: dX0 vs. dY0
  4: scatter plot: VP vs. VR
  5: scatter plot: bin widths vs. change in binwidth

  6: scatter plot: P1+P2 vs. P2
  7: widget with P1+P2, P1, P2 (including errors)
  8: prints table of pedestal determination
	    /redo: uses adu_per_bin to recalculate pedestals before printing

	    if run_id is specified (single run) then a scatter plot of gain
	    vs. residual background for all images in the run is displayed.
	    if keyword /raw is set then gain vs. raw background is displayed

	    /excl_img: list of images to be excluded from recalculation of
	    pedestals and scatter plots.

  9: photometric certification summary
	    displays summary plot of photometry: histgram of relative
	    photometric errors for all spots; gain, blank readout, dark reference
	    readout, raw background and residual background as a function of image
	    number.

	    if keyword /spots is set, all residual time series are plotted before
	    displaying the summary plot

	    if run_id is not specified (all_runs) then the qplot widget is shown
	    with the median photometic error for all runs.

	    if keyword /redo is set than the gains are recalculated using
	    the adu_per_bin array. Keyword excl_img can be used to exclude images
	    from the recalculation.
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_pedestal
 PURPOSE:

 CATEGORY:
	camera/idl/cert
 CALLING SEQUENCE:
 INPUTS:
 OPTIONAL INPUT PARAMETERS:
 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	InitVar, LINFIT, LocalExtrema, MEAN, gridgen
 CALLED BY:
	even_light, even_light_info
 PROCEDURE:
 MODIFICATION HISTORY:
	???-200?, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_photometry
 PURPOSE:
 CATEGORY:
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	BadValue, FILEPATH, InitVar, IsDisplay, IsType, MEAN, STDDEV, bargraph, destroyvar
	get_page, qset_page, set_page, twin
 CALLED BY:
	even_light, even_light_info
 PROCEDURE:
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_platescale
 PURPOSE:
 INCLUDE:
	@compile_opt.pro	; Return to caller
 CALLS: ***
	MEAN, STDDEV, gridgen
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_plot
 PURPOSE:
 CATEGORY:
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	InitVar, MEAN, STDDEV, twin
 CALLED BY:
	even_light_info
 PROCEDURE:
 MODIFICATION HISTORY:
	???-????, Paul Hick (UCSD/CASS; pphick@ucsd.edu)

 NAME:
	even_light_registration
 PURPOSE:
 CATEGORY:
 CALLING SEQUENCE:
 INPUTS:
 OPTIONAL INPUT PARAMETERS:
 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:
 INCLUDE:
	@compile_opt.pro	; On error, return to caller
 CALLS: ***
	BadValue, CV_COORD, FILEPATH, InitVar, IsDisplay, LINFIT, PlotCurve, STDDEV, bargraph
	get_page, qset_page, set_page, twin
 CALLED BY:
	even_light, even_light_info
 PROCEDURE:
 MODIFICATION HISTORY:
	???-200?, Paul Hick (UCSD/CASS; pphick@ucsd.edu)