FTABPAR (Jun92)               ftools.futils              FTABPAR (Jun92)



NAME
    ftabpar  --  Copy the value of a FITS table element to the parameter
    file.
    
    
USAGE
    ftabpar fitsfile[ext#] column row
    
    
DESCRIPTION
    This  task  reads  the value of an element in a FITS table extension
    (either  an  ASCII or a binary table)  and writes it as a string  to
    the 'value' parameter in the parameter  file.   If  the  element  is
    undefined then the task parameter 'undef' will be set to "yes".
    
    
PARAMETERS
    
    fitsfile [file name]
        The  name,  including  extension  and extension number in square
        brackets (e.g., myfile.fits[3] ) of the input FITS  file  to  be
        read.  By default the first extension will be read.
    
    column [string] 
        Name of the table column to be read.
    
    row [integer]
        Row number to read.
    
    (element = 1) [string]
        If  the  column  contains  an  array  of  values (i.e., a vector
        column in a binary  table)  then  this  is  the  number  of  the
        element  within  the  vector  to  be  read.  If the column is an
        array, enter all dimensions in the form 10,3.
    
    (value) [string]
        Returned value read from the table.
    
    (undef)  [boolean]
        Is the value read from the table undefined?
    
    
EXAMPLES
    1.  Read the value in the 10th row of the 'WAVELENGTH' column in the
    4th extension in the FITS file myfile.fits.  Then use the IRAF cl to
    print the value.
    
         ft> ftabpar myfile.fits[4] wavelength 10
             ft> x = real(ftabpar.value)
             ft> print(x)
    
    


                                  -1-
FTABPAR (Jun92)               ftools.futils              FTABPAR (Jun92)



BUGS
    
    
SEE ALSO
    fpartab, fkeypar, fparkey, fkeytab, ftabkey