NAME

       imcopy -  copies FITS images.

SYNOPSIS

       imcopy inputImage outputImage[compress]

DESCRIPTION

       Copy an input image to an output image, optionally compressing or uncompressing the image in the process.
       If  the  [compress] qualifier is appended to the output file name then the input image will be compressed
       using the tile-compressed format.  In this format, the image is divided into rectangular tiles  and  each
       tile  of  pixels  is compressed and stored in a variable-length row of a binary table.  If the [compress]
       qualifier is omitted, and the input image is in tile-compressed format, then the  output  image  will  be
       uncompressed.

       If an extension name or number is appended to the input file name, enclosed in square brackets, then only
       that  single  extension  will be copied to the output file.  Otherwise, every extension in the input file
       will be processed in turn and copied to the output file.

       The full syntax of the compression qualifier is:

              [compress ALGORITHM TDIM1,TDIM2,...; NOISE_BITS]

       where the allowed ALGORITHM values are Rice, GZIP, PLIO, and TDIMn is the size of the compression tile in
       each dimension, and NOISE_BITS = 1, 2, 3, or  4  and  controls  the  amount  of  noise  suppression  when
       compressing floating point images.

       Note  that  it  may be necessary to enclose the file names in single quote characters on the Unix command
       line.

EXAMPLES

       1)  imcopy image.fit 'cimage.fit[compress]'

              This compresses the input image using the default parameters, i.e.,  using  the  Rice  compression
              algorithm and using row by row tiles.

       2)  imcopy cimage.fit image2.fit

              This  uncompress  the  image  created  in  the  first  example.  image2.fit should be identical to
              image.fit if the image has an integer datatype.  There will be  small  differences  in  the  pixel
              values if it is a floating point image.

       3)  imcopy image.fit 'cimage.fit[compress GZIP 100,100;4]'

              This compresses the input image using the following parameters:

              GZIP  compression  algorithm;  100  X  100 pixel compression tiles; noise_bits = 4 (only used with
              floating point images)

SEE ALSO

       fitscopy(1).

CFITSIO version 3.370                              April 2014                                          imcopy(1)