1muniphot(1) C-Munipack 1.2 muniphot(1)
2
6 muniphot - utility for photometry of CCD frames
7
9 muniphot [ options ] input-files ...
10
12 The muniphot command applies photometry to a single frame or a set of
13 CCD frames. The output is written to so-called photometry files.
14 Current version uses aperture photometry algorithm only. All source
16 frames must be in the FITS format.
17
19 Names of input files can be specified directly on a command-line as
20 command arguments; it is allowed to use the usual wildcard notation. In
21 case the input files are placed outside the working directory, you have
22 to specify the proper path relative to the current working directory.
23 Alternatively, you can also prepare a list of input file names in a
25 text file, each input file on a separate line. It is not allowed to use
26 the wildcard notation here. Use the -i option to instruct the program
27 to read the file.
28
30 By default, output files are stored to the current working directory.
31 Their names are derived from the command name followed by a sequential
32 number starting by 1. Command options allows a caller to modify the
33 default naming of output files:
34 The -o option sets the format string; it may contain a path where the
36 files shall be stored to. Special meaning has a sequence of question
37 marks, it is replaced by the ordinal number of a file indented by
38 leading zeros to the same number of decimal places as the number of the
39 question marks.
40 By means of the -i option, you can modify the initial value of a
42 counter.
43 On request, the program can write a list of output files to a text
45 file, use the -g option to specify a file name.
46
48 Options are used to provide extra information to customize the execu‐
49 tion of a command. They are specified as command arguments.
50 Each option has a full form starting with two dashes and an optional
52 short form starting with one dash only. Options are case-sensitive. It
53 is allowed to merge two or more successive short options together. Some
54 options require a value; in this case a value is taken from a subse‐
55 quent argument. When a full form is used, an option and its value can
56 also be separated by an equal sign. When a short form is used, its
57 value can immediately follow the option.
58 Whenever there is a conflict between a configuration file parameter and
60 an option of the same meaning, the option always take precedence.
61 -s, --set name=value
63 set value of configuration parameter
64 -i, --read-dirfile filepath
66 read list of input files from specified file; see the Files sec‐
67 tion for details.
68 -g, --make-dirfile filepath
70 save list of output files to specified file, existing content of
71 the file will be overwritten; see the Files section for details.
72 -o, --output-mask mask
74 set output file mask (default=kout????.fts), see the Files sec‐
75 tion for details.
76 -c, --counter value
78 set initial counter value (default=1), see the Files section for
79 details.
80 -p, --configuration-file filepath
82 read parameters from given configuration file. See the Configu‐
83 ration file section for details.
84 -h, --help
86 print list of command-line parameters
87 -q, --quiet
89 quiet mode; suppress all messages
90 --version
92 print software version string
93 --licence
95 print software licence
96 --verbose
98 verbose mode; print debug messages
99
101 Configuration files are used to set the input parameters to the process
102 that is going to be executed by a command. Use the -p option to
103 instruct the program to read the file before other command-line options
104 are processed.
105 The configuration file consists of a set of parameters stored in a text
107 file. Each parameter is stored on a separate line in the following
108 form: name = value, all other lines are silently ignored. Parameter
109 names are case-sensitive.
110 readns = value
112 Readout noise
113 gain = value
115 ADC gain
116 minvalue = value
118 Min. pixel value in ADU
119 maxvalue = value
121 Max. pixel value in ADU
122 fwhm = value
124 Expected FWHM in pixels
125 thresh = value
127 Detection threshold
128 minsharp = value
130 Low sharpness cutoff
131 maxsharp = value
133 High sharpness cutoff
134 minround = value
136 Low roundness cutoff
137 maxround = value
139 High roundness cutoff
140 skyinner = value
142 Inner radius of sky aperture
143 skyouter = value
145 Outer radius of sky aperture
146 apertures = value,value,...
148 Comma separated list of radii of star apertures
149
151 muniphot -oout?.pht test1.fts test2.fts test3.fts
152 The command performs photometry to the files test1.fts,
153 test2.fts and test3.st7 and writes the output to the files:
154 out1.pht, out2.pht and out3.pht.
155
157 The command returns a zero exit status if it succeeds to process all
158 specified files. Otherwise, it will stop immediately when an error
159 occurs and a nonzero error code is returned.
160
162 http://c-munipack.sourceforge.net/
163
165 David Motl, dmotl@volny.cz
166
168 This program is free software; you can redistribute it and/or modify it
169 under the terms of the GNU General Public License version 2 as pub‐
170 lished by the Free Software Foundation.
171 This program is distributed in the hope that it will be useful, but
173 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
174 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
175 Public License for more details.
176
178 cmunipack(3), muniwin(1), meanbias(1), meandark(1), autoflat(1), bias‐
179 bat(1), darkbat(1), flatbat(1), timebat(1), airmass(1), helcor(1), kom‐
180 bine(1), konve(1), munimatch(1), munilist(1)
181version 1.2.10 May 16, 2010 muniphot(1)