nag_multiple_hermitian_to_complex (c06gsc) (PDF version)
c06 Chapter Contents
c06 Chapter Introduction
NAG C Library Manual

NAG Library Function Document

nag_multiple_hermitian_to_complex (c06gsc)

+ Contents

    1  Purpose
    7  Accuracy

1  Purpose

nag_multiple_hermitian_to_complex (c06gsc) takes m  Hermitian sequences, each containing n  data values, and forms the real and imaginary parts of the m  corresponding complex sequences.

2  Specification

#include <nag.h>
#include <nagc06.h>
void  nag_multiple_hermitian_to_complex (Integer m, Integer n, const double x[], double u[], double v[], NagError *fail)

3  Description

This is a utility function for use in conjunction with nag_fft_multiple_real (c06fpc) and nag_fft_multiple_hermitian (c06fqc).

4  References

None.

5  Arguments

1:     mIntegerInput
On entry: the number of Hermitian sequences, m , to be converted into complex form.
Constraint: m1 .
2:     nIntegerInput
On entry: the number of data values, n , in each sequence.
Constraint: n1 .
3:     x[m×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 , , m , then for 0 j n / 2 , x j p  is contained in x[ p-1 × n + j ] , and for 1 j n-1 / 2 , y j p  is contained in x[ p-1 × n + n-j ] .
4:     u[m×n]doubleOutput
5:     v[m×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 j p , for j=0,1,,n - 1, then the mn  elements of the array u contain the values
x 0 1 , x 1 1 , , x n-1 1 , x 0 2 , x 1 2 , , x n-1 2 , , x 0 m , x 1 m , , x n-1 m .
The imaginary parts must be ordered similarly in v.
6:     failNagError *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, m=value.
Constraint: m1.
On entry, n=value.
Constraint: n1.

7  Accuracy

Exact.

8  Further Comments

None.

9  Example

This program reads in sequences of real data values which are assumed to be Hermitian sequences of complex data stored in Hermitian form. The sequences are then expanded into full complex form using nag_multiple_hermitian_to_complex (c06gsc) and printed.

9.1  Program Text

Program Text (c06gsce.c)

9.2  Program Data

Program Data (c06gsce.d)

9.3  Program Results

Program Results (c06gsce.r)


nag_multiple_hermitian_to_complex (c06gsc) (PDF version)
c06 Chapter Contents
c06 Chapter Introduction
NAG C Library Manual

© The Numerical Algorithms Group Ltd, Oxford, UK. 2012