IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Changeset 882


Ignore:
Timestamp:
Jun 4, 2004, 2:49:48 PM (22 years ago)
Author:
eugene
Message:

incorporated comments from SRS rewiew (5/4), some as \tbd notes

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/design/ippSRS.tex

    r837 r882  
    1 %%% $Id: ippSRS.tex,v 1.3 2004-06-03 02:56:58 eugene Exp $
     1%%% $Id: ippSRS.tex,v 1.4 2004-06-05 00:49:48 eugene Exp $
    22\documentclass[panstarrs]{panstarrs}
    33
     
    8484\DocumentsInternalSection
    8585PSDC-130-001  &   PS-1 Design Reference Mission \\ \hline
     86PSDC-130-xxx  &   PS-1 SCD \\ \hline
    8687PSDC-430-004  &   Pan-STARRS IPP C Code Conventions \\ \hline
    8788PSDC-430-006  &   Pan-STARRS IPP ADD \\ \hline
     89PSDC-430-006  &   Pan-STARRS IPP SDRS \\ \hline
    8890PSDC-430-007  &   Pan-STARRS IPP PSLib SDRS \\ \hline
    8991\DocumentsExternalSection
     
    101103after AP survey}
    102104
     105\tbd{define astronomy concepts: cleaned, pre-processed, significant,
     106outlier}
     107
    103108The IPP must perform the following tasks:
    104109
    105110\begin{enumerate}
    106111
    107 \item Accept raw images from OATS at a sustained rate of 1 exposure
    108  per 30 seconds.
    109 
    110 \item Accept metadata from OATS at a sustained rate of \tbd{XXX MB / sec}.
    111 
    112 \item Produce high-quality calibration images from the raw calibration
    113   images.  The calibration images must not introduce systematic
    114   uncertainties greater than \tbd{0.2\%}.  \tbd{Requirements on the
    115   speed of processing the calibration images.}
    116 
    117 \item Pre-process the science images with the high-quality calibration
    118   images.
     112\item Accept raw images from the summit at a sustained rate of 1
     113 exposure per 30 seconds.
     114
     115\item Accept metadata from the summit at a sustained rate of \tbd{XXX
     116MB / sec}.
     117
     118\item Produce high-quality master calibration images from the raw
     119  calibration images.  The master calibration images must not
     120  introduce systematic uncertainties greater than \tbd{0.2\%}.
     121  \tbd{Requirements on the speed of processing the calibration
     122  images.}
     123
     124\item Pre-process the science images with the high-quality master
     125  calibration images.
    119126
    120127\item Merge multiple pre-processed science images -- from multiple
    121128  telescopes or from sequential, dithered exposures -- into single,
    122   cleaned, stacked images.
     129  cleaned, stacked images with corresponding signal-to-noise maps.
    123130
    124131\item Subtract a static sky image from the cleaned, stacked images to
    125   produce an image of only the transient events.
     132  produce an image of only the transient objects.
    126133
    127134\item Excise the significant transients and outliers from the
    128   pre-processed science images and merge the cleaned images into the
    129   static sky image.
    130 
    131 \item Detect objects on the four types of images: pre-processed
    132   images, the stacked image, the difference image, and the static sky
    133   image.
     135  pre-processed science images.  \tbd{how to handle variable stars?}
     136
     137\item merge the cleaned images into the static sky image, and
     138  update the corresponding exposure (S/N) maps.
     139
     140\item Detect and measure parameters of objects on the four types of
     141  images: pre-processed images, the stacked image, the difference
     142  image, and the static sky image.
    134143
    135144\item Determine astrometry of the detected objects relative to an
    136   astrometric reference to an accuracy of \tbd{30 mas}.
     145  astrometric reference to an accuracy of \tbd{30 mas}, with a limit of
     146  \tbd{xxx} on the outliers.
    137147
    138148\item Determine photometry of the detected objects relative to a
    139149  photometric reference to an accuracy of \tbd{5 millimag} relative
    140150  photometry and \tbd{10 millimag} absolute photometry in photometric
    141   weather. 
     151  weather.  \tbd{before vs after PS-1 AP Surver} \tbd{bright vs faint
     152  errors} with a limit of \tbd{xxx} on the outliers.  \tbd{limit
     153  depends on filter}
    142154
    143155\item Produce a high-quality astrometric reference catalog from the
    144156  extracted objects on a time-scale of 6 months.  The astrometric
    145157  reference must have an absolute accuracy of \tbd{30 mas} and a local
    146   relative accuracy of \tbd{10 mas}.  Proper motions of all nearly
    147   stationary objects must be determined with an accuracy of \tbd{XXX
    148   mas / year}.
     158  relative accuracy of \tbd{10 mas}.  Proper motions of detected
     159  objects with distances greater than 1000 AU must be determined with
     160  an accuracy of \tbd{XXX mas / year}.
    149161
    150162\item Produce a high-quality photometric reference catalog from the
    151   extracted objects on a time-scale of 6 months.  The photometric
    152   reference must have an consistency across the sky of \tbd{5
    153   millimag} and an absolute calibration to the external system defined
    154   by \tbd{SDSS} of \tbd{10 millimag}.
     163  extracted point-source objects on a time-scale of 6 months.  The
     164  photometric reference must have an consistency across the sky of
     165  \tbd{5 millimag} and an absolute calibration to the external system
     166  defined by \tbd{SDSS} of \tbd{10 millimag}.
    155167
    156168\item Publish the static sky images to the Pan-STARRS published static
    157   sky server on a time-scale of \tbd{1 month}.
     169  sky server on a time-scale of \tbr{1 month}.
    158170
    159171\item Publish the detected objects to the Pan-STARRS published object
    160   database on a time-scale of \tbd{1 week}.
     172  database on a time-scale of \tbr{1 week}.
    161173
    162174\item Provide access to external Pan-STARRS clients to the detected
    163   objects on time-scales of \tbd{1 minute} after the image is
    164   processed. 
     175  objects on time-scales of \tbr{10 minute} after the image is
     176  obtained.\comment{this is a top-level science requirement.}
     177
     178\item Store the raw images for a particular period of, depending on
     179  the survey source of the data.  In PS-1, the AP and IVP Survey data
     180  must be stored for the lifetime of the project.  Other raw data must
     181  be store for \tbr{1 month}.
     182
     183\item Store the detected objects for a period of time, depending on
     184  the type of detection.  Transients from the P4$\Delta$ images may be
     185  excised after \tbr{6 monts}.
    165186
    166187\end{enumerate}
     
    198219
    199220Source code must be in C.  All source code must be compiled with `gcc'
    200 version v2.95 or higher.
     221version v2.95 or higher, and the tested compiler version must be
     222defined for the delivered software product.
    201223
    202224Scripting language must be \tbd{Python, version TBD}.
     
    355377\subsection{Architectural Components}
    356378
    357 As discussed in the Pan-STARRS System Concept Definition, the IPP is
    358 organized into a number of clearly-defined software elements.  The SCD
    359 provides a detailed description of the roles and responsibilities of
    360 these subsystems.  In brief, the IPP consists of a collection of
    361 science analysis stages, a set of architectural components which
    362 provide the infrastructure needed to run the analysis programs, and a
    363 collection of hardware on which all of the software elements exist.
     379As discussed in the Pan-STARRS System Concept Definition
     380(PSDC-xxx-xxx), the IPP is organized into a number of clearly-defined
     381software elements.  The SCD provides a detailed description of the
     382roles and responsibilities of these subsystems.  In brief, the IPP
     383consists of a collection of science analysis stages, a set of
     384architectural components which provide the infrastructure needed to
     385run the analysis programs, and a collection of hardware on which all
     386of the software elements exist.
    364387
    365388The architectural components consist of:
     
    383406
    384407\item {\bf Metadata Database:} This component is required to store the
    385   data which is not directly related to images or astronomical objects
    386   as needed to perform the analysis specified above.
     408  all other data which are neither image files nor astronomical object
     409  data.  The Metadata Database is the authoratative source for all
     410  metadata data, including metadata which may be duplicated elsewhere,
     411  such as in the headers of images in the image database.
    387412
    388413\item {\bf Controller:} In order to perform the analysis stages
     
    424449machine and notify the requesting agent of the new locations. 
    425450
    426 The IPP Image Server be able to maintain multiple copies of each
    427 image, as specified by the user.
     451The IPP Image Server store multiple copies of each image, the number
     452of copies specified independently for each by the user.
    428453
    429454The IPP Image Server must maintain a record of all image copies
     
    551576\begin{table}
    552577\begin{center}
    553 \caption{AP Detection Classes \& Object Parameters\label{APdetections}}
     578\caption{AP Data Volume Requirements\label{APrates}}
    554579\begin{tabular}{lrrrr}
    555580\hline
     
    557582Quantity & P2 & P4$\Sigma$ & P4$\Delta$ & SS \\
    558583\hline
    559 detection limit             & $20 \sigma$       & $5 \sigma$      & $3 \sigma$      & \\
    560 depth (r')                  & 20.8              & 23.0            &                 & \\
    561 stars deg$^{-2}$ ($|b|>10$) &   $1 \times 10^5$ & $1 \times 10^5$ & $1 \times 10^5$ & $1 \times 10^5$ \\
    562 stars FPA$^{-1}$ ($|b|>10$) &   $7 \times 10^5$ & $1 \times 10^5$ & $1 \times 10^5$ & $1 \times 10^5$ \\
    563 stars sec$^{-1}$ ($|b|>10$) & $2.3 \times 10^4$ & $1 \times 10^5$ & $1 \times 10^5$ & $1 \times 10^5$ \\
    564 bytes star$^{-1}$           & 64                & 100             & 64              &                \\
    565 MB sec$^{-1}$               & 1.4               & 2.2             & 0.7             &                \\
    566 PS-1 total TB               & 8                 & 12              & 4               &                \\
     584detection limit             & $20 \sigma$       & $5 \sigma$        & $3 \sigma$        & \\
     585depth (r')                  & 20.8              & 23.0              & ?                 & \\
     586stars deg$^{-2}$ ($|b|>10$) &   $1 \times 10^5$ & $4 \times 10^5$   & $2 \times 10^5$   & \\
     587stars FPA$^{-1}$ ($|b|>10$) &   $7 \times 10^5$ & $2.8 \times 10^6$ & $1.4 \times 10^6$ & \\
     588stars sec$^{-1}$ ($|b|>10$) & $2.3 \times 10^4$ & $2.3 \times 10^4$ & $1.2 \times 10^4$ & \\
     589bytes star$^{-1}$           & 64                & 100               & 64                & \\
     590MB sec$^{-1}$               & 1.4               & 2.2               & 0.7               & \\
     591PS-1 total TB               & 8                 & 12                & 4                 & \\
    567592\hline
    568593\end{tabular}
     
    578603rates. 
    579604
    580 \subsubsection{Metadata Database -- FIX ME}
     605\tbd{archive lifetime}
     606
     607\tbd{reliability}
     608
     609\tbd{backups}
     610
     611\subsubsection{Metadata Database}
    581612
    582613\tbd{this section needs to be reviewed and revised}
     
    605636\tbd{queries}
    606637
    607 {\bf note: description of images belong in the Metadata database,
    608   location of images is in the Image server}
    609 
    610 \paragraph{Configuration Database -- FIX ME}
    611 
    612 The IPP requires a Configuration Database to store and provide access to
    613 information about the IPP itself.  Examples of data in the
     638\tbd{description of images belong in the Metadata database, location
     639  of images is in the Image server}
     640
     641\paragraph{Configuration Database}
     642
     643The IPP requires a Configuration Database to store and provide access
     644to information about the IPP itself.  Examples of data in the
    614645configuration database include the default parameters for the various
    615646analysis programs, the description of the computing environment, the
    616647process status information, etc.  \tbd{part of metadata database?}.
     648
     649\tbd{some information must have access limited to specific responsible
     650  people.  ie, software / hardware configuration $\rightarrow$ sysadmin;
     651  science parameters $\rightarrow$ science team.}
    617652
    618653\subsubsection{Controller}
     
    880915peak-to-peak deviations of \tbr{0.5\%}.
    881916
     917\tbd{color of stars in flat-field correction?}
     918
    882919\paragraph{Sky \& Fringe subtraction}
    883920
     
    10291066
    10301067The output image must maintain photometric consistency with the input
    1031 image to within 0.2\%.  \tbd{interpolation method?}
     1068image to within 0.2\%.  \tbd{does interpolation method choice risk
     1069losing flux?}
    10321070
    10331071\paragraph{Flux matching}
     
    10361074factors needed to combine the images photometrically.
    10371075
     1076\tbd{is flux matched automatically by calibration?}
     1077
    10381078\paragraph{Image outlier pixel rejection}
    10391079
    1040 Pixels from the group of images which are inconsistent \tbd{how much?}
    1041 with the ensemble of pixel values must be identified and flagged.
     1080When multiple images are combined, the group of input pixels which
     1081contribute to an output pixel must be examined and pixels from the
     1082group of images which are inconsistent with the ensemble \tbd{how
     1083much?} must be identified and flagged. 
    10421084
    10431085This outlier rejection must be performed optionally.
     1086
     1087\tbd{for moving objects and images which are not simultaneous, do we
     1088  identify the moving objects?}
     1089
     1090\tbd{use the spatial information?  fit a 2-D Nth order polynomial to
     1091  the collection of pixels and then look for outliers}
    10441092
    10451093\paragraph{Initial cleaned image}
     
    10561104The static sky image must be subtracted from the stacked, cleaned
    10571105image. 
     1106
     1107\tbd{what about different stellar colors?}
    10581108
    10591109\paragraph{Find objects in the image}
     
    11221172the relevant image metadata (\ie filter, exposure time, etc).
    11231173
     1174\paragraph{Image Processing Q/A}
     1175
     1176Before the image is added to the static sky, it must pass Q/A tests.
     1177
    11241178\paragraph{Update static sky}
    11251179
     
    13721426\item Catalog to mean positions
    13731427\item Mean to apparent positions
     1428\item Apparent positions + pointing to tangent plane coordinates
    13741429\item Apparent positions + pointing to focal plane coordinates
    13751430\item focal plane to specific detector (OTA)
     
    15521607\subsection{External Interfaces}
    15531608
     1609Images from OATS / Camera data store.
     1610
     1611Summit Metadata from OATS.
     1612
     1613Image Q/A assessment to OATS
     1614
     16153$\sigma$ transient non-orphaned detections to MOPS
     1616
     16173$\sigma$ transient detections to Transient Science Client
     1618
     1619Published static sky images to Science Database
     1620
     1621Published objects (P2, P4S, P4D, SS) to Science Database
     1622
    15541623\subsection{Internal Interfaces}
    15551624
     
    15621631\tbd{this section should be parred down a bit by referring more to the
    15631632  hardware report}.
     1633
     1634\tbd{switch to passive voice (we will address foo $\rightarrow$ foo is
     1635addressed)}
    15641636
    15651637This section discusses the Pan-STARRS Image Processing Pipeline (IPP)
     
    15971669object db          &   4 TB \\
    15981670\hline
    1599 total              & 116 TB \\
     1671total              & 466 TB \\
    16001672\hline
    16011673\end{tabular}
     
    17781850input images   &      $1.5 \times 4 \times 32$ MB  \\
    17791851input masks    &      $1.5 \times 4 \times  8$ MB  \\
    1780 static sky     &                            32 MB  \\
    1781 static weight  &                            32 MB  \\
     1852static sky     &                            32x9/4 MB  \\
     1853static weight  &                            32x9/4 MB  \\
    17821854\hline
    17831855input:         &                           304 MB  \\
     
    19131985\subsection{Software Integrity Tests}
    19141986
    1915 MHPCC must test the integrity of the software, specifically to check
    1916 that the code does not produce memory leaks, segmentation faults.
     1987MHPCC must test that the code does not produce memory leaks.
     1988
     1989MHPCC must test that the code does not produce segmentation faults.
    19171990
    19181991\subsection{Basic Unit Tests}
Note: See TracChangeset for help on using the changeset viewer.