1 | % ----------------------------------------------------------------------- |
---|
2 | % app-paramEx.tex: Example input parameter files, and how the |
---|
3 | % parameters are listed in the output. |
---|
4 | % ----------------------------------------------------------------------- |
---|
5 | % Copyright (C) 2006, Matthew Whiting, ATNF |
---|
6 | % |
---|
7 | % This program is free software; you can redistribute it and/or modify it |
---|
8 | % under the terms of the GNU General Public License as published by the |
---|
9 | % Free Software Foundation; either version 2 of the License, or (at your |
---|
10 | % option) any later version. |
---|
11 | % |
---|
12 | % Duchamp is distributed in the hope that it will be useful, but WITHOUT |
---|
13 | % ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
---|
14 | % FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
---|
15 | % for more details. |
---|
16 | % |
---|
17 | % You should have received a copy of the GNU General Public License |
---|
18 | % along with Duchamp; if not, write to the Free Software Foundation, |
---|
19 | % Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA |
---|
20 | % |
---|
21 | % Correspondence concerning Duchamp may be directed to: |
---|
22 | % Internet email: Matthew.Whiting [at] atnf.csiro.au |
---|
23 | % Postal address: Dr. Matthew Whiting |
---|
24 | % Australia Telescope National Facility, CSIRO |
---|
25 | % PO Box 76 |
---|
26 | % Epping NSW 1710 |
---|
27 | % AUSTRALIA |
---|
28 | % ----------------------------------------------------------------------- |
---|
29 | \secA{Example parameter files} |
---|
30 | \label{app-input} |
---|
31 | |
---|
32 | This is what a typical parameter file would look like. |
---|
33 | |
---|
34 | \begin{verbatim} |
---|
35 | imageFile /home/mduchamp/fountain.fits |
---|
36 | logFile logfile.txt |
---|
37 | outFile results.txt |
---|
38 | spectraFile spectra.ps |
---|
39 | flagSubsection false |
---|
40 | flagOutputRecon false |
---|
41 | flagOutputResid 0 |
---|
42 | flagTrim 1 |
---|
43 | flagMW 1 |
---|
44 | minMW 75 |
---|
45 | maxMW 112 |
---|
46 | flagGrowth 1 |
---|
47 | growthCut 1.5 |
---|
48 | flagATrous 1 |
---|
49 | reconDim 1 |
---|
50 | scaleMin 1 |
---|
51 | snrRecon 4 |
---|
52 | flagFDR 1 |
---|
53 | alphaFDR 0.1 |
---|
54 | snrCut 3 |
---|
55 | threshSpatial 3 |
---|
56 | threshVelocity 7 |
---|
57 | \end{verbatim} |
---|
58 | |
---|
59 | Note that, as in this example, the flag parameters can be entered as |
---|
60 | strings (\texttt{true}/\texttt{false}) or integers |
---|
61 | (\texttt{1}/\texttt{0}). Also, note that it is not necessary to |
---|
62 | include all these parameters in the file, only those that need to be |
---|
63 | changed from the defaults (as listed in Appendix~\ref{app-param}), |
---|
64 | which in this case would be very few. A minimal parameter file might |
---|
65 | look like: |
---|
66 | \begin{verbatim} |
---|
67 | imageFile /home/mduchamp/fountain.fits |
---|
68 | flagLog false |
---|
69 | flagATrous 1 |
---|
70 | snrRecon 3 |
---|
71 | snrCut 2.5 |
---|
72 | minChannels 4 |
---|
73 | \end{verbatim} |
---|
74 | This will reconstruct the cube with a lower SNR value than the |
---|
75 | default, select objects at a lower threshold, with a looser minimum |
---|
76 | channel requirement, and not keep a log of the intermediate |
---|
77 | detections. |
---|
78 | |
---|
79 | The following page demonstrates how the parameters are presented to |
---|
80 | the user, both on the screen at execution time, and in the output and |
---|
81 | log files. On each line, there is a description on the parameter, the |
---|
82 | relevant parameter name that is used in the input file (if there is |
---|
83 | one that the user can enter), and the value of the parameter being |
---|
84 | used. |
---|
85 | |
---|
86 | %\begin{sideways} |
---|
87 | %Typical presentation of parameters in output and log files: |
---|
88 | %\begin{minipage}{170mm} |
---|
89 | % |
---|
90 | % NOTE -- EXCISED THESE FROM THE EXAMPLE, AS THE SECOND LINE IS 18PT |
---|
91 | % TOO LONG... |
---|
92 | %Reconstructed array exists?................[reconExists] = true |
---|
93 | %FITS file containing reconstruction..........[reconFile] = fountain.RECON-1-1-4-1.fits |
---|
94 | {\scriptsize |
---|
95 | \begin{verbatim} |
---|
96 | ---- Parameters ---- |
---|
97 | Image to be analysed.........................[imageFile] = fountain.fits |
---|
98 | Intermediate Logfile...........................[logFile] = duchamp-Logfile.txt |
---|
99 | Final Results file.............................[outFile] = duchamp-Results.txt |
---|
100 | Spectrum file..............................[spectraFile] = duchamp-Spectra.ps |
---|
101 | 0th Moment Map...............................[momentMap] = duchamp-MomentMap.ps |
---|
102 | Detection Map.............................[detectionMap] = duchamp-DetectionMap.ps |
---|
103 | Display a map in a pgplot xwindow?.........[flagXOutput] = true |
---|
104 | Saving reconstructed cube?.............[flagoutputrecon] = false |
---|
105 | Saving residuals from reconstruction?..[flagoutputresid] = false |
---|
106 | ------ |
---|
107 | Blank Pixel Value....................................... = -8.00061 |
---|
108 | Trimming Blank Pixels?........................[flagTrim] = true |
---|
109 | Searching for Negative features?..........[flagNegative] = false |
---|
110 | Removing Milky Way channels?....................[flagMW] = true |
---|
111 | Milky Way Channels.......................[minMW - maxMW] = 75-112 |
---|
112 | Beam Size (pixels)...................................... = 10.1788 |
---|
113 | Removing baselines before search?.........[flagBaseline] = false |
---|
114 | Smoothing each spectrum first?..............[flagSmooth] = false |
---|
115 | Using A Trous reconstruction?...............[flagATrous] = true |
---|
116 | Number of dimensions in reconstruction........[reconDim] = 1 |
---|
117 | Minimum scale in reconstruction...............[scaleMin] = 1 |
---|
118 | SNR Threshold within reconstruction...........[snrRecon] = 4 |
---|
119 | Filter being used for reconstruction........[filterCode] = 1 (B3 spline function) |
---|
120 | Using FDR analysis?............................[flagFDR] = false |
---|
121 | SNR Threshold (in sigma)........................[snrCut] = 3 |
---|
122 | Minimum # Pixels in a detection.................[minPix] = 2 |
---|
123 | Minimum # Channels in a detection..........[minChannels] = 3 |
---|
124 | Growing objects after detection?............[flagGrowth] = false |
---|
125 | Using Adjacent-pixel criterion?...........[flagAdjacent] = true |
---|
126 | Max. velocity separation for merging....[threshVelocity] = 7 |
---|
127 | Method of spectral plotting.............[spectralMethod] = peak |
---|
128 | Type of object centre used in results......[pixelCentre] = centroid |
---|
129 | -------------------- |
---|
130 | \end{verbatim} |
---|
131 | } |
---|
132 | %\end{minipage} |
---|
133 | %\end{sideways} |
---|