WPHot Outfile Files and & Description  (June 6, 2008)

Interface Name:     WPHot Interface
Type of Interface:  program i/o

Written By:         WISE Photometry System (WPHot) __________ T. Jarrett & K. Marsh
Read By:            SLW


Description & Caveats:

Version 1.0 of WPHOT, including single-frameset processing by WPRO and WAPP.

______________________________________________________________________________________________

Specification of output variables:

Header comments:

Band is the WISE channel processed. 
Nsrc is the number of sources in the table.
Rap is the standard aperture magnitude in arcsec and is also specified in pixels 

Tabular data:


  cols   Name   Description                                        Units   Type    Format
  ----   ----   -----------------------------------------------   ------- ----   --------
   1     src    source ID counter            			    --     int    I7
   2      ra    right ascension (J2000)				   deg     R*8    f12.7
   3     dec    declination (J2000)				   deg     R*8    f12.7
   4     dra    uncertainty in RA (arcsec)			  asec     R*4    f9.6
   5    ddec    uncertainty in DEC (arcsec)                       asec     R*4    f9.6
   6  raddec    uncertainty cross-term (arcsec)                   asec     R*4    f9.6

   7     x_1    x-pixel coordinate, band-1, frame-1                pix     R*4    f9.3
   8     y_1    y-pixel coordinate, band-1, frame-1                pix     R*4    f9.3
   9     x_2    x-pixel coordinate, band-2, frame-1                pix     R*4    f9.3
  10     y_2    y-pixel coordinate, band-2, frame-1                pix     R*4    f9.3
  11     x_3    x-pixel coordinate, band-3, frame-1                pix     R*4    f9.3
  12     y_3    y-pixel coordinate, band-3, frame-1                pix     R*4    f9.3
  13     x_4    x-pixel coordinate, band-4, frame-1                pix     R*4    f9.3
  14     y_4    y-pixel coordinate, band-4, frame-1                pix     R*4    f9.3


The next set of columns are aperture/annulus measurements:

  15   w1sky   sky background value, band-1                        dn     R*4    f9.3
  16 w1sksig   sky background value uncertainty, band-1            dn     R*4    f8.3
  17   w2sky   sky background value, band-1                        dn     R*4    f9.3
  18 w2sksig   sky background value uncertainty, band-2            dn     R*4    f8.3
  19   w3sky   sky background value, band-1                        dn     R*4    f9.3
  20 w3sksig   sky background value uncertainty, band-3            dn     R*4    f8.3
  21   w4sky   sky background value, band-1                        dn     R*4    f9.3
  22 w4sksig   sky background value uncertainty, band-4            dn     R*4    f8.3

WPRO:

  23    SNR1   S/N ratio, band-1                                   dn      R*4  ff7.1
  24    SNR2   S/N ratio, band-2                                   dn      R*4  ff7.1
  25    SNR3   S/N ratio, band-3                                   dn      R*4  ff7.1
  26    SNR4   S/N ratio, band-4                                   dn      R*4  ff7.1

  27  w1flux   WPRO raw flux, band-1				   dn     R*4   e11.3   
  28 ew1flux   WPRO raw flux uncertainty, band-1		   dn     R*4   e11.3 
  29  w2flux   WPRO raw flux, band-2                               dn     R*4   e11.3 
  30 ew2flux   WPRO raw flux uncertainty, band-2                   dn     R*4   e11.3
  31  w3flux   WPRO raw flux, band-3                               dn     R*4   e11.3 
  32 ew3flux   WPRO raw flux uncertainty, band-3                   dn     R*4   e11.3
  33  w4flux   WPRO raw flux, band-4                               dn     R*4   e11.3 
  34 ew4flux   WPRO raw flux uncertainty, band-4                   dn     R*4   e11.3


  35   w1pro   WPRO flux in mag units, band-1                     mag     R*4    f7.3
  36  ew1pro   WPRO flux uncertainty in mag units, band-1         mag     R*4    f7.3
  37 w1rchi2   WPRO reduced chi^2, band-1             		  --      R*4    f8.3 

  38   w2pro   WPRO flux in mag units, band-2                     mag     R*4    f7.3
  39  ew2pro   WPRO flux uncertainty in mag units, band-2         mag     R*4    f7.3
  40 w2rchi2   WPRO reduced chi^2, band-2                         --      R*4    f8.3

  41   w3pro   WPRO flux in mag units, band-3                     mag     R*4    f7.3
  42  ew3pro   WPRO flux uncertainty in mag units, band-3         mag     R*4    f7.3
  43 w3rchi2   WPRO reduced chi^2, band-3                         --      R*4    f8.3

  44   w4pro   WPRO flux in mag units, band-4                     mag     R*4    f7.3
  45  ew4pro   WPRO flux uncertainty in mag units, band-4         mag     R*4    f7.3
  46 w4rchi2   WPRO reduced chi^2, band-4                         --      R*4    f8.3

  47   rchi2   reduced chi squared, total                          --     R*4    f8.3
  48      nb   number of blend components used in each fit         --     int    i3
  49      na   active deblend flag (=1 if actively deblended)      --     int    i3


WAPP:

  50     nw1   number of sources merged, band-1 		   --     int    i4
  51   w1stp   standard aperture mag, band-1                      mag     R*4    f7.3
  52  ew1stp   standard aperture mag uncertainty, band-1          mag     R*4    f7.3
  53      i1   standard aperture flag, band-1			   --     int    i3
  54     nw2   number of sources merged, band-2                    --     int    i4
  55   w2stp   standard aperture mag, band-2                      mag     R*4    f7.3
  56  ew2stp   standard aperture mag uncertainty, band-2          mag     R*4    f7.3
  57      i2   standard aperture flag, band-2                      --     int    i3
  58     nw3   number of sources merged, band-3                    --     int    i4
  59   w3stp   standard aperture mag, band-3                      mag     R*4    f7.3
  60  ew3stp   standard aperture mag uncertainty, band-3          mag     R*4    f7.3
  61      i3   standard aperture flag, band-3                      --     int    i3
  62     nw4   number of sources merged, band-4                    --     int    i4
  63   w4stp   standard aperture mag, band-4                      mag     R*4    f7.3
  64  ew4stp   standard aperture mag uncertainty, band-4          mag     R*4    f7.3
  65      i4   standard aperture flag, band-4                      --     int    i3

______________________________________________________________________________________________

Note about upper limits:

threshold = 2 * delta_f
if ( f < threshold) then
	if (f < 0) then
	  upper_limit = threshold
	else
	  upper_limit = f + threshold
  
where f is the flux of the source, delta_f is the uncertainty of the source;

The upper limit is reported in the WPRO and standard aperture MAG columns;
the reported uncertainty is set to 9.99 mag.
 

	
______________________________________________________________________________________________


Example table:

\ Nsrc =    1130
\ frames engaged:   1
\ bands engaged:   1  1  1  1
\ Rap =    8.25   8.25   8.25  16.50 arcsec ,      3.00   3.00   3.00   3.00 pix
| src  |  ra      |  dec     |  dra   |  ddec  |  x_1   |  y_1   |   x_2  |  y_2   |  x_3   |  y_3   |  x_4   |  y_4   | w1sky  |w1sksig| w2sky  |w2sksig| w3sky  |w3sksig| w4sky  |w4sksig| w1flux   | ew1flux  | w2flux   | ew2flux  | w3flux   | ew3flux  | w4flux   | ew4flux  | w1pro|ew1pro|w1rchi2| w2pro|ew2pro|w2rchi2| w3pro|ew3pro|w3rchi2| w4pro|ew4pro|w4rchi2| rchi2 |nb|na|nw1|w1stp |ew1stp|i1|nw2|w2stp |ew2stp|i2|nw3|w3stp |ew3stp|i3|nw1|w4stp |ew4stp|i4|
|  i   |   r      |   r      |   r    |   r    |   r    |  r     |   r    |  r     |  r     |  r     |  r     |  r     |    r   |    r  |    r   |    r  |    r   |    r  |    r   |    r  |    r     |    r     |    r     |    r     |    r     |    r     |    r     |    r     |   r  |   r  |   r   |   r  |   r  |   r   |   r  |   r  |   r   |   r  |   r  |   r   |    r  | i| i| i |  r   |    r | i| i |  r   |    r | i| i |  r   |    r | i| i |  r   |    r | i|
|      | deg      |  deg     |  deg   |  deg   |  pix   |  pix   |   pix  |  pix   |  pix   |  pix   |  pix   |  pix   |   dn   |    dn |   dn   |    dn |   dn   |    dn |   dn   |    dn |    dn    |    dn    |    dn    |    dn    |    dn    |    dn    |   dn     |    dn    |  mag |  mag |   --  |  mag |  mag |   --  |  mag |  mag |   --  |  mag |  mag |   --  |   --  |--|--| --| mag  |  mag | -| --| mag  |  mag | -| --| mag  |  mag | -| --| mag  |  mag | -|
      1 266.730743 -28.621096 0.000000 0.000000  122.610  796.013  122.609  797.013  121.697  795.992    0.000    0.000  147.976  16.913  130.359   4.931  219.849   2.997    0.000   0.000  0.390E+06  0.000E+00  0.402E+06  0.000E+00  0.544E+05  0.000E+00  0.000E+00  0.000E+00 99.000  0.000  93.233 99.000  0.000  21.703 99.000  0.000   0.039 99.000  0.000   0.000  40.108  1  0   1  5.389  0.000  0   1  5.882  0.001  0   1  8.464  0.002  0   0 99.000  0.000  0
      2 266.674438 -29.040184 0.193941 0.223386  174.793  246.091  174.792  247.091  173.884  246.070   87.174  123.730  147.320  19.293  130.200   7.139  210.855   4.004  163.861   6.004  0.370E+06  0.847E+04  0.401E+06  0.823E+04  0.536E+05  0.349E+04  0.240E+04  0.104E+04  6.079  0.025  73.728  5.991  0.022  32.301  8.176  0.071   0.132 11.548  0.468   0.001  24.987  1  0   1  5.370  0.000  0   1  5.814  0.001  0   1  8.489  0.002  0   1 11.672  0.018  0