CHKNCCAL

Name

chknccal

Purpose

Review and grade calibration images for nasacam.

Description

Widget searches the nasacam.calib and nasacam.image tables to build
lists of calibration entries and associated raw and [sub]super calibration
images. It allows an interactive search based on date range, filters,
calibration type, and calibration status to fill a scrollable list of
calibration entries. By default, the entries searched are flats for all
dates and filters with pending status. When an entry is selected, another
list with individual images is populated, and a thumbnail view of the
calibration product (eg, sub super flat) is presented. Individual images
may be selected and displayed, and the status of the calibration entry
may be modified in the data base. Image display occurs in a separate
reused ITOOL window. The image display may be set to either raw or
processed mode. In processed mode, each image is divided
by its proper [sub]superflat after subtraction of overscan and
appropriate superbias image (which is chosen as the superbias with good
status nearest in time).

Calling Sequence

chknccal

Inputs

Optional Input Parameters

Keyword Input Parameters

CALROOT - string giving the path to locate the calibration images referenced
in the data base entries, and created by addnccal.
The current default is
'/kolvir/data1/buie/rawfits/nasacamcal' (on kolvir).
CALTABLENAME- Name of table in MYSQL database for calibration entries.
The default is 'calib'.
CROP - region of original image to save, [x1,x2,y1,y2]
default is 2006 NASACAM default of [21, 2064, 3, 2046].
DATABASE - Name of MYSQL database for calibration entries.
The default is 'nasacam'.
IMGROOT - string giving the path to locate the image files referenced
in the data base entries. The default is
'/kolvir/data1/buie/rawfits' (on kolvir).
IMGTABLENAME- Name of table in MYSQL database for image entries.
The default is 'image'.
INSTTABLENAME- Name of table in MYSQL database for instrument entries.
The default is 'instrument'.
KEYFILE- Default keyfile for PARSEKEY. The default is to provide
a default key list suitable for nasacam data.
OVERSCAN - column overscan region to use for frame bias level,
default is 2006 NASACAM default of [2069, 2103].

Outputs

No outputs for this procedure.

Keyword Output Parameters

Common Blocks

Side Effects

Data base entries are updated.

Restrictions

Assumes images are located in subdirectories named YYYYMMDD for each night.
They may be either of the form YYYYMMDD.nnn or YYYYMMDD.nnn.fits
Places calibration products in paths named YYYY/MM/DD for each night.
It currently processes data ONLY for the NASACAM CCD on the 31", and there
is no support for dark images.
Image frame numbers must be in the range 1-999 inclusive.

Procedure

Modification History

2006/08/07, Written by Peter L. Collins, Lowell Observatory
2006/08/10, PLC, fixes to support proper update of edit status
buttons with calibration selection, add 'unknown'
to editable status states, and proper update of
thumbnail and image itool windows on requery & refresh
2006/08/12, PLC, fixed a bug in the main SQL query that prevented biases
from displaying when a filter was selected, also a bug in
chknccal_list that occasionally caused the subsuper
thumbnail to be displayed in a separate window.
2006/08/19, PLC, cleanups, made sure dblun closed on exit and
set /NO_RELEASE on the Raw/Processed and Set Status
radio buttons to eliminate redundant operations.