vrtoc(1)

PROGRAM
vrtoc - Convert REAL data to COMPLEX form

SYNTAX

vrtoc

-i1 input image

-o  resulting output image

[-i2]
    input image

[-t]
    Choose the type of conversion from real to complex:
    1 (Real to real (imaginary=0 or 2nd image)),
    2 (Real to imaginary (real=0 or 2nd image)),
    3 (Real to magnitude (phase=0 or 2nd image)),
    or 4 (Real to phase (magnitude=1 or 2nd image))
       [default = 1]

[-V]
    Gives the version for vrtoc

[-U]
    Gives the usage for vrtoc

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vrtoc.ans or file1

[-a [file1]]
    Uses vrtoc.ans or file1 as the answer file

DESCRIPTION
vrtoc performs simple conversions of REAL data to COMPLEX form. A non-COMPLEX image is transformed into a COMPLEX image by one of four methods:

1   Move the first input image into the real part of the complex output image. If a second input image is present, then move it into the imaginary part - otherwise leave the imaginary part as zero.

2   Move the first input image into the imaginary part of the complex output image. If a second input image is present, then move it into the real part - otherwise leave the real part as zero.

3   Move the first input image into the magnitude part of the complex output image. If a second input image is present, then move it into the phase part - otherwise leave the phase part as zero.

4   Move the first input image into the phase part of the complex output image. If a second input image is present, then move it into the magnitude part - otherwise leave the magnitude part as one.

REQUIRED ARGUMENTS

-i1 type: infile
    desc: input image

-o  type: outfile
    desc: resulting output image

OPTIONAL ARGUMENTS

-i2 type: infile
    desc: input image

-t  type: integer
    desc: Choose the type of conversion from real to complex
    allowed values:
    1 (Real to real (imaginary=0 or 2nd image)),
    2 (Real to imaginary (real=0 or 2nd image)),
    3 (Real to magnitude (phase=0 or 2nd image)),
    or 4 (Real to phase (magnitude=1 or 2nd image))

EXAMPLES
vrtoc -i feath.xv -o complex.xv -t 3

creates "complex.xv" with constant magnitude but with phase given by "feath.xv"

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvrtoc(3) vctor(1),vconvert(1)

RESTRICTIONS
Input images must not be BIT, COMPLEX, or transform types, and must have no map.

COPYRIGHT
Copyright 1992, University of New Mexico. All rights reserved.