% -----------------------------------------------------------------------
% 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}
# ---------------------------------------------------------------------
#  ObjID           Name     X     Y     Z         RA       DEC     VRAD
#                                                                [km/s]
# ---------------------------------------------------------------------
       1 J060930-215738  58.9 140.4 114.5 06:09:30.9 -21:57:38  223.964
       2 J060143-250033  86.0  94.9 117.9 06:01:43.0 -25:00:33  269.253
       3 J060217-254714  84.0  83.2 118.0 06:02:17.6 -25:47:14  270.507
       4 J060605-271848  71.4  60.2 121.3 06:06:05.8 -27:18:48  313.411
       5 J061118-213635  52.5 145.5 162.6 06:11:18.6 -21:36:35  858.050
       6 J060034-285857  89.7  35.3 202.5 06:00:34.0 -28:58:57 1384.415
       7 J061700-272250  35.0  58.6 216.5 06:17:00.9 -27:22:50 1570.316
       8 J055847-252517  95.9  88.6 232.9 05:58:47.5 -25:25:17 1786.082
       9 J060053-214223  88.9 144.3 233.2 06:00:53.3 -21:42:23 1789.639
      10 J060444-260644  75.8  78.3 233.2 06:04:44.7 -26:06:44 1790.501
      11 J061706-272510  34.7  58.0 235.2 06:17:06.8 -27:25:10 1816.205
      12 J060106-233956  88.0 115.0 235.5 06:01:06.8 -23:39:56 1820.251
      13 J061209-214921  49.6 142.3 269.4 06:12:09.6 -21:49:21 2267.524
      14 J060924-223303  59.4 131.5 295.3 06:09:24.2 -22:33:03 2609.616
      15 J055505-295651 107.4  20.7 367.5 05:55:05.4 -29:56:51 3561.487
---------------------------------------------------------------------------------
   MAJ   MIN     PA     w_RA    w_DEC    w_50    w_20  w_VRAD     F_int    eF_int
 [deg] [deg]  [deg] [arcmin] [arcmin]  [km/s]  [km/s]  [km/s] [Jy km/s] [Jy km/s]
---------------------------------------------------------------------------------
  0.43  0.28 113.19    52.43    31.33  25.752  40.905  65.957     9.767     0.127
  0.32  0.17  91.63    28.00    16.02  23.753  42.244  26.383     1.687     0.055
  0.22  0.01 179.43    20.01    15.99  28.934  40.975  26.383     1.232     0.049
  0.52  0.38  87.97    48.26    27.61  28.263  42.272  26.383     5.916     0.104
  0.27  0.24 140.56    24.32    19.63  87.851 111.107 118.722    27.796     0.169
  0.22  0.19 133.22    15.93    24.07 175.885 194.031 197.870    12.535     0.155
  0.15  0.10 138.15    12.26     7.65  65.960 329.015  52.765     0.647     0.039
  0.20  0.18  90.68    19.91    16.11 232.786 279.536 211.061     4.453     0.102
  0.32  0.20 117.37    27.95    24.13  93.004 226.209 197.870    16.373     0.175
  0.25  0.20 134.05    16.11    19.91 211.882 228.161 211.061    12.293     0.161
  0.18  0.11 176.19    16.39    11.53  60.490 327.217  52.765     1.243     0.054
  0.27  0.23  90.44    27.96    28.07 199.616 248.932 263.826    50.402     0.256
  0.14  0.09 128.55    16.21    11.72 403.215 436.588 382.548     5.813     0.122
  0.46  0.14   9.67    20.56    43.79  13.748  25.718  26.383     1.688     0.053
  0.24  0.19 155.90    15.76    16.25  30.543  45.907  39.574     3.131     0.071
------------------------------------------------------------------------
     F_tot    eF_tot    F_peak S/Nmax  X1  X2  Y1  Y2  Z1  Z2  Npix Flag
 [Jy/beam] [Jy/beam] [Jy/beam]                                [pix]     
------------------------------------------------------------------------
    10.873     0.142     0.213  16.17  53  65 136 143 113 118   116    M
     1.878     0.062     0.124   8.99  83  89  93  96 117 119    22    -
     1.372     0.054     0.118   8.60  82  86  82  85 117 119    17    -
     6.586     0.115     0.150  11.29  65  76  57  63 120 122    77    -
    30.943     0.188     0.410  31.17  50  55 143 147 158 167   205    E
    13.954     0.173     0.173  13.03  88  91  33  38 195 210   172    -
     0.720     0.044     0.078   4.92  34  36  58  59 215 219    11    -
     4.957     0.113     0.115   7.88  93  97  87  90 222 238    74    -
    18.227     0.195     0.166  11.99  86  92 142 147 224 239   219    E
    13.685     0.179     0.155   9.18  74  77  76  80 225 241   185    -
     1.384     0.060     0.093   5.73  33  36  57  59 233 237    21    -
    56.108     0.285     0.297  21.00  85  91 112 118 226 246   469    -
     6.471     0.135     0.101   6.10  48  51 141 143 257 286   106    -
     1.879     0.059     0.177  12.81  57  61 127 137 295 297    20    -
     3.485     0.079     0.169  12.66 106 109  19  22 366 369    36    -
\end{verbatim}
\newpage
\begin{verbatim}
------------------------------------------------------------
  X_av  Y_av  Z_av X_cent Y_cent Z_cent X_peak Y_peak Z_peak
                                                            
------------------------------------------------------------
  59.1 140.4 114.6   58.9  140.4  114.5     59    140    114
  86.0  94.9 117.9   86.0   94.9  117.9     85     95    118
  84.1  83.2 118.0   84.0   83.2  118.0     84     83    118
  71.2  60.2 121.2   71.4   60.2  121.3     72     61    121
  52.5 145.4 162.5   52.5  145.5  162.6     53    146    164
  89.7  35.3 202.7   89.7   35.3  202.5     90     36    197
  35.0  58.5 216.6   35.0   58.6  216.5     35     59    215
  95.9  88.6 232.6   95.9   88.6  232.9     96     89    237
  88.8 144.3 232.7   88.9  144.3  233.2     89    144    233
  75.8  78.3 233.2   75.8   78.3  233.2     76     78    240
  34.7  58.0 235.0   34.7   58.0  235.2     35     58    236
  88.1 115.0 235.8   88.0  115.0  235.5     88    115    231
  49.6 142.3 270.0   49.6  142.3  269.4     50    142    259
  59.2 131.6 295.5   59.4  131.5  295.3     60    132    295
 107.5  20.7 367.5  107.4   20.7  367.5    108     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:
\begin{quote}
{\footnotesize
\texttt{> a2ps -1 -r -f5 -o duchamp-Results.ps duchamp-Results.txt}
}
\end{quote}
and produces a postscript file \texttt{duchamp-Results.ps}.

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}
}

%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "Guide"
%%% End: 
