Creating Postage Stamp Request Files == up to PostageStampServer

Postage Stamp request files are FITS tables.

We expect that various science servers and other users will have their own programs for building request files.

To help with testing the postage stamp server we have written a simple script called pstamp_req_create. It may be found in the IPP source tree in the directory pstamp/test.

This script has no IPP dependencies but does use the perl module Astro::FITS::CFITSIO.

The input to this program is a text file. For example

# test1.txt

# A sample Postage stamp request description file
# This can be parsed by the program pstamp_req_create to build a 
# PS1_PSTAMP_REQUEST fits binary table.

# First line of data is for the extension header
#
# Note that value for REQ_NAME may be overriden by the pstamp_req_create command line argument --req_name
# Blank and comment lines (like this one) are ignored

# REQ_NAME           EXTVER
test1.20100305T1134     1

# subsequent lines define the rows in the table

# If ROWNUM is set to zero, pstamp_request_file will set insert a value for each row beginning with 1

# Fields are separated by spaces. Text after the | character is saved in the request table in the column comment

#
# ID    |     ROI Specification                   |  JOB Specification | Images of interest specification
# 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)
# just change the coordinates for the next request
0       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

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

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).

Note that at this time REQ_TYPE bycoord and byskycell have not yet been implemented.