
vctor(1)                     Khoros                      vctor(1)

PROGRAM
     vctor - Convert COMPLEX data to REAL form

SYNTAX
     vctor

     -i             input image

     -o             resulting output image

     [-t]           Choose type of mapping from COMPLEX to REAL:
                    1 (Real part),
                    2 (Imaginary part),
                    3 (Magnitude),
                    or 4 (Phase)
                       [default = 1]

     [-V]           Gives the version for vctor

     [-U]           Gives the usage for vctor

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vctor performs simple mappings of COMPLEX data to REAL form.
     A COMPLEX image is transformed into a REAL image by one of
     four methods:

     1    Assign the real part of the input to the output data.

     2    Assign the imaginary part of the input to the output
          data.

     3    Assign the magnitude of the input to the output data.

     4    Assign the phase of the input to the output data.

     The output is the same type as the input (regarding single
     or double floats).

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -t     type: integer
            desc: Choose type of mapping from COMPLEX to REAL
            allowed values:
            1 (Real part),
            2 (Imaginary part),
            3 (Magnitude),
            or 4 (Phase)

EXAMPLES
     vctor -i wave.complex.xv -o wave.phase.xv -t 3

     obtains the phase of the complex wavefront

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvctor(3)
     vrtoc(1),vconvert(1)

RESTRICTIONS
     Input images must be of type COMPLEX or DCOMPLEX.

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

Khoros                    Release: 1.0                          1

