IRAF help page for package images, program blkavg

from NOAO blkavg -- block average or sum n-dimensional imagesUSAGE PARAMETERSDESCRIPTIONTIMINGSEXAMPLES

blkavg -- block average or sum n-dimensional images


USAGE

blkavg input output b1 b2 b3 b4 b5 b6 b7

PARAMETERS

PARAMETERS

input

List of images to be block averaged. Image sections are allowed.

output

List of output image names. If the output image name is the same as the input image name then the block averaged image replaces the input image.

b1

The number of columns to be block averaged (dimension 1, or x).

b2

The number of lines to be block averaged (dimension 2, or y).

b3

The number of bands to be block averaged (dimension 3, or z).

b4

The number of pixels to be block averaged in dimension 4 (... etc. for b5-b7).

option = average

Type of block average. The choices are "average" and "sum".


DESCRIPTION

The list of input images are block averaged or summed to form the output images. The output image names are specified by the output list. The number of output image names must be the same as the number of input images. An output image name may be the same as the corresponding input image in which case the block averaged image replaces the input image. The last column, line, etc. of the output image may be a partial block. The option parameter selects whether to block average or block sum.


TIMINGS

It requires approximately 10 cpu seconds to block average a 512 by 512 short image by a factor of 8 in each direction (Vax 11/750 with fpa).


EXAMPLES

1. To block average a 2-d image in blocks of 2 by 3:

cl> blkavg imagein imageout 2 3

2. To block sum two 2-d images in blocks of 5 by 5:

cl> blkavg image1,image2 out1,out2 5 5 op=sum

3. To block average a 3-d image by 4 in x and y and 2 in z:

cl> blkavg imagein imageout 4 4 2

or

cl> blkavg imagein imageout b1=4 b2=4 b3=2


This page automatically generated from the iraf .hlp file. If you would like your local iraf package .hlp files converted into HTML please contact Dave Mills at NOAO.

dmills@noao.edu