source: tags/release-1.6.1/docs/app-resultsEx.tex

Last change on this file was 1276, checked in by MatthewWhiting, 11 years ago

Large amount of documentation updates, getting everything up to date with the recent changes, and ensuring the example outputs are compatible with how things are done now.
File size: 9.0 KB
Line 
1% -----------------------------------------------------------------------
2% app-results-Ex.tex: Example results output file.
3% -----------------------------------------------------------------------
4% Copyright (C) 2006, Matthew Whiting, ATNF
5%
6% This program is free software; you can redistribute it and/or modify it
7% under the terms of the GNU General Public License as published by the
8% Free Software Foundation; either version 2 of the License, or (at your
9% option) any later version.
10%
11% Duchamp is distributed in the hope that it will be useful, but WITHOUT
12% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13% FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14% for more details.
15%
16% You should have received a copy of the GNU General Public License
17% along with Duchamp; if not, write to the Free Software Foundation,
18% Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
19%
20% Correspondence concerning Duchamp may be directed to:
21%    Internet email: Matthew.Whiting [at] atnf.csiro.au
22%    Postal address: Dr. Matthew Whiting
23%                    Australia Telescope National Facility, CSIRO
24%                    PO Box 76
25%                    Epping NSW 1710
26%                    AUSTRALIA
27% -----------------------------------------------------------------------
28%\begin{landscape}
29\secA{Example results file}
30\label{app-output}
31This the typical content of an output file, after running \duchamp
32with the parameters illustrated on the previous page. The table is
33wide, and has been split into four sections to make it easier to read.
34%\begin{figure*}
35%\begin{minipage}{170mm}
36{\scriptsize
37\begin{verbatim}
38#-------------------------------------------------------------------------------------------
39# ObjID           Name     X     Y     Z         RA       DEC         RA        DEC     VRAD
40#                                                                  [deg]      [deg]   [km/s]
41#-------------------------------------------------------------------------------------------
42      1 J060930-215738  58.9 140.4 114.5 06:09:30.9 -21:57:38  92.378723 -21.960721  223.964
43      2 J060143-250033  86.0  94.9 117.9 06:01:43.0 -25:00:33  90.429334 -25.009433  269.253
44      3 J060217-254714  84.0  83.2 118.0 06:02:17.6 -25:47:14  90.573276 -25.787385  270.507
45      4 J060605-271848  71.4  60.2 121.3 06:06:05.8 -27:18:48  91.524232 -27.313549  313.411
46      5 J061118-213635  52.5 145.5 162.6 06:11:18.6 -21:36:35  92.827691 -21.609736  858.050
47      6 J060034-285857  89.7  35.3 202.5 06:00:34.0 -28:58:57  90.141557 -28.982718 1384.415
48      7 J061700-272250  35.0  58.6 216.5 06:17:00.9 -27:22:50  94.253896 -27.380808 1570.316
49      8 J055847-252517  95.9  88.6 232.9 05:58:47.5 -25:25:17  89.697895 -25.421585 1786.082
50      9 J060053-214223  88.9 144.3 233.2 06:00:53.3 -21:42:23  90.222109 -21.706623 1789.639
51     10 J060444-260644  75.8  78.3 233.2 06:04:44.7 -26:06:44  91.186272 -26.112238 1790.501
52     11 J061706-272510  34.7  58.0 235.2 06:17:06.8 -27:25:10  94.278350 -27.419558 1816.205
53     12 J060106-233956  88.0 115.0 235.5 06:01:06.8 -23:39:56  90.278502 -23.665813 1820.251
54     13 J061209-214921  49.6 142.3 269.4 06:12:09.6 -21:49:21  93.039947 -21.822543 2267.524
55     14 J060924-223303  59.4 131.5 295.3 06:09:24.2 -22:33:03  92.350788 -22.550861 2609.616
56     15 J055505-295651 107.4  20.7 367.5 05:55:05.4 -29:56:51  88.772554 -29.947667 3561.487
57
58----------------------------------------------------------------------------------
59   MAJ    MIN     PA     w_RA    w_DEC    w_50    w_20  w_VRAD     F_int    eF_int
60 [deg]  [deg]  [deg] [arcmin] [arcmin]  [km/s]  [km/s]  [km/s] [Jy km/s] [Jy km/s]
61----------------------------------------------------------------------------------
62  0.43  0.280 113.19    52.43    31.33  25.752  40.905  65.957     9.767     0.127
63  0.32  0.166  91.63    28.00    16.02  23.753  42.244  26.383     1.687     0.055
64  0.22  0.013 179.43    20.01    15.99  28.934  40.975  26.383     1.232     0.049
65  0.52  0.380  87.97    48.26    27.61  28.263  42.272  26.383     5.916     0.104
66  0.27  0.235 140.56    24.32    19.63  87.851 111.107 118.722    27.796     0.169
67  0.22  0.186 133.22    15.93    24.07 175.885 194.031 197.870    12.535     0.155
68  0.15  0.096 138.15    12.26     7.65  65.960 329.015  52.765     0.647     0.039
69  0.20  0.181  90.68    19.91    16.11 232.786 279.536 211.061     4.453     0.102
70  0.32  0.203 117.37    27.95    24.13  93.004 226.209 197.870    16.373     0.175
71  0.25  0.199 134.05    16.11    19.91 211.882 228.161 211.061    12.293     0.161
72  0.18  0.108 176.19    16.39    11.53  60.490 327.217  52.765     1.243     0.054
73  0.27  0.230  90.44    27.96    28.07 199.616 248.932 263.826    50.402     0.256
74  0.14  0.094 128.55    16.21    11.72 403.215 436.588 382.548     5.813     0.122
75  0.46  0.145   9.67    20.56    43.79  13.748  25.718  26.383     1.688     0.053
76  0.24  0.188 155.90    15.76    16.25  30.543  45.907  39.574     3.131     0.071
77
78----------------------------------------------------------------------------------------
79     F_tot    eF_tot    F_peak S/Nmax  X1  X2  Y1  Y2  Z1  Z2 Nvoxel Nchan Nspatpix Flag
80 [Jy/beam] [Jy/beam] [Jy/beam]                                                         
81----------------------------------------------------------------------------------------
82    10.873     0.142     0.213  16.17  53  65 136 143 113 118    116     4       57    F
83     1.878     0.062     0.124   8.99  83  89  93  96 117 119     22     3       17    -
84     1.372     0.054     0.118   8.60  82  86  82  85 117 119     17     3       13    -
85     6.586     0.115     0.150  11.29  65  76  57  63 120 122     77     3       46    -
86    30.943     0.188     0.410  31.17  50  55 143 147 158 167    205    10       27    E
87    13.954     0.173     0.173  13.03  88  91  33  38 195 210    172    16       20    -
88     0.720     0.044     0.078   4.92  34  36  58  59 215 219     11     5        5    -
89     4.957     0.113     0.115   7.88  93  97  87  90 222 238     74    12       10    -
90    18.227     0.195     0.166  11.99  86  92 142 147 224 239    219    16       29    E
91    13.685     0.179     0.155   9.18  74  77  76  80 225 241    185    17       16    -
92     1.384     0.060     0.093   5.73  33  36  57  59 233 237     21     5        9    -
93    56.108     0.285     0.297  21.00  85  91 112 118 226 246    469    21       34    -
94     6.471     0.135     0.101   6.10  48  51 141 143 257 286    106    30        9    -
95     1.879     0.059     0.177  12.81  57  61 127 137 295 297     20     3       20    -
96     3.485     0.079     0.169  12.66 106 109  19  22 366 369     36     4       14    -
97\end{verbatim}
98\newpage
99\begin{verbatim}
100------------------------------------------------------------
101  X_av  Y_av  Z_av X_cent Y_cent Z_cent X_peak Y_peak Z_peak
102                                                           
103------------------------------------------------------------
104  59.1 140.4 114.6   58.9  140.4  114.5     59    140    114
105  86.0  94.9 117.9   86.0   94.9  117.9     85     95    118
106  84.1  83.2 118.0   84.0   83.2  118.0     84     83    118
107  71.2  60.2 121.2   71.4   60.2  121.3     72     61    121
108  52.5 145.4 162.5   52.5  145.5  162.6     53    146    164
109  89.7  35.3 202.7   89.7   35.3  202.5     90     36    197
110  35.0  58.5 216.6   35.0   58.6  216.5     35     59    215
111  95.9  88.6 232.6   95.9   88.6  232.9     96     89    237
112  88.8 144.3 232.7   88.9  144.3  233.2     89    144    233
113  75.8  78.3 233.2   75.8   78.3  233.2     76     78    240
114  34.7  58.0 235.0   34.7   58.0  235.2     35     58    236
115  88.1 115.0 235.8   88.0  115.0  235.5     88    115    231
116  49.6 142.3 270.0   49.6  142.3  269.4     50    142    259
117  59.2 131.6 295.5   59.4  131.5  295.3     60    132    295
118 107.5  20.7 367.5  107.4   20.7  367.5    108     21    367
119\end{verbatim}
120}
121
122A good trick for those using UNIX/Linux is to make use of the
123\texttt{a2ps} command. The following works well:
124\begin{quote}
125{\footnotesize
126\texttt{> a2ps -1 -r -f5 -o duchamp-Results.ps duchamp-Results.txt}
127}
128\end{quote}
129and produces a postscript file \texttt{duchamp-Results.ps}.
130
131The table is preceded by information on the parameters used (see the
132previous section), the statistics and threshold values, and the number
133of detections. If \texttt{flagSeparateHeader} is set to \texttt{true},
134this information is put in a separate file. This information looks
135like the following:
136
137{\footnotesize
138\begin{verbatim}
139# Results of the Duchamp source finder v.1.5: Wed Aug 28 11:07:28 2013
140#
141# ---- Parameters ----
142      (... omitted for clarity -- see previous page for examples...)
143# --------------------
144#
145# --------------------
146# Summary of statistics:
147# Detection threshold = 0.0461842 Jy/beam
148# Noise level = 0.000122074, Noise spread = 0.0131606
149# Full stats:
150#  Mean   = 0.000421091 Std.Dev. = 0.013392
151#  Median = 0.000122074 MADFM    = 0.00887669 (= 0.0131606 as std.dev.)
152# --------------------
153# Total number of detections = 15
154# --------------------
155\end{verbatim}
156}
157
158%%% Local Variables:
159%%% mode: latex
160%%% TeX-master: "Guide"
161%%% End:
Note: See TracBrowser for help on using the repository browser.