COMPLEX Function

Converts an expression to complex data type.

Extracts data from an expression and places it in a complex scalar or array.

Usage

result = COMPLEX(real [, imaginary])

This form is used to convert data.

result = COMPLEX(expr, offset, [dim₁, dim₂, ... , dim_n ])

This form is used to extract data.

Input Parameters

To convert data:

real Scalar or array to be used as the real part of the complex result.

imaginary (optional) Scalar or array to be used as the imaginary part of the complex result. If not present, the imaginary part of the result is zero.

To extract data:

expr

The expression to be converted, or from which to extract data.

offset The offset, in bytes, from the beginning of expr to where the extraction is to begin.

dim_i (optional) The dimensions of the result. This parameter may be any scalar expression, and up to eight dimensions may be specified.

Returned Value

The result is a complex data type with the size and structure determined by the size and structure of real and imaginary input parameters. If either or both of the parameters are arrays, result will be an array, following the same rules as standard PV-WAVE operators.

The result is a complex data type with the size and structure determined by the size and structure of the dim_i parameters. If no dimensions are specified, the result is scalar.

Keywords

Discussion

COMPLEX is used primarily to convert data to complex data type. If real is of type string and if the string does not contain a valid floating-point value (thereby making it impossible to convert), then PV-WAVE returns 0 and displays a notice. Otherwise, expr is converted to complex data type. The ON_IOERROR procedure can be used to establish a statement to jump to in the case of such errors.

If only one parameter is supplied, the imaginary part of the result is 0; otherwise, it is set by the imaginary parameter. Parameters are first converted to single-precision floating-point.

NOTE: If three or more parameters are supplied, COMPLEX extracts fields of data from expr, rather than performing conversion.

Example

real = INDGEN(5)
b = COMPLEX(real)
INFO, b

B               COMPLEX   = Array(5)

PRINT, b

(      0.00000,      0.00000)
(      1.00000,      0.00000)
(      2.00000,      0.00000)
(      3.00000,      0.00000)
(      4.00000,      0.00000)

img = INTARR(5) + 6
c = COMPLEX(real, img)
INFO, c

C               COMPLEX   = Array(5)

PRINT, c

(      0.00000,      6.00000)
(      1.00000,      6.00000)
(      2.00000,      6.00000)
(      3.00000,      6.00000)
(      4.00000,      6.00000)

d = COMPLEX(real, 7)
INFO, d

D               COMPLEX   = Array(5)

PRINT, d

(      0.00000,      7.00000)
(      1.00000,      7.00000)
(      2.00000,      7.00000)
(      3.00000,      7.00000)
(      4.00000,      7.00000)

e = COMPLEX(7, img)
INFO, e

E               COMPLEX   = Array(5)

PRINT, e

(      7.00000,      6.00000)
(      7.00000,      6.00000)
(      7.00000,      6.00000)
(      7.00000,      6.00000)
(      7.00000,      6.00000)

See Also

For more information on using this function to extract data, see the PV-WAVE Programmer's Guide.

doc@boulder.vni.com

Copyright © 1999, Visual Numerics, Inc. All rights reserved.