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

NAME

6       timebat - utility for time correction
7

SYNOPSIS

9       timebat [ options ] time-corr input-files ...
10

DESCRIPTION

12       The  timebat command applies time correction to a set of source frames.
13       It means, that it adds given amount of time to the  times  of  observa‐
14       tion.  The  program  does  not  touch  neither the image data nor other
15       parameters in header.
16
17       The source frames must be in the FITS format. The output file is in the
18       FITS format too.
19

INPUT FILES

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

OUTPUT FILES

32       By  default,  output files are stored to the current working directory.
33       Their names are derived from the command name followed by a  sequential
34       number  starting  by  1.  Command options allows a caller to modify the
35       default naming of output files:
36
37       The -o option sets the format string; it may contain a path  where  the
38       files  shall  be  stored to. Special meaning has a sequence of question
39       marks, it is replaced by the ordinal number of a  file     indented  by
40       leading zeros to the same number of decimal places as the number of the
41       question marks.
42
43       By means of the -i option, you  can  modify  the  initial  value  of  a
44       counter.
45
46       On  request,  the  program  can  write a list of output files to a text
47       file, use the -g option to specify a file name.
48

OPTIONS

50       Options are used to provide extra information to customize  the  execu‐
51       tion of a command. They are specified as command arguments.
52
53       Each  option  has  a full form starting with two dashes and an optional
54       short form starting with one dash only. Options are case-sensitive.  It
55       is allowed to merge two or more successive short options together. Some
56       options require a value; in this case a value is taken  from  a  subse‐
57       quent  argument.  When a full form is used, an option and its value can
58       also be separated by an equal sign. When a  short  form  is  used,  its
59       value can immediately follow the option.
60
61       Whenever there is a conflict between a configuration file parameter and
62       an option of the same meaning, the option always take precedence.
63
64       -i, --read-dirfile filepath
65              read list of input files from specified file; see the Files sec‐
66              tion for details.
67
68       -g, --make-dirfile filepath
69              save list of output files to specified file, existing content of
70              the file will be overwritten; see the Files section for details.
71
72       -o, --output-mask mask
73              set output file mask (default=tout????.fts), see the Files  sec‐
74              tion for details.
75
76       -c, --counter value
77              set initial counter value (default=1), see the Files section for
78              details.
79
80       -h, --help
81              print list of command-line parameters
82
83       -q, --quiet
84              quiet mode; suppress all messages
85
86       --version
87              print software version string
88
89       --licence
90              print software licence
91
92       --verbose
93              verbose mode; print debug messages
94

EXAMPLES

96       timebat -oout.fts 43.512 in.fts
97              The command shifts time of observation of CCD  frame  stored  in
98              the file in.fts by 43 seconds and 512 miliseconds to the future.
99              The output is written to file out.fts.
100

EXIT STATUS

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

HOME PAGE

107       http://c-munipack.sourceforge.net/
108

BUG REPORTS

110       David Motl, dmotl@volny.cz
111

COPYING

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

SEE ALSO

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