User's Guide

COMPLEX

Combines two images (real & imaginary) to form a complex output image

Function:

COMPLEX combines two images on a pixel-by-pixel basis to form an output complex-valued image. The first input image provides the real component and the second image provides the imaginary component.

Parameters:

IN

Input image. IN(1) is the input image providing the real component for the output image. IN(2) is the input image providing the imaginary component for the output image. Any data type except complex.

OUT

Output image. OUT specifies the name of the output image that will contain the complex image pixel values. The number of bands in OUT is the same as the number of bands in IN(1) and IN(2). Each output band will be interleaved with:

1.  every first pixel equal to IN(1)(x,y) 
2.  every second pixel equal to IN(2)(x,y), where

    IN(1) is the pixel from the first image
    IN(2) is the pixel from the second image.

Data type is complex.

Examples:

1. LAS> complex in=(myimg.in, img.dat) out=out.dat

   This combines the images MYIMG.IN and IMG.DAT, and produces a complex output image, OUT.DAT.

Description/Algorithm:

Two input images of any data type except complex are combined to form an output image that is of complex data type.

The output image is generated as follows:

            OUT(x,y) = u(x,y) + iv(x,y)

where

            u(x,y) = IN(1)(x,y),
            v(x,y) = IN(2)(x,y),

IN(1)(x,y) is the pixel from the first image, IN(2)(x,y) is the pixel from the second image, u(x,y) is the real component of the complex output pixel, and v(x,y) is the imaginary component of the complex output pixel.

Nonfatal Error Messages:

None.

Fatal Error Messages;

1. [Complex-size] Window must be same size for IN(1) and IN(2)

   Respecify IN(1) and IN(2) with identical window sizes.

2. [Complex-bnds] IN(1) and IN(2) must have the same number of bands

   Respecify IN(1) and IN(2) with the same number of bands for each.

User's Note:

1. The complex output image is actually stored as interleaved REAL*4 data.