FLPHT -- IPAC ISO First Look Tool
ASCII conversion of FITS Binary
Files of ISOPHT Auto Analysis Result (AAR) product.
flpht [-tv] [-i image_file] -o table_file AAR_file
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
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
- 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).
- Selects the terse mode that dumps only some basic headers and
fields into the specified ASCII output file. Same as the default mode.
- 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.
- Required option. Directs the output to the disk file whose name is
- 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.
- 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
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:
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.
Suggestions and bug reports are highly appreciated and welcomed at
firstname.lastname@example.org (Nanyao LU) or email@example.com (Jing LI).
See ISOPHOT Data Users Manual (R. Laureijs/ISO SOC) for details on the
Last Change: Oct 30, 1996