imcopy(1)

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).