Data model: idReport

General description: Nightly report of imaging camera observations. Values of -9999 represent undefined values (the only undefined values should be "muEnd" and "lastFrame" in "START" entries, and "muStart" in "END" entries).

Naming convention: idReport-ddddd.par, where ddddd is the int(MJD).

Approximate size: 100 kbytes.

File type: FTCL parameter file

Read by products: ssc, astrom, fcalib

Written by products: iop

Contents


parameters          'XXX'               # Tunable parameters file (if any)
parametersDir       'XXX'               # Directory containing the 'parameters'
                                        # file (optional --- defaults to '.')


version             'XXX'               # Version of software used.
mjd                 XXX                 # MJD day number of night when
                                        # data was obtained.

cameraVersion       'XXX'               # Camera software version
mcpVersion          'XXX'               # MCP software version
observers           'XXX XXX XXX'       # Observers

# CCD configuration files
configDir           'XXX'               # directory for ccd calibration files
ccdConfig           'XXX'               # amplifier configuration
ccdECalib           'XXX'               # electronic calibrations
ccdBC               'XXX'               # bad pixels
ccdCamera           'XXX'               # camera geometry
ccdVoltages     'opCCDLog-%d-51259.par' #
                                        # Format to convert CCD number (camRow,
                                        # camCol, e.g., 45 for row 4, column
                                        # 5) to name of voltages file

# Entry written at start or end of run
typedef enum {
    START,
    END
} RUNMARK;

#
# An imaging report contains three tables:
#    IMAGINGRUN lists all imaging runs (drift scans) which were executed
#    QUALITY    assigns mountain estimates of the data quality to runs
#    IDCOMMENT  appends comments onto runs
#

typedef struct {
    char      program[20];    # Identifying name for CCD program.
    int       stripe;         # The stripe targetted (100 if doesn't
                              # target a stripe).
    char      strip[20];      # Strip in the stripe being tracked (N, S,
                              # O).
    int       run;            # Imaging run number.
    char      flavor[20];     # Flavor of this run (science, calibration,
                              # bias, engineering, ignore).
    char      sys_scn[20];    # Coordinate system of the scan great
                              # circle.
    double    eqnx_scn;       # Equinox of the scan great circle. (years)
    double    node;           # Ra of the great circle's ascending node.
                              # (deg)
    double    incl;           # Great circle's inclination wrt cel eq.
                              # (deg)
    double    muStart;        # Boresight mu for start of run (frame 0,
                              # deg).
    double    muEnd;          # Boresight mu for end of run (last frame,
                              # deg).
    int       lastFrame;      # Last frame in scan.
    double    xBore;          # Boresight x offset from the array center.
                              # (mm)
    double    yBore;          # Boresight y offset from the array center.
                              # (mm)
    char      system[20];     # System of the TCC coordinates (mean,
                              # apparent).  These are the coordinates
                              # attached to each associated frame.
    double    equinox;        # Equinox of the TCC coordinates.   These
                              # are the coordinates stored in each
                              # associated frame. (years)
    double    c_obs;          # CCD clock rate. (usec/unbinned-row)
    double    tracking;       # Tracking rate. (arcsec/TAI-sec)
    char      quality[20];    # Mountain estimate of the overall data
                              # quality (undetermined, bad, acceptable,
                              # good).
    double    mjd;            # MJD at beginning of the scan (TAI /
                              # 86400). (MJD)

    RUNMARK   mark;           # Entry written at start or end of run.
} IMAGINGRUN;

typedef struct {int run; char quality[20];} QUALITY;
typedef struct {int run; int frame; char comment[240];} IDCOMMENT;

IMAGINGRUN full 23 N 17 SCIENCE MEAN 2000.0 95.0 32.5 178.87 -9999 -9999 \
    22.75 0.0 MEAN 2000.0 26666.667 1. UNDETERMINED 51259.566 START
IMAGINGRUN full 23 N 17 SCIENCE MEAN 2000.0 95.0 32.5 178.87 232.45 52 \
    22.75 0.0 MEAN 2000.0 26666.667 1. UNDETERMINED 51259.566 END
QUALITY 17 GOOD
IDCOMMENT 19 "Moth_ate_secondary."
QUALITY 18 ACCEPTABLE