Creating Detectability Server Request Files

up to PostageStampServer

Detectability server 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 detectability server we have written a simple script called detect_query_create, which is installed as part of the standard IPP installation. It may be found in the IPP source tree in the directory pstamp/scripts.

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

# DQtest.txt

# A sample detectability query description file
# This can be parsed with the program detect_query_create to build a
# MOPS_DETECTABILITY_QUERY fits binary table

# First line of data is for the extension header
#
# Note that value for QUERY_ID may be overridden by the detect_query_create command line argument --query_id
# Blank and comment lines (like this one) are ignored

# QUERY_ID            EXTVER FPA_ID      MJD-OBS FILTER OBSCODE STAGE
warptest.20100519     1      o5304g0066o 55304   z      566     warp

# subsequent lines define the rows in the table
# Fields are separated by spaces. 
# ROWNUM    RA1_DEG   DEC1_DEG   RA2_DEG   DEC2_DEG   MAG
1           161.59932 58.25591 161.59000   58.25700   19
2           161.62225 58.25447 161.62300   58.25400   19
3           161.63360 58.36666 161.63400   58.36700   19

Only the RA1_DEG and DEC1_DEG columns are used for the detectability query at this point, as only PSF photometry is currently supported. Similarly, the specified magnitude is not currently used in the query.

Request parsing is relaxed for EXTVER=2 queries. This can be used to generate lightcurves for a specified RA/DEC on a series of images:

# QUERY_ID EXTVER OBSCODE STAGE
lctest1    2      566     diff
# ROWNUM RA1_DEG DEC1_DEG RA2_DEG DEC2_DEG MAG FILTER MJD-OBS
1 161.59932 58.25591 161.59000   58.25700   19 z      55304
2 161.59932 58.25591 161.59000   58.25700   19 g      55305
3 161.59932 58.25591 161.59000   58.25700   19 r      55305
4 161.59932 58.25591 161.59000   58.25700   19 g      55320
5 161.59932 58.25591 161.59000   58.25700   19 r      55320

The server should be able to reject faulty rows (that match no exposure), so a brute force method to generate a multi-filter lightcurve could be done using this kind of query:

# QUERY_ID EXTVER OBSCODE STAGE
lctest2    2      566     diff
# ROWNUM RA1_DEG DEC1_DEG RA2_DEG DEC2_DEG MAG FILTER MJD-OBS
1 161.59932 58.25591 161.59000   58.25700   19 g      55304
2 161.59932 58.25591 161.59000   58.25700   19 r      55304
3 161.59932 58.25591 161.59000   58.25700   19 i      55304
4 161.59932 58.25591 161.59000   58.25700   19 z      55304
5 161.59932 58.25591 161.59000   58.25700   19 y      55304
6 161.59932 58.25591 161.59000   58.25700   19 g      55305
7 161.59932 58.25591 161.59000   58.25700   19 r      55305
8 161.59932 58.25591 161.59000   58.25700   19 i      55305
9 161.59932 58.25591 161.59000   58.25700   19 z      55305
10 161.59932 58.25591 161.59000   58.25700   19 y      55305
11 161.59932 58.25591 161.59000   58.25700   19 g      55306
12 161.59932 58.25591 161.59000   58.25700   19 r      55306
13 161.59932 58.25591 161.59000   58.25700   19 i      55306
14 161.59932 58.25591 161.59000   58.25700   19 z      55306
15 161.59932 58.25591 161.59000   58.25700   19 y      55306
16 161.59932 58.25591 161.59000   58.25700   19 g      55307
17 161.59932 58.25591 161.59000   58.25700   19 r      55307
18 161.59932 58.25591 161.59000   58.25700   19 i      55307
19 161.59932 58.25591 161.59000   58.25700   19 z      55307
20 161.59932 58.25591 161.59000   58.25700   19 y      55307