DATAMANIP commands


PROGRAM NAME

kcmplx - Single Operand Complex Arithmetic

DESCRIPTION

kcmplx performs complex to complex conversions on each complex point in the input data object, Input. The operation is specified by one of three flags, -conj for conjugation, -r2p for rectangular to polar conversion and -p2r for polar to rectangular conversion. The data type of of the output data object, Output, will be the same as the data type of Input.

Map Data If the input object contains a map, then the operation is performed on the map data. If the input object does not have a map but has value data, then the operation is performed on the value data.

Validity Mask If there is a validity mask associated with the input object, the mask is transferred to the output object. To decrease processing time, the operation will still be performed on those data that have corresponding mask values equal to zero. If the data under the mask is genuinely fInotfP processable, such as NaN or infinity, the user can specify that a value be substituted in place of the original value when it is accessed. The masked data substitution attributes for a data object can be explicitly set and stored using the fISet AttributefP operator, DATAMANIP::ksetdattr.

Location and Time Data If the input object has time data or location data, it is transferred to the output object.

REQUIRED ARGUMENTS

-i
type: infile
desc: input data object
-o
type: outfile
desc: resulting output data object

Mutually Exclusive Group; you must specify ONE of:

-conj
type: flag
desc: Complex Conjugate
OR
-p2r
type: flag
desc: Convert Polar Coordinates to Rectangular Coordinates
OR
-r2p
type: flag
desc: Convert Rectangular Coordinates to Polar Coordinates

OPTIONAL ARGUMENTS

none

EXAMPLES

SEE ALSO

DATAMANIP::kconj, DATAMANIP::kpol2rect, DATAMANIP::krect2pol, MATRIX::mconj

RESTRICTIONS

The input object data type must be COMPLEX or DOUBLE COMPLEX.

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.