af -  Attach (read in) a FITS file to an image 

EXAMPLES:

af "fits.out";cp	The file fits.out in the current directory is
			opened, associated with image 1, and a contour
			plot of it is made.

af "oria.13co" im:3	The file oria.13co is opened as image 3.

af "myspectrum" st:     Read in the FITS spectrum myspectrum from 
			disk into stack 1.

c #=10;do 100 {af "/dev/rmt12" st:1;st #;c #=#+1}   
			Read in 100 FITS spectra from tape and store them 
			in the the first 100 stack locations.

DESCRIPTION:

A FITS file is the same as a FITS tape, except that it is on disk and
doesn't have 2880 byte records.  A file on a FITS tape may be read onto
disk with $COMB/bin/rfitstape and a FITS file may be written to tape with
$COMB/bin/wfitstape.  Or, more simply, specify /dev/rmtN as the filename.

af opens the given FITS file and reads its header into a new data
structure associated with the designated image.  If the header is not
acceptable, an error message might be given and the image closed.  For
the present unrecognized header lines are printed on your screen and
ignored. Spectra can only be read into memory, i.e., stacks 1, 2, or 3.

NOTE: 

When reading in CLASS FITS spectra written by the FCRAO program SPA (and 
possibly some other programs), the LSR Velocity of the spectrum (.vlsr) will 
be the velocity of channel 1. This is because SPA sets the FITS keywords 
CRPIX1=1 and VELO equal to the velocity of that channel.  The velocity 
axis of the spectrum will still be correct; but the displayed LSR velocity 
will not match that of the source.  To fix this, use "cc" to change .vlsr 
and .expch (=CRPIX1) to the source values (usually the center channel), e.g., 

-> af "SPA.FITS.spectrum" st:1

-> p .numpt		   ! print number of channels
128

-> p .expch                ! print channel of CRPIX1 
1

-> vlct,.expch 		   ! print velocity of CRPIX1
-10.429101

-> cc vl:9.0 		   ! change VLSR to source velocity (km/s)

-> p .expch
64.5

-> vlct,.expch
9

-> p .vlsr		   ! Voila!
9

This document was last updated on Tue Oct 17 16:24:05 EDT 2000 by Marc W. Pound.