.TH konve 1 

.SH konve
konve \- Converts ST-4X, ST-5, ST-6, ST-7, ST-8, PixCel256 files to the FITS format files.

.SH SYNOPSIS
konve [options] [@dirfile] [par=parfile] [tcor=?] [mask=?] [image1] ...

.SH "DESCRIPTION"
This utility is a very usefull for SBIG CCD camera owners.
It converts a lot of ST images to FITS format non-interactively.

\." All professional image handling packages works on FITS format   

.SS "@dirfile" 
file with name(s) of image(s) to convert, no wildcards *,?
You can use 'ls' command to make it: 'ls *.st8 > dirfile'

.SS @
read image(s) name(s) from standart input

.SS "image1 .. imageN..N"
name(s) of simple image(s) to convert, no wildcards *,?

.SS "par=parname" 
Parameter file. Any line of this file is directly copied to the FITS file 
header. Therefore, you must use FITS format. 

Ordinary record:

 position     description

 1 - 9        keyword (OBJECT,...) 
 10           '=' 
 11 - 30      value (character: 'kjshfksjh', integer: 10000, real: 1.0000E6) 
 30 - 79      '/' + comment ('/ UT..')

Comment and history record:

 "COMMENT" or "HISTORY" followed by any text.

Record length is 80 characters. Do not use ascii characters above 127. 

.SS "tcor=seconds"
Correction of time in seconds. Integer, signed or unsigned number
up to your system specific long int type.

.SS "mask=string"
Output mask (default = kout????.fts)
The '*' has the same meaning as '?'. 

.SH OPTIONS
.SS "-p parname"
dark frame image (equivalent with 'par=')
.SS "-o mask"
output mask (equivalent with 'mask=')
.SS "-c number"
counter initial value (default = 1)
.SS "-flip axis"
flipping around axis x, y or both xy
.SS -h  
create only header of FITS file
.SS -help
 give help
.SS -L
display software license
.SS -g 
 wrote an example of the parameter file to the file 'konve.par' 

.SH "RETURN VALUE"
Zero.

.SH ERRORS
Return codes, either exit status or errno settings.

.SH EXAMPLES
 
  Give help
  
      konve

  Convert file 'image.st8' to 'kout0001.fts'

      konve image.st8
  
  Convert file 'image.st8' to 'image.fts'
  
     konve image.st8 mask=image.st8

  Convert all ST images at current directory to default mask
  
     ls *.st8 | konve @ 
 
 Convert R images of beta Lyr
     ls betalyrR???.st8 | konve @ mask=betalyrR???.fits

 Convert only headers of R images of beta Lyr
    
    ls betalyrR???.st8 | konve -h @ mask=betalyrR???.fits

.SH FILES
.br
.nf
.\" set tabstop to longest possible filename, plus a wee bit
Uses file like 'konve.par' - see description above.

.SH "SEE ALSO"
.\" Always quote multiple words for .SH
 munipack(1)

.SH CAVEATS
You must uses this utility a very CAREFULLY. If output mask (option -o
or mask=?) is equivalent with input image, konve overwrite
the input image and your DATA are LOST. An example is the command
"konve i.st8 -o i.st8" (your are overtyped suffix '.st8' and 'fits').
Try allways set the permissions to read-only for input files before.

.SH DIAGNOSTICS

The error messages like "Can't convert..","Can't open.." usually means, that
you typed wrong filename(s). 

"No input files." - missed '@' at command line. 

"Can't create..", "Can't write.." - disk full?

"Unknown image type." - wrong filename (suffix)?  

.SH BUGS
Unknown.

.SH RESTRICTIONS
Don't insert blanks between key (par=, tcor=,..) and argument.

.SH AUTHOR
F. Hroch, Masaryk University, Brno (hroch@physics.muni.cz) 

P. Pravec, M. Velen developed a part of the code for decoding ST compressed
image type. 

Miroslav Broz (miroslav.broz@usa.net) added two file types for
PixCel255 cameras, Nov 24th 1998 - Christmas format.

