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.