% -----------------------------------------------------------------------
% app-results-Ex.tex: Example results output file.
% -----------------------------------------------------------------------
% Copyright (C) 2006, Matthew Whiting, ATNF
%
% This program is free software; you can redistribute it and/or modify it
% under the terms of the GNU General Public License as published by the
% Free Software Foundation; either version 2 of the License, or (at your
% option) any later version.
%
% Duchamp is distributed in the hope that it will be useful, but WITHOUT
% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
% FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
% for more details.
%
% You should have received a copy of the GNU General Public License
% along with Duchamp; if not, write to the Free Software Foundation,
% Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
%
% Correspondence concerning Duchamp may be directed to:
%    Internet email: Matthew.Whiting [at] atnf.csiro.au
%    Postal address: Dr. Matthew Whiting
%                    Australia Telescope National Facility, CSIRO
%                    PO Box 76
%                    Epping NSW 1710
%                    AUSTRALIA
% -----------------------------------------------------------------------
%\begin{landscape}
\secA{Example results file}
\label{app-output}
This the typical content of an output file, after running \duchamp
with the parameters illustrated on the previous page. The table is
wide, and has been split into four sections to make it easier to read.
%\begin{figure*}
%\begin{minipage}{170mm}
{\footnotesize
\begin{verbatim}
--------------------------------------------------------------------
 Obj#           Name     X     Y     Z         RA       DEC     VELO
                                                              [km/s]
--------------------------------------------------------------------
    1 J060946-215932  58.0 139.9 114.6 06:09:46.7 -21:59:32  225.640
    2 J060810-215122  63.5 142.0 114.9 06:08:10.6 -21:51:22  229.926
    3 J054547-214320 141.4 143.2 115.0 05:45:47.6 -21:43:20  230.210
    4 J060223-254806  83.7  83.0 118.0 06:02:23.4 -25:48:06  270.850
    5 J060539-271839  72.8  60.3 121.2 06:05:39.8 -27:18:39  312.265
    6 J061118-213644  52.6 145.5 162.5 06:11:18.6 -21:36:44  859.117
    7 J060034-285900  89.7  35.3 202.2 06:00:34.7 -28:59:00 1383.549
    8 J061707-272422  34.7  58.2 228.5 06:17:07.5 -27:24:22 1733.137
    9 J055847-252513  95.8  88.7 232.3 05:58:47.8 -25:25:13 1783.651
   10 J060054-214225  88.8 144.3 232.9 06:00:54.2 -21:42:25 1790.703
   11 J060444-260640  75.8  78.3 233.2 06:04:44.0 -26:06:40 1794.974
   12 J060107-233958  88.0 115.0 235.5 06:01:07.5 -23:39:58 1826.107
   13 J061210-214904  49.6 142.3 269.9 06:12:10.0 -21:49:04 2282.101
   14 J055508-295702 107.3  20.6 367.6 05:55:08.0 -29:57:02 3583.671

------------------------------------------------------------------------
     w_RA    w_DEC    w_50    w_20  w_VELO     F_int     F_tot    F_peak
 [arcmin] [arcmin]  [km/s]  [km/s]  [km/s] [Jy km/s] [Jy/beam] [Jy/beam]
------------------------------------------------------------------------
    20.32    23.76  25.442  41.038  26.403     4.621     5.140     0.213
     8.12    11.94  31.285  43.053  26.403     1.102     1.225     0.095
     7.70    12.28  33.757  47.820  26.403     0.882     0.981     0.090
    12.01    11.99  29.615  41.470  26.406     1.115     1.241     0.118
    20.15    19.87  27.930  44.830  39.616     3.097     3.445     0.150
    24.32    19.63  88.130 111.537 119.061    28.601    31.748     0.410
    19.92    24.09 176.654 194.569 198.784    15.042    16.668     0.173
    16.51    15.53 307.884 327.819 305.122     4.656     5.154     0.093
    23.91    16.14 230.961 277.579 238.828     7.299     8.077     0.115
    27.95    24.13  97.257 227.378 212.301    19.527    21.610     0.166
    20.11    19.90 213.520 230.422 225.584    15.001    16.601     0.155
    27.96    28.07 201.038 251.618 278.700    54.209    59.982     0.297
    16.27    15.73 406.006 440.079 412.062     9.820    10.849     0.101
     7.76    16.14  31.769  49.223  40.044     1.770     1.947     0.161

------------------------------------------------------------
 S/Nmax  X1  X2  Y1  Y2  Z1  Z2  Npix Flag  X_av  Y_av  Z_av
                                [pix]                       
------------------------------------------------------------
  16.41  56  60 137 142 114 116    48    M  57.9 139.8 115.0
   7.31  63  64 141 143 114 116    18    M  63.5 142.0 115.0
   6.93 141 142 142 144 114 116    15    M 141.4 143.2 115.0
   9.10  83  85  82  84 117 119    18    -  83.7  83.0 118.0
  11.56  71  75  58  62 120 123    42    -  72.8  60.3 121.1
  31.70  50  55 143 147 158 167   219    E  52.5 145.3 162.5
  13.35  88  92  33  38 195 210   224    -  89.7  35.3 202.2
   7.17  33  36  57  60 215 238    92    -  34.7  58.2 228.6
   8.91  93  98  87  90 221 239   136    -  95.8  88.6 231.9
  12.78  86  92 142 147 223 239   290    E  88.8 144.3 232.3
  11.93  74  78  76  80 224 241   244    -  75.8  78.3 233.1
  22.92  85  91 112 118 225 246   551    -  88.0 115.0 235.8
   7.78  48  51 141 144 256 287   195    -  49.6 142.3 270.3
  12.40 107 108  19  22 366 369    22    - 107.3  20.7 367.6
\end{verbatim}
\newpage
\begin{verbatim}
------------------------------------------
 X_cent Y_cent Z_cent X_peak Y_peak Z_peak
                                          
------------------------------------------
   58.0  139.9  114.6     59    140    114
   63.5  142.0  114.9     63    141    115
  141.4  143.2  115.0    141    144    115
   83.7   83.0  118.0     84     83    118
   72.8   60.3  121.2     72     61    121
   52.6  145.5  162.5     53    146    164
   89.7   35.3  202.2     90     36    197
   34.7   58.2  228.5     35     58    236
   95.8   88.7  232.3     96     89    237
   88.8  144.3  232.9     89    144    233
   75.8   78.3  233.2     76     78    240
   88.0  115.0  235.5     88    115    231
   49.6  142.3  269.9     50    142    259
  107.3   20.6  367.6    107     21    367
\end{verbatim}
}

A good trick for those using UNIX/Linux is to make use of the
\texttt{a2ps} command. The following works well, producing a
postscript file \texttt{duchamp-Results.ps}:
\\\verb|a2ps -1 -r -f5 -o duchamp-Results.ps duchamp-Results.txt|

The table is preceded by information on the parameters used (see the
previous section), the statistics and threshold values, and the number
of detections. If \texttt{flagSeparateHeader} is set to \texttt{true},
this information is put in a separate file. This information looks
like the following:

{\footnotesize
\begin{verbatim}
Results of the Duchamp source finder: Thu May  3 12:15:44 2007

---- Parameters ----
      (... omitted for clarity -- see previous page for examples...)
--------------------

--------------------
Summary of statistics:
Detection threshold = 0.0389443 Jy/beam
Noise level = 0.000122074, Noise spread = 0.0129408
Full stats:
Mean   = 0.000421491    Std.Dev. = 0.0129756
Median = 0.000122074    MADFM    = 0.0087284 (= 0.0129408 as std.dev.)
--------------------
Total number of detections = 14
--------------------
\end{verbatim}
}
