Changes between Version 6 and Version 7 of sample_pstamp_request

Timestamp:

Mar 5, 2010, 12:17:18 PM (16 years ago)

Author:

bills

Comment:

--

sample_pstamp_request

@@ -41 +41 @@
 # ROWNUM CENTER_X    CENTER_Y  WIDTH HEIGHT COORD_MASK JOB_TYPE OPTION_MASK PROJECT REQ_TYPE IMG_TYPE    ID   TESS_ID COMPONENT    DATA_GROUP  REQFILT MJD_MIN MJD_MAX | COMMENT
 #
-0       135.49921     34.92035 100    100      2        stamp       1        gpc1    bycoord   chip       null    null   null           null        null 55249   55250   |search by coords (make the server work)
+1       135.49921     34.92035 100    100      2        stamp       1        gpc1    bycoord   chip       null    null   null           null        null 55249   55250   |search by coords (make the server work)
 # just change the coordinates for the next request
-0       135.63231     34.92165 100    100      2  | different coords in same images of interest
+2       135.63231     34.92165 100    100      2  | different coords in same images of interest
 
-0       135.49921     34.92035 100    100      2        stamp       1        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |specific image
-0       135.49921     34.92035 100    100      2        stamp       3        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |image,mask,and weight
-0       135.49921     34.92035 100    100      2        stamp      63        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |image,mask,weight,cmf, psf,backmdl
+3       135.49921     34.92035 100    100      2        stamp       1        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |specific image
+4       135.49921     34.92035 100    100      2        stamp       3        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |image,mask,and weight
+5       135.49921     34.92035 100    100      2        stamp      63        gpc1    byid     chip       62326    null   XY62           null        null   0       0     |image,mask,weight,cmf, psf,backmdl
 }}}
 
-When REQ_MODE is 'byid' the ID column is interpreted as the id of the run that corresponds to the IMG_TYPE (exp_id, chip_id, warp_id, etc.).
-If a column with string type is not required for a given request specification it may be given the value 'null'.
-For example in row 12 component is set to null. This tells the postage stamp server to check all chips
+The columns in the request file have three purposes
+ * Define the "Region of Interest"
+ * Define the "Images of Interest" 
+ * Specify what the job does
 
-Most of these request specifications only request stamps from the image (OPTION_MASK = 1). 
-An exception is row 12 which has OPTION_MASK = 7. This requests stamps from the mask and variance images be made as well. 
-Soon more bits of this this column will be used to select other output products (psf files for example).
+The region of interest has a center and width and height. The center may be given in either sky coordinates (RA and DEC) or
+in pixels. How these columns are interpreted depends on the value of the COORD_MASK. The usage of COORD_MASK is 
+described in detail in the ICD.
 
-Note that at this time REQ_TYPE bycoord and byskycell have not yet been implemented.
+These sample requests all use the most commononly used mode (COORD_MASK = 2). This means that center is specified
+in sky coordinates while width and height are in pixels.
+
+The images of interest may be selected in many ways. The REQ_TYPE column has the following values
+ * byid
+ * byexp
+ * byskycell
+ * bydiff
+ * bycoord
+
+The first sample row is a bycoord request. Requests of this type are currently quite expensive for the postage stamp server
+to process. Depending on the field they can generate a large number of images of interest (many which are probably not
+available).  
+
+Many of the other columns apply cuts to the images of interest. In the first request MJD_MIN and MJD_MAX are set 
+restricting the look ups to a given date range
+If a column with string type is not needed for a given request specification it may be given the value 'null'.
+In the first row ID, TESS_ID, COMPONENT, DATA_GROUP, and REQFILT are null. 
+
+For the second row we want to just change the coordinates so we just provide the ROI specification.
+The other paramters will be copied from the previous row. 
+
+OPTION_MASK is used to select which data products are returned. This value is a bitwise or of the following
+values
+
+ * PSTAMP_SELECT_IMAGE     = 1;
+ * PSTAMP_SELECT_MASK      = 2;
+ * PSTAMP_SELECT_VARIANCE  = 4;
+ * PSTAMP_SELECT_CMF       = 8;
+ * PSTAMP_SELECT_PSF       = 16;
+ * PSTAMP_SELECT_BACKMDL   = 32;
+ * PSTAMP_SELECT_INVERSE   = 1024;
+ * PSTAMP_SELECT_UNCONV    = 2048;
+
+Row 1 selects stamps from the image. Row 3 also requests stamps from the mask and variance images. Row 5
+requests that the sources (cmf), psf, and background model files from the chipRun be included in the results file set. 
+Note that the region of interest has no effect on these data products. They  are returned in full.