konve (1) - Linux Manuals

konve: CCD image conversion

NAME

konve - CCD image conversion

SYNOPSIS

konve [options] source_file ...

DESCRIPTION

The Konve program converts CCD frames from the format used by camera controling software to FITS format. The correction of time of observation or image flipping can be applied also.

The program can be run in several modes, the mode is selected by command-line parameters. Besides the usual conversion mode, it allows printing header informations of source files in short or detailed form. You can convert header only while not copying the image. Additional informations, which shall be written to the output files can be given in parameter file.

Current version of program supports reading SBIG (ST-xx) compressed and uncompressed files and the FITS files also. Note, that you can use FITS to FITS conversion for gathering files from many locations into one directory. It will solve the file name collisions.

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.

The mask parameters allows to set the naming of output files. The mask consists of letters, numbers and other characters allowed in the file name by the operating system. The special meaning has the question mark or the sequence of it. They will be replaced by the ordinal number of the output file, the number is always indented by leading zeros to the same number of decimal places as the number of the question marks. For example, when the mask kout????.fts is given, the output files named kout0001.fts, kout0002.fts, kout0003.fts will be generated.

@dirfile

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

@

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

par=file, -pfile

Optional parameter file. Default is none.

mask=mask, -omark

Mask of output file(s). Default is kout????.fts.

tcor=sec

Time correction in seconds. Default is 0.

flip=xy, -flipxy

Image flipping (values: 'x', 'y', 'xy').

-cx

Initial counter value. Default is 1.

-header

Converts headers only, doesn't convert image data.

-info

Prints short header informations of source files and does not generate output files.

-details

Prints full header informations of source files and does not generate output files.

--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 converts files 'crcas01.st7', 'crcas02.st7' and 'crcas03.st7' and writes the output to files 'kout0001.fts', 'kout0002.fts' and 'kout0003.fts'.

konve crcas01.st7 crcas02.st7 crcas03.st7

EXIT STATUS

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