munifind (1) - Linux Manuals

munifind: Finding variable stars on CCD photometry files

NAME

munifind - Finding variable stars on CCD photometry files

SYNOPSIS

munifind [options] source_file ...

DESCRIPTION

The munifind program is the useful tool used in semi-automatic scaning of variable stars in the series of source files. It is based on the relation between the standard deviations of the brightness of the stars and their mean brightness. The program reads all photometry files and compute the mean brightness and standard deviations of brightness of all stars. The algorithm automatically removes stars that are missing on majority of source frames (threshold parameter). The comparison star is automaticaly selected or given by a optional parameter.

The output file is saved in text format and contains the table of mean magnitudes and standard deviations.

OPTIONS

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.

@dirfile

The program will read the list of source files from specified file.

@

The program will read the list of source files from stdin.

src=file, -afile

Optional source file name in read-all format.

par=file -pfile

Optional parameter file. Default is munifind.ini.

out=file, -ofile

Name of the output file. Default is munifind.dat.

--help

Prints short help.

--license

Prints the license.

--version

Prints the program name and its version.

--quiet

Quiet mode -- inhibits the screen printouts.

--debug

Debug mode -- extends the screen printouts.

EXAMPLES

The following command demonstrates, how to create a file of magnitudes and the deviations from the source files 'test1.mat', 'test2.mat' and 'test3.mat'.

munifind test1.mat test2.mat test3.mat

EXIT STATUS

munifind 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.

DIRECTORIES

~/.cmunipack /usr/local/share/cmunipack

AUTHORS

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.

BUG REPORTS

David Motl (dmotl [at] volny.cz)

COPYING

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.