% -----------------------------------------------------------------------
% 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}
{\scriptsize
\begin{verbatim}
#-------------------------------------------------------------------------------------------
# ObjID           Name     X     Y     Z         RA       DEC         RA        DEC     VRAD
#                                                                  [deg]      [deg]   [km/s]
#-------------------------------------------------------------------------------------------
      1 J060930-215738  58.9 140.4 114.5 06:09:30.9 -21:57:38  92.378723 -21.960721  223.964
      2 J060143-250033  86.0  94.9 117.9 06:01:43.0 -25:00:33  90.429334 -25.009433  269.253
      3 J060217-254714  84.0  83.2 118.0 06:02:17.6 -25:47:14  90.573276 -25.787385  270.507
      4 J060605-271848  71.4  60.2 121.3 06:06:05.8 -27:18:48  91.524232 -27.313549  313.411
      5 J061118-213635  52.5 145.5 162.6 06:11:18.6 -21:36:35  92.827691 -21.609736  858.050
      6 J060034-285857  89.7  35.3 202.5 06:00:34.0 -28:58:57  90.141557 -28.982718 1384.415
      7 J061700-272250  35.0  58.6 216.5 06:17:00.9 -27:22:50  94.253896 -27.380808 1570.316
      8 J055847-252517  95.9  88.6 232.9 05:58:47.5 -25:25:17  89.697895 -25.421585 1786.082
      9 J060053-214223  88.9 144.3 233.2 06:00:53.3 -21:42:23  90.222109 -21.706623 1789.639
     10 J060444-260644  75.8  78.3 233.2 06:04:44.7 -26:06:44  91.186272 -26.112238 1790.501
     11 J061706-272510  34.7  58.0 235.2 06:17:06.8 -27:25:10  94.278350 -27.419558 1816.205
     12 J060106-233956  88.0 115.0 235.5 06:01:06.8 -23:39:56  90.278502 -23.665813 1820.251
     13 J061209-214921  49.6 142.3 269.4 06:12:09.6 -21:49:21  93.039947 -21.822543 2267.524
     14 J060924-223303  59.4 131.5 295.3 06:09:24.2 -22:33:03  92.350788 -22.550861 2609.616
     15 J055505-295651 107.4  20.7 367.5 05:55:05.4 -29:56:51  88.772554 -29.947667 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.280 113.19    52.43    31.33  25.752  40.905  65.957     9.767     0.127
  0.32  0.166  91.63    28.00    16.02  23.753  42.244  26.383     1.687     0.055
  0.22  0.013 179.43    20.01    15.99  28.934  40.975  26.383     1.232     0.049
  0.52  0.380  87.97    48.26    27.61  28.263  42.272  26.383     5.916     0.104
  0.27  0.235 140.56    24.32    19.63  87.851 111.107 118.722    27.796     0.169
  0.22  0.186 133.22    15.93    24.07 175.885 194.031 197.870    12.535     0.155
  0.15  0.096 138.15    12.26     7.65  65.960 329.015  52.765     0.647     0.039
  0.20  0.181  90.68    19.91    16.11 232.786 279.536 211.061     4.453     0.102
  0.32  0.203 117.37    27.95    24.13  93.004 226.209 197.870    16.373     0.175
  0.25  0.199 134.05    16.11    19.91 211.882 228.161 211.061    12.293     0.161
  0.18  0.108 176.19    16.39    11.53  60.490 327.217  52.765     1.243     0.054
  0.27  0.230  90.44    27.96    28.07 199.616 248.932 263.826    50.402     0.256
  0.14  0.094 128.55    16.21    11.72 403.215 436.588 382.548     5.813     0.122
  0.46  0.145   9.67    20.56    43.79  13.748  25.718  26.383     1.688     0.053
  0.24  0.188 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 Nvoxel Nchan Nspatpix Flag
 [Jy/beam] [Jy/beam] [Jy/beam]                                                          
----------------------------------------------------------------------------------------
    10.873     0.142     0.213  16.17  53  65 136 143 113 118    116     4       57    F
     1.878     0.062     0.124   8.99  83  89  93  96 117 119     22     3       17    -
     1.372     0.054     0.118   8.60  82  86  82  85 117 119     17     3       13    -
     6.586     0.115     0.150  11.29  65  76  57  63 120 122     77     3       46    -
    30.943     0.188     0.410  31.17  50  55 143 147 158 167    205    10       27    E
    13.954     0.173     0.173  13.03  88  91  33  38 195 210    172    16       20    -
     0.720     0.044     0.078   4.92  34  36  58  59 215 219     11     5        5    -
     4.957     0.113     0.115   7.88  93  97  87  90 222 238     74    12       10    -
    18.227     0.195     0.166  11.99  86  92 142 147 224 239    219    16       29    E
    13.685     0.179     0.155   9.18  74  77  76  80 225 241    185    17       16    -
     1.384     0.060     0.093   5.73  33  36  57  59 233 237     21     5        9    -
    56.108     0.285     0.297  21.00  85  91 112 118 226 246    469    21       34    -
     6.471     0.135     0.101   6.10  48  51 141 143 257 286    106    30        9    -
     1.879     0.059     0.177  12.81  57  61 127 137 295 297     20     3       20    -
     3.485     0.079     0.169  12.66 106 109  19  22 366 369     36     4       14    -
\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 v.1.5: Wed Aug 28 11:07:28 2013
#
# ---- Parameters ----
      (... omitted for clarity -- see previous page for examples...)
# --------------------
#
# --------------------
# Summary of statistics:
# Detection threshold = 0.0461842 Jy/beam
# Noise level = 0.000122074, Noise spread = 0.0131606
# Full stats:
#  Mean   = 0.000421091	Std.Dev. = 0.013392
#  Median = 0.000122074	MADFM    = 0.00887669 (= 0.0131606 as std.dev.)
# --------------------
# Total number of detections = 15
# --------------------
\end{verbatim}
}

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