FIMG2TAB (Mar99)              ftools.fimage             FIMG2TAB (Mar99)



NAME
    fimg2tab --  Copies the image pixel  values  into  a  (binary/ascii)
                      table extension.
    
    
USAGE
        fimg2tab   fitsfile outfile cols rows (flipx=no) (flipy=no) 
            (swapxy=no) (rootname=Col_) (coordcol=no) (tabletype=binary) 
            (out_format=-)
    
    
DESCRIPTION
    Copies  the  image  pixel  values  from  the  input FITS file into a
    (binary/ascii) Table extension of the output FITS  file.  The  image
    pixel  values  to  read  are  specified  by the range of columns and
    rows. Only 1- and 2-dimensional images are currently supported.  The
    maximum number of input columns should not exceed 999.
    
    
PARAMETERS
    
    fitsfile [string]
        The   name,  including  extension  and   extension   number   in 
        square brackets (e.g.,  a.fits[2] or a.fits+2),  of   the   FITS
        image  to  be accessed.
    
    outfile [string]
        The  name  (e.g.,   b.fits)   of   the  FITS file into which the
        output table should be created.
    
    cols [string] 
        The range of the  columns  in  the  FITS  image  to  read,  e.g.
        '1-100'.
    
    rows [string] 
        The range of the rows in the FITS image to read, e.g. '55-120'.
    
    (flipx=no) [boolean]
        The option (yes/no) to reverse the order of columns.
    
    (flipy=no) [boolean]
        The option (yes/no) to reverse the order of rows.
    
    (swapxy=no) [boolean]
        The option (yes/no) to make columns by rows and rows by columns.
    
    (rootname="Col_") [string]
        The base name of the columns, e.g. 'Col_'.
    
    (coordcol=no) [boolean] 
        The  option  (yes/no)  to  include an additional column with the
        (astronomical) coordinates.
    
    (tabletype="BINARY") [string] 
        The type (binary/ascii) of an output table extension.
    
    (out_format="-") [string]
        The data format of an output Table.
    
    
EXAMPLE
    Read the columns 1-10 and rows  1-100  from  the  FITS  image   file
    a.fits+2  and  put the extracted fragment of the image to the binary
    table extension in FITS file b.fits.
    
        fi> fimg2tab a.fits+2 b.fits 1-10 1-100
    
    
BUGS