Readme file for munipack.

This package contains various source code of the software 
programs to the synthetic aperture photometry of the time series.
The philosophy of the package is the batch data processing on
UNIX like systems (typical run is on background). The package programs
do not use graphics terminal and all I/O operations are done with
standard input and output and any temporary disk files. 
The working format for images is the FITS format, but a ST and Buil's
camera users can convert its images to the FITS format. 
 
Programs describe:

konve ....   convertor, ST-XX image files to the FITS format
picko ....   convertor, Buil's PIC image format to the FITS format

darkbat ... substract dark frame from your images
flatbat ... flat-field correction

muniphot  ... synthetic aperture photometry
munimatch ... matching serie files to the reference image
munilist  ... lists time and magnitude (and other) from files

The instalation contain this programs and files:
README       ... this file
gnu.txt      ... GNU licence
munipack.tex ... paper about munipack


Instalation:

1. Copy file munipack??.zip to the your munipack directory (~/munipack)
   and unzip this file. 

2. Type 'sh install' and wait.
   This command compile and link the programs and create
   directory 'bin' (in current directory).

3. OK.


Simple run:

We suppose, that the ST7 images are in directory  ~/data, files
var01.st8 ... var10.st8. The dark frame is dark.st8 and flat field
frame is flat.st8.

1. Data conversion:
~/data$ ls var??.st8 | konve @ mask=var??.fits > konve.log &
~/data$ konve dark.st8 mask=dark.fits >> konve.log &
~/data$ konve flat.st8 mask=flat.fits >> konve.log &

2. Dark frame substract:
~/data$ ls var??.fits | darkbat @ dark=dark.fits > darkbat.log &

3. Flat field correction:
~/data$ ls var??.fits | flatbat @ flat=flat.fits > flatbat.log &

4. Photometry:
~/data$ cp ~/munipack/muniphot/com.dat
~/data$ cp ~/munipack/muniphot/mphot.opt
~/data$ cp ~/munipack/muniphot/mphoto.opt    (and edit this files) 
~/data$ ls var??.fits | muniphot @ com=com.dat > muniphot.log & 

5. Matching:
~/data$ cp ~/munipack/munimatch/match.opt    (and edit this file)
~$ ls var??.SRT | munimatch @ ref=var01.SRT > munimatch.log 

6. List:
~/data$ ls var??.fits | munilist @ 5 10 > lightcurve.dat

The light curve as the magnitude difference between variable
(line 5) and comparison (line 10) star is list in file lightcurve.dat.

For more info read the munipack.tex file.

