>  Docs Center  >  Libraries  >  Buie  >  ADDNCCAL

ADDNCCAL

ADDNCCAL

Name


  addnccal

Purpose


  Add calibration frames for entries in the nasacam calib data base

Description


  Searches the database nasacam.calib table for entries with
  status=UNKNOWN and attempts to generate appropriate "sub-supers" which
  are superbias, dark, or flat frames for the given range of images. The
  constraints on nasacam flat taking (in particular) are such that these
  super frames will usually need to be combined with others nearby in time,
  thus the term "sub-supers." After generating (without interaction) what it
  can, addnccal will update the calname for the rows processed. Ordinarily
  biases are set to status "GOOD" or "PENDING" based on automatic criteria
  and flats are set PENDING prior to inspection via the tool chknccal.

Category


    CCD data processing

Calling Sequence


  addnccal

Inputs


Optional Input Parameters


Keyword Input Parameters


  ABSMOMENT - A 2 element vector giving the maximum value for absolute mean and
            standard deviation of any superbias generated. This is the
            baseline test for sub super biases. Current default is
            [ 5.0, 5.0] based on a cropping region.
  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).
  COLDTEMPS- An vector of 4 elements giving, respectively, the expected
            CCD detector temperature, the expected cold head temperature,
            and the maximum absolute deviations from those levels for
            individual bias or flat frames to be considered good. The NASACAM
            default is [-100.0, -160.0, 20.0, 50.0].
            This keyword is not implemented and is currently a no-op.
  CROP - region of original image to save, [x1,x2,y1,y2]
            default is 2006 NASACAM default of [34, 2064, 2, 2046].
  DATABASE - Name of MYSQL database for calibration entries.
            The default is 'nasacam'.
  EARLIEST - string in MYSQL date format giving the earliest row in the
            data base to process. The default is the beginning of time.
  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).
  LATEST - string in MYSQL date format giving the latest row in the
            data base to process. The default is the end of time.
  MASTBIAS - Absolute path to a fits file which contains a superbias
            considered good. Superbiases generated by addnccal will be
            subtracted from this, and the mean and standard deviation
            of the resulting array is compared with MASTMOMENT. If not
            specified, this comparison is not made.
            This keyword is not implemented and is currently a no-op.
  MASTMOMENT- A 2 element vector giving the maximum absolute mean and standard
            deviation of the difference array (against MASTBIAS) for a
            generated sub-super-bias to be considered good. MASTMOMENT is
            only meaningful if MASTBIAS is specified. The default is
            [ 300.0, 30.0]
            This keyword is not implemented and is currently a no-op.
  NOMEDIANFLAT- Flag, if set, the JUSTMEDIAN flag is not set to MKFLAT
            when making flats. The default is to set JUSTMEDIAN,
            which is passed to mkflat and precludes noise clipping
            and averaging, when making flats.
  OLEVEL - a 4 element vector giving the expected overscan level and
            the overscan standard deviation, and
            the maximum permitted absolute deviations from those levels for
            individual bias or flat frames to be considered good. The NASACAM
            default is [2800.0, 10.0, 300.0, 30.0].
            This keyword is not implemented and is currently a no-op.
  OVERSCAN - column overscan region to use for frame bias level,
            default is 2006 NASACAM default of [2074, 2103].
  RDNOISE - Read noise of CCD, DN/pixel, default is 2006 NASACAM default of
            9.0
  SCALE - For flats, 4 element vector which, if provide, defines the
            array dimensions that are used to scale the mean
            of the arrays before combining. If combined in this
            manner, the arrays are combined weighted by the means.
                [x1,x2,y1,y2]
            These coordinates apply to the pixel locations AFTER cropping.
            The default is to use the center 50% of the image but not any
            bigger than 200x200 subsection at the center.
            This keyword is passed transparently to mkflat.
  TABLENAME- Name of table in MYSQL database for calibration entries.
            The default is 'calib'.
  TEST - Flag, if set, addnccal prints the mkbias, mkflat, and db
            update commands without running them. It makes the cal
            subdirectories only.
 

Outputs


  No outputs for this procedure.

Keyword Output Parameters


Common Blocks


Side Effects


    Data base entries are updated and calibration superframes are placed in
    CALROOT. New subdirectories will generally be created in CALROOT.
    The calibration superframe outputs will follow the naming convention
    YYYYMMDD.suf
    where suf is n.b1 for superbiases
              and n.f1.f2 for superflats
    where n represents the ordinal of the entry for that night among
              raw calibration images of that class, and f1 and f2 are
              positions on the NASACAM filter wheel.
              FOR EXAMPLE, if 10 biases and 5 flats each in B,V and methane
              were taken at each twilght for 20060715, then the cal files
              would be called
              20060715.1.b1 20060715.1.11.8 20060715.1.12.2 20060715.1.12.3
              20060715.2.b1 20060715.2.11.8 20060715.2.12.2 20060715.2.12.3

Restrictions


  Assumes images are located in subdirectories named YYYYMMDD for each night.
  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/7/15, Written by Peter L. Collins, Lowell Observatory
  2006/7/24, PLC, modified after adding new column startime to calib table,
                  adding "PENDING" as a value for status,
                  changes to order of bias/flat evaluation- in
                  particular, designed to make good/bad choice
                  on sub-super-bias whenever possible automatically.
  2006/07/26, PLC,added support from empty returns from mysqlquery.
  2006/07/27, PLC,general cleanup and mark unimplemented keywords in header.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us