Usage: imcopy inputImage outputImage[compress] 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. 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 uncompresses 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;q 16]' This compresses the input image using the following parameters: GZIP compression algorithm; 100 X 100 pixel compression tiles; quantization level = 16 (only used with floating point images) The full syntax of the compression qualifier is: [compress ALGORITHM TDIM1,TDIM2,...; q QLEVEL s SCALE] where the allowed ALGORITHM values are: Rice, HCOMPRESS, HSCOMPRESS, GZIP, or PLIO. (HSCOMPRESS is a variant of HCOMPRESS in which a small amount of smoothing is applied to the uncompressed image to help suppress blocky compression artifacts in the image when using large values for the 'scale' parameter). TDIMn is the size of the compression tile in each dimension, QLEVEL specifies the quantization level when converting a floating point image into integers, prior to compressing the image. The default value = 16, which means the image will be quantized into integer levels that are spaced at intervals of sigma/16., where sigma is the estimated noise level in background areas of the image. If QLEVEL is negative, this means use the absolute value for the quantization spacing (e.g. 'q -0.005' means quantize the floating point image such that the scaled integers represent steps of 0.005 in the original image). SCALE is the integer scale factor that only applies to the HCOMPRESS algorithm. The default value SCALE = 0 forces the image to be losslessly compressed; Greater amounts of lossy compression (resulting in smaller compressed files) can be specified with larger SCALE values. Note that it may be necessary to enclose the file names in single quote characters on the Unix command line.

Usage: imcopy inputImage outputImage[compress] 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. 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 uncompresses 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;q 16]' This compresses the input image using the following parameters: GZIP compression algorithm; 100 X 100 pixel compression tiles; quantization level = 16 (only used with floating point images) The full syntax of the compression qualifier is: [compress ALGORITHM TDIM1,TDIM2,...; q QLEVEL s SCALE] where the allowed ALGORITHM values are: Rice, HCOMPRESS, HSCOMPRESS, GZIP, or PLIO. (HSCOMPRESS is a variant of HCOMPRESS in which a small amount of smoothing is applied to the uncompressed image to help suppress blocky compression artifacts in the image when using large values for the 'scale' parameter). TDIMn is the size of the compression tile in each dimension, QLEVEL specifies the quantization level when converting a floating point image into integers, prior to compressing the image. The default value = 16, which means the image will be quantized into integer levels that are spaced at intervals of sigma/16., where sigma is the estimated noise level in background areas of the image. If QLEVEL is negative, this means use the absolute value for the quantization spacing (e.g. 'q -0.005' means quantize the floating point image such that the scaled integers represent steps of 0.005 in the original image). SCALE is the integer scale factor that only applies to the HCOMPRESS algorithm. The default value SCALE = 0 forces the image to be losslessly compressed; Greater amounts of lossy compression (resulting in smaller compressed files) can be specified with larger SCALE values. Note that it may be necessary to enclose the file names in single quote characters on the Unix command line.