COG Output Files and & Description  (15 Dec 2008)
[cog02 WSDC D-I128]

Interface Name:     COG Output Median COG and Aperture Corrections Table
Type of Interface:  program I/O

Written By:         Curve of Growth Module (COG) ______________ T. L. Evans
Read By:            Database load


Description & Caveats:

Version 0.1 of COG (dated 081119)
Version 1.0 of COG (dated 081219)

This file contains the median COG and aperture corrections table.  A file is 
written for each band and PSF bin for which medians were calculated, i. e. the
bin contains at least the minimum number of "clean" sources.  The table name 
is determined by the input parameter 'outbase', the band, the total number of 
PSF bins in X and Y, and this PSF bin location; for example:
[outbase]-w[band]-apcor-[NpsfX]x[NpsfY]-[thisNpsfX]x[thisNpsfY].tbl
or
/wise/fops/scans/1b/01301b/wcog-w2-apcor-05x05-02x04.tbl

______________________________________________________________________________________________

Specification of output variables:

Table Header information:

. Title:  The title of the file, containing the originating program name (COG) 
          and the PSF bin identifier, which consists of the band and the PSF bin 
          location (XxY).
. Version:  Version and runtime information.
. PSFName:  The PSF bin identifier.
. Nsrcs:  The number of "clean" sources in this PSF bin.
. ApConverg:  The aperture number of the "optimal" aperture.
. TypeConverg:  The type of convergence: convergence, divergence, or 
                 non-convergence.
. Flag:  A flag indicating any problems in calculating the medians or 
         convergence.


Tabular data:


  col   Name       Description                                                Units    Type   Format
  ---   -------    ---------------------------------------------------------  -------  ----   ------

   1    ap         Aperture number (starting with 1)                          ---      int    d4
   2    r          Aperture radius in arcsec                                  arcsec   real   e12.3
   3    dm_med     Median of 'dm' (m[i]-m[i+1]) for this aperture             mag      real   e12.3
   4    dm_rms     RMS of the median 'dm' for this aperture                   mag      real   e12.3
   5    dm_flg     Flag indicating any problems calculating dm_med            ---      int    d7
   6    apcor_med  Median value of the aperture correction for this aperture  mag      real   e12.3
   7    apcor_rms  RMS of the median aperture correction for this aperture    mag      real   e12.3
   8    ap_flg     Flag indicating any problems calculating apcor_med         ---      int    d7


dm_flg and ap_flg values:

  flag value   condition
  __________   ___________________________________________________________ 
       0       Nominal
      -4       Stopped iterative median calculation at max number of 
               iterations allowed
      -5       Stopped iterative median calculation because fraction of 
               sources lost in n-RMS rejection > max allowed
     -99       No calculation because 1) it is the largest aperture (for dm
               only) OR 2) not enough sources available


Example table:

\char Title = Aperture Correction data: PSF w2-05x03
\char Version = COG v 0.10  081105  SVN:$Id    Run at 2008-11-19 17:49:47
\char PSFname = w2-05x03
\int Nsrcs = 929
\int ApConverg = 6
\char TypeConverg = convergence
\int Flag = 0
|ap |r          |dm_med     |dm_rms     |dm_flg|apcor_med  |apcor_rms  |ap_flg|
|int|real       |real       |real       |int   |real       |real       |int   |
|   |arcsec     |mag        |mag        |      |mag        |mag        |      |
|   |           |null       |null       |      |           |           |      |
 1   2.750e+00   8.540e-01   9.059e-02   0      -1.166e+00  1.583e-01   0      
 2   5.500e+00   1.870e-01   6.442e-02   0      -3.105e-01  1.444e-01   0      
 3   8.250e+00   7.000e-02   6.309e-02   0      -1.270e-01  1.177e-01   0      
 4   1.100e+01   3.900e-02   5.199e-02   0      -5.700e-02  8.671e-02   0      
 5   1.375e+01   1.800e-02   7.216e-02   0      -1.800e-02  7.216e-02   0      
 6   1.650e+01   6.000e-03   8.279e-02   0      0.000e+00   0.000e+00   0      
 7   1.925e+01   4.000e-03   8.921e-02   0      6.000e-03   8.279e-02   0      
 8   2.200e+01   -9.999e+01  -9.999e+01  -99    1.000e-02   1.302e-01   0