munimatch (1) - Linux Man Pages
munimatch: Matching of CCD photometry files
munimatch [options] ref=file source_file ...
The Munimatch finds corresponding stars in two photometry files. One file is refered as reference file, the second one is called source file. The output of the matching process is the photometry file, which the stars from source file is written in, but their order is changed, so corresponding stars are on the same indices in output and reference files. Instead of a reference file, which is usually one frame from a sequence being processed, a catalogue file in XML format can be used.
The source and output files have to be in photometry file format. The reference file should be in photometry or catalogue file format, optionally. If a set of files is processed, then the reference file is common for all sources.
The list of input files is usualy entered directly on the command line. If you are going to process a large set of files, you can use the question marks (for a single chars) or the asterisk (for a strings of chars).
The alternate way, how to process a large set of files, is the batch mode. In this mode, the list of input files is read from a given file or from the standard input. The directory file, for example named dirfile, must have the text format and the names of the input files are written on the separate lines. If the files are placed not in the current working directory, you have to specify the proper path in full or shortened form.
- The program will read the list of source files from specified file.
- The program will read the list of source files from stdin.
- Optional parameter file. Default is munimatch.ini.
- Name of the reference or the catalogue file.
- Prints short help.
- Prints the license.
- Prints the program name and its version.
- Quiet mode -- inhibits the screen printouts.
Debug mode -- extends the screen printouts.
The following command matches 'tmp0001.srt' as source file and 'ref.srt' as reference file and the output writes to 'tmp0001.mat'.
munimatch ref=ref.srt tmp0001.srt
munimatch returns a zero exist status if it succeeds to convert all specified file. Otherwise, it will stop immediately when the error occurs and returns nonzero code.
The project manager David Motl is also the author of the most part of the source codes. Some algorithms originates from Munipack package, coded by Filip Hroch. Algorithms for aperture photometry originates from Daophot software by P. B. Stetson. Munifind algorithm originates from Varfind tool written by Rudolf Novak and Lukas Kral.
The package uses the FITSIO library (Dr. William Pence, NASA), the FreeImage library maintained by Herve Drolon and the James Clark's EXPAT library.
The english version of the documentation was written by David Motl with great help of Petr Lutcha and Jitka Kudrnacova.
David Motl (dmotl [at] volny.cz)
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.