1munimatch(1) C-Munipack 1.2 munimatch(1)
2
6 munimatch - utility for finding matching photometry files
7
9 munimatch [ options ] reference-file input-files ...
10
12 The munimatch command finds corresponding stars in two photometry
13 files. One file is refered as reference file, the second one is called
14 source file. The output of the matching process is the photometry file,
15 which the stars from source file is written in, but their order is
16 changed, so corresponding stars are on the same indices in output and
17 reference files. Instead of a reference file, which is usually one
18 frame from a sequence being processed, a catalogue file in XML format
19 can be used.
20 The source and output files have to be in photometry file format. The
22 reference file should be in photometry or catalogue file format,
23 optionally. If a set of files is processed, then the reference file is
24 common for all sources.
25
27 Names of input files can be specified directly on a command-line as
28 command arguments; it is allowed to use the usual wildcard notation. In
29 case the input files are placed outside the working directory, you have
30 to specify the proper path relative to the current working directory.
31 Alternatively, you can also prepare a list of input file names in a
33 text file, each input file on a separate line. It is not allowed to use
34 the wildcard notation here. Use the -i option to instruct the program
35 to read the file.
36
38 By default, output files are stored to the current working directory.
39 Their names are derived from the command name followed by a sequential
40 number starting by 1. Command options allows a caller to modify the
41 default naming of output files:
42 The -o option sets the format string; it may contain a path where the
44 files shall be stored to. Special meaning has a sequence of question
45 marks, it is replaced by the ordinal number of a file indented by
46 leading zeros to the same number of decimal places as the number of the
47 question marks.
48 By means of the -i option, you can modify the initial value of a
50 counter.
51 On request, the program can write a list of output files to a text
53 file, use the -g option to specify a file name.
54
56 Options are used to provide extra information to customize the execu‐
57 tion of a command. They are specified as command arguments.
58 Each option has a full form starting with two dashes and an optional
60 short form starting with one dash only. Options are case-sensitive. It
61 is allowed to merge two or more successive short options together. Some
62 options require a value; in this case a value is taken from a subse‐
63 quent argument. When a full form is used, an option and its value can
64 also be separated by an equal sign. When a short form is used, its
65 value can immediately follow the option.
66 Whenever there is a conflict between a configuration file parameter and
68 an option of the same meaning, the option always take precedence.
69 -s, --set name=value
71 set value of configuration parameter
72 -i, --read-dirfile filepath
74 read list of input files from specified file; see the Files sec‐
75 tion for details.
76 -g, --make-dirfile filepath
78 save list of output files to specified file, existing content of
79 the file will be overwritten; see the Files section for details.
80 -o, --output-mask mask
82 set output file mask (default=%.mat), see the Files section for
83 details.
84 -c, --counter value
86 set initial counter value (default=1), see the Files section for
87 details.
88 -p, --configuration-file filepath
90 read parameters from given configuration file. See the Configu‐
91 ration file section for details.
92 -h, --help
94 print list of command-line parameters
95 -q, --quiet
97 quiet mode; suppress all messages
98 --version
100 print software version string
101 --licence
103 print software licence
104 --verbose
106 verbose mode; print debug messages
107
109 Configuration files are used to set the input parameters to the process
110 that is going to be executed by a command. Use the -p option to
111 instruct the program to read the file before other command-line options
112 are processed.
113 The configuration file consists of a set of parameters stored in a text
115 file. Each parameter is stored on a separate line in the following
116 form: name = value, all other lines are silently ignored. Parameter
117 names are case-sensitive.
118 max_stars = value
120 Max. number of input stars
121 vertices = value
123 Number of polygon vertices
124 clip_thresh = value
126 Clipping threshold
127 sp_fields = value
129 Matching method
130 sp_maxoffset = value
132 Max. offset for sparse fields
133
135 munimatch -oout.mat ref.pht in.pht
136 The command matches file in.pht as a source file and ref.pht as
137 reference file and the writes output to out.mat.
138
140 The command returns a zero exit status if it succeeds to process all
141 specified files. Otherwise, it will stop immediately when an error
142 occurs and a nonzero error code is returned.
143
145 http://c-munipack.sourceforge.net/
146
148 David Motl, dmotl@volny.cz
149
151 This program is free software; you can redistribute it and/or modify it
152 under the terms of the GNU General Public License version 2 as pub‐
153 lished by the Free Software Foundation.
154 This program is distributed in the hope that it will be useful, but
156 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
157 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
158 Public License for more details.
159
161 cmunipack(3), muniwin(1), meanbias(1), meandark(1), autoflat(1), bias‐
162 bat(1), darkbat(1), flatbat(1), timebat(1), airmass(1), helcor(1), kom‐
163 bine(1), konve(1), muniphot(1), munilist(1)
164version 1.2.10 May 16, 2010 munimatch(1)