1kombine(1)                      C-Munipack 1.2                      kombine(1)
2
3
4

NAME

6       kombine - utility for making conbining CCD frames
7

SYNOPSIS

9       kombine [ options ] output-file input-files ...
10

DESCRIPTION

12       The kombine command combines a set of CCD frames to a single CCD frame.
13       The source frames should be corrected already. The  source  frames  are
14       shifted  by the offset stored in the corresponding photometry file with
15       offset values. The photometry  files  are  products  of  the  Munimatch
16       utility.  Then,  the  resulting  values  are computed pixel by pixel by
17       means of the mean algorithm (sum divided by total  number  of  frames).
18       Pixels  in  those regions, which are not covered by all frames, are set
19       to zero. Pixels, which are zero on at least one of the  source  frames,
20       are set always to zero. Pixels, which are overexposed on one the source
21       frames, are set always to maximal value (655535 ADU).
22
23       All source frames must be in FITS format and of same dimensions. Frames
24       of  the  same  color filter and exposition duration should be used. The
25       output file is in FITS format too.
26

INPUT FILES

28       Names of input files can be specified directly  on  a  command-line  as
29       command arguments; it is allowed to use the usual wildcard notation. In
30       case the input files are placed outside the working directory, you have
31       to specify the proper path relative to the current working directory.
32
33       Alternatively,  you  can  also  prepare a list of input file names in a
34       text file, each input file on a separate line. It is not allowed to use
35       the  wildcard  notation here. Use the -i option to instruct the program
36       to read the file.
37

OPTIONS

39       Options are used to provide extra information to customize  the  execu‐
40       tion of a command. They are specified as command arguments.
41
42       Each  option  has  a full form starting with two dashes and an optional
43       short form starting with one dash only. Options are case-sensitive.  It
44       is allowed to merge two or more successive short options together. Some
45       options require a value; in this case a value is taken  from  a  subse‐
46       quent  argument.  When a full form is used, an option and its value can
47       also be separated by an equal sign. When a  short  form  is  used,  its
48       value can immediately follow the option.
49
50       Whenever there is a conflict between a configuration file parameter and
51       an option of the same meaning, the option always take precedence.
52
53       -s, --set name=value
54              set value of configuration parameter
55
56       -i, --read-dirfile filepath
57              read list of input files from specified file; see the Files sec‐
58              tion for details.
59
60       -p, --configuration-file filepath
61              read  parameters from given configuration file. See the Configu‐
62              ration file section for details.
63
64       -h, --help
65              print list of command-line parameters
66
67       -q, --quiet
68              quiet mode; suppress all messages
69
70       --version
71              print software version string
72
73       --licence
74              print software licence
75
76       --verbose
77              verbose mode; print debug messages
78

CONFIGURATION FILE

80       Configuration files are used to set the input parameters to the process
81       that  is  going  to  be  executed  by  a  command. Use the -p option to
82       instruct the program to read the file before other command-line options
83       are processed.
84
85       The configuration file consists of a set of parameters stored in a text
86       file. Each parameter is stored on a  separate  line  in  the  following
87       form:  name  =  value,  all other lines are silently ignored. Parameter
88       names are case-sensitive.
89
90       bitpix = value
91              output data format (0=Auto)
92

EXAMPLES

94       kombine ouptut.fts test1.fts test2.fts test3.fts
95              The  command  computes  the  combined  frame  from   the   files
96              test1.fts,  test2.fts a test3.fts; the resulting frame is stored
97              to output.fts.
98

EXIT STATUS

100       The command returns a zero exit status if it succeeds  to  process  all
101       specified  files.  Otherwise,  it  will  stop immediately when an error
102       occurs and a nonzero error code is returned.
103

HOME PAGE

105       http://c-munipack.sourceforge.net/
106

BUG REPORTS

108       David Motl, dmotl@volny.cz
109

COPYING

111       This program is free software; you can redistribute it and/or modify it
112       under  the  terms  of  the GNU General Public License version 2 as pub‐
113       lished by the Free Software Foundation.
114
115       This program is distributed in the hope that it  will  be  useful,  but
116       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
117       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the  GNU  General
118       Public License for more details.
119

SEE ALSO

121       cmunipack(3),  muniwin(1), meanbias(1), meandark(1), autoflat(1), bias‐
122       bat(1),  darkbat(1),  flatbat(1),  timebat(1),  airmass(1),  helcor(1),
123       konve(1), muniphot(1), munimatch(1), munilist(1)
124
125
126
127version 1.2.10                   May 16, 2010                       kombine(1)
Impressum