NAG Library Function Document

nag_multiple_hermitian_to_complex (c06gsc)

1  Purpose

2  Specification

3  Description

4  References

5  Arguments

1:     m – IntegerInput

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

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

2:     n – IntegerInput

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

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

3:     x[$\mathbf{m}\times \mathbf{n}$] – 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:     u[$\mathbf{m}\times \mathbf{n}$] – doubleOutput

5:     v[$\mathbf{m}\times \mathbf{n}$] – 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:     fail – NagError *Input/Output

The NAG error argument (see Section 3.6 in the Essential Introduction).

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)