Index: /trunk/doc/design/design.tex
===================================================================
--- /trunk/doc/design/design.tex	(revision 506)
+++ /trunk/doc/design/design.tex	(revision 507)
@@ -1,3 +1,3 @@
-%%% $Id: design.tex,v 1.5 2004-04-15 01:39:13 eugene Exp $
+%%% $Id: design.tex,v 1.6 2004-04-23 01:15:45 price Exp $
 \documentclass[panstarrs]{panstarrs}
 
@@ -573,5 +573,5 @@
 \hline
 \multicolumn{1}{l}{\bf Metadata Tables} \\
-weather \\
+Weather \\
 SkyProbe \\
 LRProbe \\
@@ -606,9 +606,9 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf weather} \\
-time & \\
-temperature & \\
-humidity & \\
-pressure & \\
+\multicolumn{2}{l}{\bf Weather} \\
+Time & The time the weather information was measured. \\
+Temperature & The temperature at \tbd{some place.  Will likely want temperatures for a range of locations: external, dome, secondary, primary for starters.} \\
+Humidity & The relative humidity. \\
+Pressure & The (external) atmospheric pressure. \\
 \hline
 \end{tabular}
@@ -617,11 +617,12 @@
 \hline
 \multicolumn{2}{l}{\bf SkyProbe} \\
-time & \\
-transparency & \\
-error & \\
-Nstars & \\
-astrom & \\
-exptime & \\
-sky & \\
+Time & The time the SkyProbe image was taken. \\
+Filter & Filter used for SkyProbe image. \\
+Transparency & The derived transparency. \\
+Error in transparency & The error in the derived transparency. \\
+Number of stars & The number of stars used to measure the transparency. \\
+Astrometry & The astrometry used on the SkyProbe image. \\
+Exposure time & The exposure time of the SkyProbe image. \\
+Sky brightness & The measured sky (surface) brightness, in physical units. \\
 \hline
 \end{tabular}
@@ -630,15 +631,15 @@
 \hline
 \multicolumn{2}{l}{\bf LRProbe} \\
-time & \\
-A band & \\
-abs 2 & \\
-abs 3 & \\
-emission 1 & \\
-emission 2 & \\
-emission 3 & \\
-Nstars & \\
-astrom & \\
-exptime & \\
-sky & \\
+Time & The time the LRProbe observation was taken. \\
+A band absorption & The absorption EW of the atmospheric A band. \\
+B band absorption & The absorption EW of the atmospheric B band. \\
+Absorption component 3 & The absorption EW by some other atmospheric component. \\
+Emission 1 & The emission EW of some sky line. \\
+emission 2 & The emission EW of another sky line. \\
+emission 3 & The emission EW of some other sky line. \\
+Number of stars & Number of stars used to measure the absorptions. \\
+Astrometry & The astrometry used on the LRProbe image. \\
+Exposure time & The exposure time of the LRProbe image. \\
+Sky brightness & The measured sky (surface) brightness, in physical units. \\
 \hline
 \end{tabular}
@@ -647,10 +648,10 @@
 \hline
 \multicolumn{2}{l}{\bf DIMM} \\
-time & \\
-$\sigma_x$ & \\
-$\sigma_y$ & \\
-$fwhm_r$ & \\
-star coords & \\
-exptime & \\
+Time & The time the DIMM observation was taken. \\
+$\sigma_x$ & \tbd{The dispersion in $x$}. \\
+$\sigma_y$ & \tbd{The dispersion in $y$}. \\
+FWHM & The seeing full width at half maximum. \\
+Star coordinates & The coordinates of the measured star. \\
+Exposure time & The exposure time of the DIMM observation. \\
 \hline
 \end{tabular}
@@ -659,8 +660,8 @@
 \hline
 \multicolumn{2}{l}{\bf NIR} \\
-time & \\
-sky.brightness & \\
-sky.varience & \\
-astrom & \\
+Time & The time the NIR observation was taken. \\
+Sky brightness & The sky (surface) brightness in the NIR observation. \\
+Sky variance & The variance in the sky (surface) brightness. \\
+Astrometry & The astrometry used on the NIR image. \\
 \hline
 \end{tabular}
@@ -669,8 +670,8 @@
 \hline
 \multicolumn{2}{l}{\bf Dome Status} \\
-time & \\
-Az & \\
-open.status & \\
-lights.status & \\
+Time & The time for which the dome status is valid. \\
+Azimuth & The azimuth of the dome. \\
+Open status & Whether the dome is open or not. \\
+Lights status & Whether lights are on in the dome or not. \\
 \hline
 \end{tabular}
@@ -679,10 +680,10 @@
 \hline
 \multicolumn{2}{l}{\bf Telescope Status} \\
-time & \\
-guide.status & \\
-Alt & \\
-Az & \\
-RA & \\
-DEC & \\
+Time & The time for which the telescope status is valid. \\
+Guide status & The status of the guiding. \\
+Altitude & The telescope altitude. \\
+Azimuth & The telescope azimuth. \\
+RA & The telescope Right Ascension (ICRS $\approx$ J2000). \\
+Dec & The telescope Declination (ICRS $\approx$ J2000).\\
 \hline
 \end{tabular}
@@ -691,14 +692,15 @@
 \hline
 \multicolumn{2}{l}{\bf Raw FPAs} \\
-coords & \\
-filter & \\
-exposure status & \\
-exptime & \\
-airmass & \\
-obsgroup ID & \\
-observer & \\
-program & \\
-NOTAs & \\
-NX, NY \\
+Coords & Coordinates of the boresight (i.e. telescope pointing). \\
+Filter & Filter used for the exposure. \\
+Exposure status & Status of the exposure. \\
+Exposure time & Exposure time for the image. \\
+Airmass & Airmass at which the image was taken. \\
+ObsGroup ID & \tbd{The ObsGroup identification number.} \\
+Observer & The name of the observer, or the version of the telescope scheduler software. \\
+Program & The observing program being executed. \\
+Number of chips & The number of chips that comprise the FPA. \\
+NX, NY & \tbd{Assuming the chips are laid out rectilinearly,} the number of chips in each dimension. \\
+Astrometry & The astrometry used for the FPA.
 \hline
 \end{tabular}
@@ -706,13 +708,11 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf Raw OTAs} \\
-Nx & \\
-Ny & \\
-Ncell & \\
-ID & \\
-temps & \\
-astrom & \\
-NCells & \\
-NX, NY & \\
+\multicolumn{2}{l}{\bf Raw Chips} \\
+i, j & \tbd{Assuming a rectilinear FPA,} the chip number in each dimension.
+ID & Chip identification number. \\
+temps & The chip temperature. \\
+Astrometry & The astrometry used for the chip. \\
+Number of cells & The number of component cells. \\
+NX, NY & \tbd{Assuming the cells are rectilinear,} the number of cells in each dimension. \\
 \hline
 \end{tabular}
@@ -721,6 +721,6 @@
 \hline
 \multicolumn{2}{l}{\bf Raw Cells} \\
-astrom & \\
-valid & \\
+Astrometry & The astrometry used for the cell. \\
+Validity & Is the cell working? \\
 \hline
 \end{tabular}
@@ -729,9 +729,9 @@
 \hline
 \multicolumn{2}{l}{\bf Observation Group} \\
-ID & \\
-Nimages & \\
-type & \\
-status & \\
-etc & \\
+ID & Identification number for the observation group. \\
+Number of images & Number of images in the observation group. \\
+Type & Type of observation. \\
+Status & Status of the observation group. \\
+\tbd{etc} & \\
 \hline
 \end{tabular}
@@ -739,11 +739,12 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf OTA guide stars} \\
-OTA ID & \\
-Guide Star ID & \\
-X, Y & \\
-RA, DEC & \\
-$\sigma_{x}$, $\sigma_{y}$ & \\
-$\Delta X_{max}$, $\Delta Y_{max}$ & \\
+\multicolumn{2}{l}{\bf Chip guide stars} \\
+Chip ID & The identification number for the chip. \\
+Guide Star ID & The identification number for the guide star. \\
+X, Y & The centroided pixel coordinates of the guide star. \\
+RA, DEC & The sky coordinates of the guide star. \\
+$\sigma_{x}$, $\sigma_{y}$ & The dispersion in the centroids over the particular exposure.\\
+$\Delta X_{\rm max}$, $\Delta Y_{\rm max}$ & The maximum deviation in the centroid over the
+particular exposure. \\
 \hline
 \end{tabular}
@@ -751,32 +752,35 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf Science OTA stats} \\
-OTA ID & \\
-state & \\
-major frame & \\
-obsgroup & \\
-P1 astrom & \\
-P2 astrom & \\
-P3 astrom & \\
-Nguide stars & \\
-bias correction method & \\
-bias summary stats (mean, params, sigma of residuals, biassec) & \\
-applied flat-field image & \\
-kernel convolution parameters & \\
-flat-field summary stats (sigma of sky) & \\
-applied mask image & \\
-masking algorithm & \\
-fringe model images & \\
-fringe correction stats (fringe amplitude, sky sigma) & \\
-object detection stats (nobject, depth, other input params) & \\
-updated astrom params & \\
-astrometry stats (nstars, $sigma_x$, $sigma_y$) & \\
-applied reference catalog & \\
-updated photom params & \\
-photom stats (nstars, $sigma_m$) & \\
-applied reference catalog & \\
-PSF stats & \\
-OTA state & \\
-software versions & \\
+\multicolumn{2}{l}{\bf Science Chip stats} \\
+Chip ID & The chip identification number. \\
+State & \tbd{The state of the processing.} \\
+Major frame & \tbd{The major frame the chip belongs to.} \\
+ObsGroup & The observation group the science exposure belongs to. \\
+P1 astrom & The Phase 1 astrometry. \\
+P2 astrom & The Phase 2 astrometry. \\
+P3 astrom & The Phase 3 astrometry. \\
+Number of guide stars & Number of guide stars used for the exposure. \\
+Bias correction method & Method used to correct the bias. \\
+Bias stats & Summary statistics for bias (mean, number of parameters, deviation of residuals,
+bias section used). \\
+Flat-field image & The flat-field image that was applied. \\
+Kernel convolution parameters & A description of the OT kernel. \\
+Flat-field stats & Summary statistics for flat-field (sigma of sky). & \\
+Mask image & The mask image that was applied. \\
+Masking algorithm & \tbd{The algorithm used to mask the bad pixels.} \\
+Fringe images & The fringe model images that were used. \\
+Fringe stats & Summary statistics for fringes (fringe amplitude, sky sigma) & \\
+Object detection stats & Summary statistics for object detection (number of objects, depth, other
+input parameters). \\
+Updated astrometry & \tbd{Updated astrometry parameters.} \\
+Astrometry stats & Summary statistics for astrometry (number of stars, $sigma_x$, $sigma_y$) \\
+Reference catalog & The reference catalog that was used for the astrometry. \\
+Updated photometry parameters & The parameters used to update the photometry: magnitude zero point
+and other corrections. \\
+Photometry stats & Summary statistics for the photometry (number of stars, $sigma_m$) & \\
+Reference catalog & The reference catalog that was used for the photometry. \\
+PSF stats & Summary statistics of the PSF. \\
+OTA state & \tbd{The state of the OTA?} \\
+Software versions & Versions of each of the modules used in the processing. \\
 \hline
 \end{tabular}
@@ -785,8 +789,8 @@
 \hline
 \multicolumn{2}{l}{\bf Science Cell stats} \\
-bias summary stats (mean, params, sigma of residuals, biassec) \\
-P1 astrom & \\
-P2 astrom & \\
-P3 astrom & \\
+Bias stats & Summary statistics for the bias (mean, parameters, dispersion of residuals, biassec) \\
+P1 astrom & The Phase 1 astrometry. \\
+P2 astrom & The Phase 2 astrometry. \\
+P3 astrom & The Phase 3 astrometry. \\
 \hline
 \end{tabular}
@@ -795,22 +799,22 @@
 \hline
 \multicolumn{2}{l}{\bf Science FPA stats} \\
-FPA ID \\
-state \\
-P1 updated astrom params \\
-P1 astrometry stats (nstars, $\sigma_x$, $sigma_y$)
-P1 applied reference catalog \\
-P1 software versions \\
-P1 bright stars in field pointer \\
-P1 location of ghosts pointer \\
-P1 large astronomical objects pointer \\
-P1 PSF model & \\
-P3 updated astrom params \\
-P3 astrometry stats (nstars, $sigma_x$, $sigma_y$)
-P3 applied reference catalog \\
-P3 updated photom params \\
-P3 photom stats (nstars, $sigma_m$)
-P3 applied reference catalog \\
-P3 PSF stats \\
-P3 software versions \\
+FPA ID & The FPA identification number. \\
+State & \tbd{The state of the FPA.} \\
+P1 astrom & The Phase 1 astrometry. \\
+P1 astrom stats & Summary statistics for the Phase 1 astrometry (number of stars, $\sigma_x$, $sigma_y$). \\
+P1 reference catalog & The reference catalog that was used for the astrometry. \\
+P1 software versions & The versions of each of the modules used in the Phase 1 processing. \\
+P1 bright stars & Pointers to the bright stars in the field. \\
+P1 ghosts & Pointers to the ghosts in the field. \\
+P1 large objects & Pointers to the large astronomical objects in the field. \\
+P1 PSF model & Description of the PSF model used in Phase 1. \\
+P3 astrom & The Phase 3 astrometry. \\
+P3 astrom stats & Summary statistics for the Phase 3 astrometry (number of stars, $sigma_x$, $sigma_y$). \\
+P3 reference catalog & The reference catalog that was used for the astrometry. \\
+P3 photom & The Phase 3 photometry. \\
+P3 photom stats & Summary statistics for the Phase 3 photometry (number of stars, $sigma_m$). \\
+P3 reference catalog & The reference catalog that was used for the photometry. \\
+P3 PSF model & Description of the PSF model used in Phase 3. \\
+P3 software versions & The versions of each of the modules used in the Phase 3 processing. \\
 \hline
 \end{tabular}
@@ -818,8 +822,8 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf Sky-OTA overlaps} \\
-OTA ID & \\
-Sky Cell & \\
-state & \\
+\multicolumn{2}{l}{\bf Sky-Chip overlaps} \\
+Chip ID & The identification number of the chip. \\
+Sky Cell ID & The identification number of the sky cell. \\
+State & \tbd{The state of the processing?} \\
 \hline
 \end{tabular}
@@ -828,14 +832,16 @@
 \hline
 \multicolumn{1}{l}{\bf Processed Sky-Cell stats} \\
-input OTAs & \\
-PSF adjustments & \\
-CR rejection stats & \\
-image combination parameters & \\
-different image parameters & \\
-average reference image depth / weight & \\
-difference image object detection stats (nobject, depth, other input params) & \\
-summed image object detection stats (nobject, depth, other input params) & \\
-software versions & \\
-processing time / stats & \\
+Input Chips & Identification numbers of the chips used to produce the sky cell. \\
+PSF adjustments & \tbd{Adjustments to the PSF.} \\
+CR rejection stats & Statistics from the CR rejection (number of CRs, distribution, limiting flux). \\
+Image combination parameters & Parameters used for the image combination. \\
+Difference image parameters & Parameters used for the image differencing. \\
+Average reference image depth / weight & \tbd{The weight of the reference image?} \\
+Difference image object detection stats & Summary statistics of the object detection (number of objects,
+depth, other input parameters). \\
+Summed image object detection stats & Summary statistics of the object detection (number of objects,
+depth, other input parameters). \\
+Software versions & Software versions of modules used in the sky cell processing. \\
+Processing stats & Summary statistics of the processing (CPU time, etc). \\
 \hline
 \end{tabular}
@@ -843,11 +849,11 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf Calibration 1 input OTA stats} \\
-OTA ID & \\
-output detrend image ID
-state & \\
-accepted? & \\
-image stats (counts, exptime, airmass) & \\
-residual stats (mean, sigma, clipped sigma) & \\
+\multicolumn{2}{l}{\bf Calibration 1 input Chip stats} \\
+Input ID & The input chip identification number. \\
+Output ID & The identification number of the output detrend image. \\
+State & \tbd{State of the processing?} \\
+Accepted? & Is the detrend image of acceptable quality? \\
+Image stats & Assorted image statistics (mean flux, exposure time, airmass) \\
+Residual stats & Statistics of the residual image (mean, sigma, clipped sigma) \\
 \hline
 \end{tabular}
@@ -855,14 +861,13 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{2}{l}{\bf Calibration 1 output OTA stats} \\
-output detrend image ID & \\
-data type (bias | dark | flat) & \\
-Naccepted input images & \\
-Nrejected input images & \\
-summary stats & \\
-normalization reference & \\
-applicability time period & \\
-software versions & \\
-processing time / stats & \\
+\multicolumn{2}{l}{\bf Calibration 1 output Chip stats} \\
+Output ID & The identification number of the output detrend image. \\
+Data type & The type of the detrend image (bias | dark | flat) \\
+Number accepted & Number of accepted input images that contributed. \\
+Number rejected & Number of rejected input images (no contribution). \\
+Summary stats & Summary statistics of the combination (deviation, normalisations). \\
+Applicability period & The time period the detrend image is applicable for. \\
+Software versions & The software versions of the modules used in processing. \\
+Processing stats & Summary statistics of the processing (CPU time, etc). \\
 \hline
 \end{tabular}
@@ -870,13 +875,13 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{1}{l}{\bf Calibration 2 input OTA stats} \\
-OTA ID & \\
-output detrend image ID
-state & \\
-accepted? & \\
-image stats (counts, exptime, airmass) & \\
-residual stats (mean, sigma, clipped sigma) & \\
-applied reduction & \\
-applied reduction params & \\
+\multicolumn{2}{l}{\bf Calibration 2 input Chip stats} \\
+Input ID & The input chip identification number. \\
+Output ID & The identification number of the output detrend image. \\
+State & \tbd{State of the processing?} \\
+Accepted? & Is the detrend image of acceptable quality? \\
+Image stats & Assorted image statistics (mean flux, exposure time, airmass). \\
+Residual stats & Statistics of the residual image (mean, sigma, clipped sigma) \\
+Applied reduction & \tbd{Reduction method used?} \\
+Applied params & Parameters of reduction. \\
 \hline
 \end{tabular}
@@ -884,14 +889,13 @@
 \begin{tabular}{ll}
 \hline
-\multicolumn{1}{l}{\bf Calibration 2 output OTA stats } \\
-ID & \\
-data type (bias | dark | flat) & \\
-Naccepted input images & \\
-Nrejected input images & \\
-summary image stats & \\
-normalization reference & \\
-applicability time period & \\
-software versions & \\
-processing time / stats & \\
+\multicolumn{2}{l}{\bf Calibration 2 output OTA stats } \\
+Output ID & The identification number of the output detrend image. \\
+Data type & The type of the detrend image (bias | dark | flat) \\
+Number accepted & Number of accepted input images that contributed. \\
+Number rejected & Number of rejected input images (no contribution). \\
+Summary stats & Summary statistics of the combination (deviation, normalisations). \\
+Applicability period & The time period the detrend image is applicable for. \\
+Software versions & The software versions of the modules used in processing. \\
+Processing stats & Summary statistics of the processing (CPU time, etc). \\
 \hline
 \end{tabular}
@@ -900,11 +904,11 @@
 \hline
 \multicolumn{1}{l}{\bf Calibration 3 output metadata } \\
-input image stack & \\
-input image stats & \\
-input object summary stats (nobject, density, etc) & \\
-object rejection criteria & \\
-relphot stats (Mcal, dMcal, Klam, etc, bin size) & \\
-residual stats & \\
-output image params (size, etc) & \\
+Input images & Identification numbers of the input chips. \\
+Input image stats & Summary statistics of the input chips. \\
+Input object summary stats & Summary statistics of the objects on the input chips (number, density, etc) & \\
+Object rejection criteria & Parameters of the rejection step. \\
+Phot stats & Summary statistics of the relative photometry (Mcal, dMcal, Klam, etc, bin size) & \\
+Residual stats & Summary statistics of the residuals. \\
+Output image params & Parameters of the output image (size, etc) & \\
 \hline
 \end{tabular}