NAME

markdq -- mark DQ flags on a displayed image

USAGE

markdq image frame

DESCRIPTION

Mark DQ flags on a displayed image using graphic overlays. The overlayed color for each DQ flag value can be set independently, including turning off the overlay for specific DQ values.

The image extension containing the DQ array to be displayed must be included explicitly in the input image name. First display a science image using the display task, and then run markdq to overlay the DQ flags.

The color of the mark for each DQ bit is specified by an integer value between 0 and 255. Color values set to zero will not be plotted by this task. The meaning of the color is device dependent. In the current version of the Sun/IRAF display tools numbers between 202 and 217 may be used to display graphics colors. The current color assignments are:

          0 = sunview background color (normally white)
      1-200 = frame buffer data values, windowed
        201 = cursor color (white)
        202 = black
        203 = white
        204 = red
        205 = green
        206 = blue
        207 = yellow
        208 = cyan
        209 = magenta
        210 = coral
        211 = maroon
        212 = orange
        213 = khaki
        214 = orchid
        215 = turquoise
        216 = violet
        217 = wheat

    218-254 = reserved for use by other windows
        255 = black (sunview foreground color)

PARAMETERS

image

DQ image to be used to overlay flags.

frame

The frame or image plane number of the display to be marked.

pointsize = 1

The size of the mark to overlay for each flag. Point size will be rounded up to the nearest odd number.

col= 208 (cyan)

Color of the mark for DQ bit 1 - Reed-Solomon decoding error.

col= 209 (magenta)

Color of the mark for DQ bit 2 - bad Linearity correction.

col= 210 (coral)

Color of the mark for DQ bit 3 - bad Dark correction.

col= 211 (maroon)

Color of the mark for DQ bit 4 - bad Flat field correction.

col= 212 (orange)

Color of the mark for DQ bit 5 - bad Background subtraction.

col= 206 (blue)

Color of the mark for DQ bit 6 - Defective (hot/cold) pixel.

col= 205 (green)

Color of the mark for DQ bit 7 - Saturated pixel.

col= 213 (khaki)

Color of the mark for DQ bit 8 - Missing data (telemetry dropout).

col= 204 (red)

Color of the mark for DQ bit 9 - Bad pixel detected by calibration.

col= 207 (yellow)

Color of the mark for DQ bit 10 - Cosmic Ray hit.

col= 0 (no mark)

Color of the mark for DQ bit 11 - pixel contains a Source.

EXAMPLES

1. Mark the DQ flags for the science image n3t502cur_ima[sci,3]:

    cl> display n3t502cur_ima[sci,3] 1
    cl> markdq n3t502cur_ima[dq,3] 1

BUGS

REFERENCES

Author: Howard Bushouse, SSG

SEE ALSO

display, tvmark, ndisplay