Subject: FTOOLS Version 3.3

From: William Pence <pence at tetra.gsfc.nasa.gov>
Date: Tue, 7 Mar 1995 11:54:44 -0500

FTOOLS Version 3.3

A new version of the FTOOLS package of programs to manipulate FITS
files is now available.  FTOOLS may be built either as a set of
stand-alone executable programs or as a package of tasks under IRAF.
Installers also have the option to build only the "core" set of FTOOLS
that perform generic operations on FITS files, or the entire set of
FTOOLS that includes more specialized tasks for X-ray and Gamma-ray
data analysis.

Information about FTOOLS is available on the WWW at
        http://heasarc.gsfc.nasa.gov/docs/software/ftools/ftools_menu.html

FTOOLS is available via Anonymous FTP from legacy.gsfc.nasa.gov in the
        software/ftools/release/FTools_3.3 directory.

     The source code and and reference data files are located in:
        ftools.v3.3.tar.Z   -  Source Code Distribution for all platforms
        refdata.v3.3.tar.Z  -  Minimal subset of Calibration Database 
                               (not needed for the 'core' FTOOLS)

     The compressed postscript documentation files are located in the
        software/ftools/release/doc directory:

        Develop.v3.3.ps.Z    -  Developer's Guide
        Install.v3.3.ps.Z    -  Installation Guide
        Users.v3.3.ps.Z      -  User's Guide
        TechRef.v3.3.ps.Z    -  Complete User's Guide and help pages

FTOOLS is currently supported on the following platforms (See Installation 
Guide for details):
        unix         ALPHA/OSF, DEC/ULTRIX, SUN/SunOS, SGI/IRIX
        vms          ALPHA/VMS, VAX/VMS

The FTOOLS package has been developed and is supported by programmers
and scientists at the High Energy Astrophysics Science Archive Research
Center (HEASARC).  Any questions or comments regarding FTOOLS should be
directed to ftoolshelp at ascasrv.gsfc.nasa.gov.

------------- List of some of the programs available in FTOOLS -----------------
 
General Purpose FITS Utilities:
 
      fappend - Append a FITS extension onto another FITS file
        fcalc - Calculates values for a column using an arithmetic expression
     fcatdiff - Compares columns of a fits file and reports row differences
      fcreate - Create a FITS table from  ASCII input files
       fcurve - Make a light curve histogram from a column in a table
        fdump - Dump contents of a FITS table to an ASCII file
     fextract - Copy a FITS extension from a file into a new file
     ffilecat - Copies keyword values from a list of FITS file to FITS Table
        fhelp - Display help pages for an FTOOL task
       fhisto - Make a histogram of a column in a table
       findex - Create an index file for a FITS table column
      fkeypar - Copy a FITS header keyword to a parameter
    fkeyprint - Display keyword(s) in FITS header(s)
      fkeytab - Copy a FITS header keyword to a FITS table element
        flcol - List column information in a FITS table extension
        flist - List contents of a FITS table to an ASCII file
      flookup - Filter a FITS file from selection based on a lookup table
     fmemsort - Fast memory sort of a FITS table
       fmerge - Merge rows from several FITS tables into one FITS table
     fmodhead - Modify the header keywords in a FITS file
      fparkey - Copy a parameter value to a FITS header keyword
      fpartab - Copy a parameter value to a FITS table element
        fplot - Plot columns in a FITS file using QDP/PLT package 
      fselect - Create a new table from selected rows of a table
        fsort - Sort a FITS table in place
   fstatistic - Calculate mean, standard deviation, min, and max for a column
      fstruct - List a description of the structure of a FITS file
     ftabcopy - Copy specified columns of a FITS table to a new table
      ftabkey - Copy a FITS table element to a FITS header keyword
      ftabpar - Copy a FITS table element to a parameter value
      fverify - Verify that a FITS file conforms to the FITS Standard

FITS Image Tasks:
 
       fadapt - Convolve a FITS image with an adaptive top hat filter
       farith - Perform arithmetic on 2 FITS images
      fboxcar - Convolve a FITS image with a rectangular boxcar filter
      fcarith - Perform arithmetic on FITS image with a constant
       fgauss - Convolve a FITS image with an elliptical Gaussian function
      fimgbin - Rebin a FITS image using a rectangular bin size
    fimconcat - Take 2 images and place them side by side as single image
      fimgdmp - Dump contents of a FITS image to an ASCII file
      fim2lst - Convert a 2D image to a pixel list (inverse of f2dhisto)
     florentz - Convolve a FITS image with an elliptical Lorentzian function
    fmaskfilt - Filter an event list based on an input mask image
      fmrgmsk - Merge 2 or more spatial masks
        fsaoi - Translate an SAOImage region file to an input file for fselect
     fvec2img - Create an image from a column of vectors
     f2dhisto - Make a 2-D image from 2 columns in a table
 
-------------------------------------------------------------------------------