source: branches/pixel-map-branch/InputComplete @ 1441

Last change on this file since 1441 was 255, checked in by Matthew Whiting, 17 years ago
  • Mostly Guide changes, thanks to the xspace package. Some alteration of the statistics calculation description, thanks to the new statsec parameter.
  • Also changed the default value of the reconDim parameter -- now default is 1-dimensional.
File size: 6.3 KB
RevLine 
[71]1# FULL PARAMETER LIST
2# -------------------
3#
[142]4# This file contains the full list of user-definable parameters. They are
5#  grouped here according to their use, and the values quoted are the defaults:
6#  if a given parameter is not included in your parameter file, this is the
7#  value it will take.
[71]8#
9#
[3]10# INPUT RELATED
11# imageFile -- the FITS image.
12# flagSubsection -- whether to get a subsection of that image.
13# subsection -- the subsection to read in, in format [x1:x2,y1:y2,z1:z2],
14#               or * to indicate the full range
[211]15# flagReconExists -- set to true if the reconstructed cube exists as a FITS
[142]16#                    file (ie. it has been saved from a previous Duchamp run)
[211]17# reconFile -- the location of the FITS file containing the reconstructed cube
18# flagSmoothExists -- set to true if the smoothed cube exists as a FITS
19#                    file (ie. it has been saved from a previous Duchamp run)
20# smoothFile -- the location of the FITS file containing the smoothed cube
[3]21
22imageFile       your-file-here
[71]23flagSubsection  0
[3]24subsection      [*,*,*]
[71]25flagReconExists 0
26reconFile       your-reconstructed-file-here
[211]27flagReconExists 1
28reconFile       your-smoothed-file-here
[3]29
30# OUTPUT RELATED
[142]31# flagLog -- log the intermediate results?   
32# logfile-- the file to put that in.
[3]33# outFile -- the final output list.
34# spectraFile -- the postscript file of spectra
[211]35# flagOutputSmooth -- whether to save the smoothed arrays as a FITS file
[142]36# flagOutputRecon/Resid -- whether to save the reconstruction & residual arrays
37#                          as FITS files
38# flagVOT -- make a VOTable file of the results? 
39# votFile -- the file to put it in
40# flagKarma -- make a Karma annotation file of the results? 
41# karmaFile -- the file to put it in
[17]42# flagMaps -- save postscript versions of the detection and 0th moment maps?
[3]43# detectionMap, momentMap -- the postscript files produced.
[195]44# flagXOutput -- display the moment map in a pgplot window
[3]45
46flagLog         1
[87]47logFile         duchamp-Logfile.txt
48outFile         duchamp-Results.txt
49spectraFile     duchamp-Spectra.ps
[211]50flagOutputSmooth 0
[3]51flagOutputRecon 0
52flagOutputResid 0
53flagVOT         0
[87]54votFile         duchamp-Results.xml
[26]55flagKarma       0
[87]56karmaFile       duchamp-Results.ann
[3]57flagMaps        1
[87]58detectionMap    duchamp-DetectionMap.ps
59momentMap       duchamp-MomentMap.ps
[195]60flagXOutput     1
[3]61
62# FIXING UP THE CUBE
63# flagBlankPix -- whether to replace & ignore blank pixels.
[142]64# blankPixValue -- what value they should take. This is overridden by
65#                  FITS header information.
[3]66# flagBaseline -- whether to subtract spectral baselines before searching
[142]67# flagMW -- ignore a range of channels (to remove Milky Way emission)?
68# minMW, maxMW -- the first and last channels to be ignored
[3]69
70flagBlankPix    1
71blankPixValue   -8.00061
[71]72flagMW          0
[3]73minMW           75
74maxMW           112
[87]75flagBaseline    0
[3]76
77# GENERAL DETECTION RELATED
[255]78# flagStatSec -- Whether to only use a subsection of the cube to calculate
79#                the statistics.
80# StatSec -- The subsection used for statistics calculations. It has the
81#            same format as the pixel subsection.
[142]82# flagNegative -- Are the features being searched for negative (set to true)
83#                 or positive (false -- the default)?
[3]84# snrCut --  How many sigma above mean is a detection when sigma-clipping
[195]85# threshold -- The threshold flux dividing source and non-source. Used instead
86#              of calculating it from the cube's statistics. If not specified,
87#              it will be calculated.
[3]88# flagGrowth -- Should the detections be "grown" to a lower significance value?
89# growthCut -- The lower threshold used when growing detections
90
[254]91flagStatSec     0
92StatSec         [*,*,*]
[63]93flagNegative    0
[71]94snrCut          3.
[195]95threshold       0.
[3]96flagGrowth      0
[87]97growthCut       2.
[3]98
99# RECONSTRUCTION RELATED
100# flagATrous -- Whether or not to do the reconstruction before searching
[142]101# reconDim -- The number of dimensions in which to perform the reconstruction.
102# scaleMin -- The minimum scale (starts at 1) to be included in the
103#              reconstruction
[3]104# snrRecon -- The threshold used in filtering the wavelet coefficient arrays.
[142]105# filterCode -- The code number for the choice of filter to be used in the
106#               reconstruction:  1 = B3-spline filter, 2 = Triangle function,
107#                                3 = Haar wavelet. Other numbers default to 2.
[3]108
109flagATrous      1
[255]110reconDim        1
[3]111scaleMin        1
[71]112snrRecon        4.
[106]113filterCode      1
[3]114
[211]115# HANNING SMOOTHING
116# flagSmooth -- whether to Hanning-smooth the spectral dimension of the cube.
117# hanningWidth -- the width parameter of the Hanning smoothing function
118
119flagSmooth      false
120hanningWidth    5
121
[3]122# FALSE DISCOVERY RATE METHOD
123# flagFDR -- Whether or not to use the false discovery rate method instead of
124#   simple sigma clipping.
[142]125# alphaFDR -- The "alpha" parameter for the FDR method -- what desired
126#             percentage of discoveries will be false. Expressed as a decimal.
[3]127
128flagFDR         0
[71]129alphaFDR        0.01
[3]130
131# MERGING PARAMETERS
[142]132# flagAdjacent -- Whether to use the "adjacent criterion" to judge if objects
133#                  are to be merged.
134# threshSpatial -- If flagAdjacent=false, this is the maximum spatial
135#                   separation between objects for them to be merged.
136# threshVelocity -- The maximum channel separation between objects for them
137#                   to be merged.
138# minChannels -- The minimum number of consecutive channels an object must have
139#                 for it to be accepted.
140# minPix -- Minimum number of spatial pixels a detected object must have for
141#            it to be counted
[3]142
143flagAdjacent    1
144threshSpatial   3
145threshVelocity  7
[71]146minChannels     3
147minPix          2
[3]148
149# OTHER PARAMETERS
[142]150# verbose -- whether to provide progress indicators on the terminal during
151#             execution
152# drawBorders -- whether to draw borders around the detections on the moment
153#                 maps in the output.
154# drawBlankEdges -- whether to draw an outline around any BLANK regions in the
155#                    moment maps and image cutouts.
156# spectralMethod -- how to plot the spectra in the output -- the spectrum of
157#                    the peak pixel ("peak" -- the default), or integrated over
158#                    all spatial pixels present ("sum")
159# spectralUnits -- what units you want the spectral axis to be plotted in and
160#                   values quoted in (including the units of integrated flux)
161
[3]162verbose         1
163drawBorders     1
[142]164drawBlankEdges  1
[64]165spectralMethod  peak
[103]166spectralUnits   km/s
Note: See TracBrowser for help on using the repository browser.