NAG C Library Function Document

nag_multiple_hermitian_to_complex (c06gsc)

1

Purpose

2

Specification

3

Description

4

References

5

Arguments

1:    $\mathbf{m}$ – IntegerInput

On entry: the number of Hermitian sequences, $m$, to be converted into complex form.

Constraint: $\mathbf{m}\ge 1$.

2:    $\mathbf{n}$ – IntegerInput

On entry: the number of data values, $n$, in each sequence.

Constraint: $\mathbf{n}\ge 1$.

3:    $\mathbf{x}\left[\mathbf{m}\times \mathbf{n}\right]$ – const doubleInput

On entry: the $m$ data sequences must be stored in x consecutively. If the $n$ data values $z_j^p$ are written as $x_j^p+{iy}_j^p$, $p=1,2,\dots ,m$, then for $0\le j\le n/2$, $x_j^p$ is contained in $\mathbf{x}\left[\left(p-1\right)\times n+j\right]$, and for $1\le j\le \left(n-1\right)/2$, $y_j^p$ is contained in $\mathbf{x}\left[\left(p-1\right)\times n+n-j\right]$.

4:    $\mathbf{u}\left[\mathbf{m}\times \mathbf{n}\right]$ – doubleOutput

5:    $\mathbf{v}\left[\mathbf{m}\times \mathbf{n}\right]$ – doubleOutput

On exit: the real and imaginary parts of the $m$ sequences of length $n$ are stored consecutively in u and v respectively. If the real parts of the $p$th sequence are denoted by $x_{\mathit{j}}^p$, for $\mathit{j}=0,1,\dots ,n-1$, then the $mn$ elements of the array u contain the values

$$x_0^1,x_1^1,\dots ,x_{n-1}^1,x_0^2,x_1^2,\dots ,x_{n-1}^2,\dots ,x_0^m,x_1^m,\dots ,x_{n-1}^m\text{.}$$

The imaginary parts must be ordered similarly in v.

6:    $\mathbf{fail}$ – NagError *Input/Output

The NAG error argument (see Section 3.7 in How to Use the NAG Library and its Documentation).

6

Error Indicators and Warnings

NE_INT_ARG_LT

On entry, $\mathbf{m}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{m}\ge 1$.

On entry, $\mathbf{n}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{n}\ge 1$.

7

Accuracy

8

Parallelism and Performance

9

Further Comments

10

Example

10.1

Program Text

Program Text (c06gsce.c)

10.2

Program Data

Program Data (c06gsce.d)

10.3

Program Results

Program Results (c06gsce.r)