FLPHT -- IPAC ISO First Look Tool

Version 5.0

First look ASCII conversion of FITS Binary Files of ISOPHT Auto Analysis Result (AAR) product.

Usage :

flpht [-tv] [-i image_file] -o table_file AAR_file

Description:

FLPHT converts the FITS binary table format of an AAR file into a plain ASCII table for the purpose of first-look at the contents. The default output mode is to output the selected header and field parameters, but one can select the verbose (-v) option to dump all the header and fields to the output ASCII file.

In the above command line, "AAR_file" is the name of the AAR file to read. The full path name has to be given if the file is not in the current directory.

The output is directed into a disk file using "-o table_file" argument, where "table_file" is the name of the disk file for the output.

For a spectroscopic AAR product (i.e., PSAP, PSAE, PSAS, PLAP, PLAE or PLAS), the user can use the "-i image_file" option to write conventional FITS images (one image per measurement). The names of these FITS images will be "image_fileA.FITS", "image_fileB.FITS", and so on, where the root name "image_file" is specified on the command line. Note that this option has no effect on files other than those listed here.

Be cautious when you use the -o or -i option as the program will overwrite an existing file with the same name.

The following list outlines what contents are written into the output files:

PPAP/PPAE/PPAP ==> ASCII output of headers and fields

PCAP/PCAE/PCAS ==> ASCII output of headers and fields

PGAI/PGAT/PGAU ==> No action as these are conventional FITS images

PSAP/PSAE/PSAS/PLAP/PLAE/PLAS ==> ASCII output of headers and fields, plus optional FITS images (one FITS image per measurement)

For detailed explanation of headers and fields, please refer to the ISOPHOT Data User's Manual (R. Laureijs).

Options:

-t: Selects the terse mode that dumps only some basic headers and fields into the specified ASCII output file. Same as the default mode.
-v: Selects the verbose mode that dumps all the headers and fields into the specified ASCII output file instead of the default mode in which only selected parameters will be written in the output.
-o: Required option. Directs the output to the disk file whose name is "table_file."
-i: Writes FITS images (one per measurement) if the input file is a spectroscopic product (i.e., one of the following files: PSAP, PSAE, PSAS, PLAP, PLAE and PLAS). The image file names will be "image_fileA.FITS", "image_fileB.FITS", and so on.

Examples:

Example 1

Read a PCAP file under directory /home/user/pht_data/ using the verbose mode and put the output in the file pcap.out in the current directory:

flpht -v -o pcap.out /home/user/pht_data/PCAP22702106.FITS

Example 2

Read a 2-row PSAP binary table in the current directory and have the default ASCII table output in file "ascii.tble" and the FITS image output in files "imageA.FITS" and "imageB.FITS":

flpht -o ascii.tble -i image PSAP22702106.FITS

Installation of the package:

The flpht is an ANSI C package. There is a MAKE file with the package. To install the package, type the following in the directory where the source codes are:

make

Notes:

Not yet possible to read PPAS, PSAE, PLAE, PSAS or PLAS with this version as these AAR files have not been accessible to the authors.

Bug reports:

Suggestions and bug reports are highly appreciated and welcomed at lu@ipac.caltech.edu (Nanyao LU) or jing@ipac.caltech.edu (Jing LI).

Reference:

See ISOPHOT Data Users Manual (R. Laureijs/ISO SOC) for details on the AAR products.