IRAF help page for package images, program blkrep

from NOAO blkrep -- block replicate n-dimensional imagesUSAGE PARAMETERSDESCRIPTIONTIMINGSEXAMPLESSEE ALSO

blkrep -- block replicate n-dimensional images


USAGE

blkrep input output b1 [b2 b3 b4 b5 b6 b7]

PARAMETERS

PARAMETERS

input

List of images to be block replicated. 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 replicated image replaces the input image.

b1, b2, b3, b4, b5, b6, b7

Block replication factor for dimensions 1 - 7. Only the block factors for the dimensions of the input image are required. Dimension 1 is the column or x axis, dimension 2 is the line or y axis.


DESCRIPTION

The list of input images are block replicated by the specified factors 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. Only the block factors for the dimensions of the input images are used.

This task is a complement to blkavg which block averages or sums images. Another related task is magnify which interpolates images to arbitrary sizes. This task, however, is only applicable to two dimensional images with at least two pixels in each dimension. Finally, in conjunction with imstack a lower dimensional image can be replicated to higher dimensions.


TIMINGS

VAX 11/750 with FPA running UNIX 4.3BSD and IRAF V2.4:

       SIZE DATATYPE REPLICATION     CPU  CLOCK
        100    short           5    0.5s     1s
        100     real           5    0.5s     1s
    100x100    short         5x5    1.7s     5s
    100x100     real         5x5    2.1s     6s
  100x100x1     real       5x5x5    9.7s    33s

EXAMPLES

EXAMPLES

4 1.

To block replicate a 1D image in blocks of 3:

cl> blkrep imagein imageout 3

4 2.

To block replicate a 2D image in blocks of 2 by 3:

cl> blkrep imagein imageout 2 3

4 3.

To block replicate two 2D images in blocks of 5 by 5:

cl> blkrep image1,image2 out1,out2 5 5

4 4.

To block replicate a 3D image in place by factors of 2:

cl> blkrep image1 image1 2 2 2

4 5.

To smooth an image by block averaging and expanding by a factor of 2:

cl> blkavg imagein imageout 2 2
cl> blkrep imageout imageout 2 2
.le

4 6.

To take a 1D image and create a 2D image in which each line is the same:

cl> imstack image1d image2d
cl> blkrep image2d image2d 1 100
.le

4 7.

To take a 1D image and create a 2D image in which each column is the same:

cl> imstack image1d image2d
cl> imtranspose image2d image2d
cl> blkrep image2d image2d 100 1
.le


SEE ALSO

blkavg, imstack, magnify,


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