NAG C Library Function Document

nag_multiple_conjugate_hermitian (c06gqc)

1
Purpose

nag_multiple_conjugate_hermitian (c06gqc) forms the complex conjugates of m  Hermitian sequences, each containing n  data values.

2
Specification

#include <nag.h>
#include <nagc06.h>
void  nag_multiple_conjugate_hermitian (Integer m, Integer n, double x[], 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) to calculate inverse discrete Fourier transforms.

4
References

None.

5
Arguments

1:     m IntegerInput
On entry: the number of Hermitian sequences to be conjugated, m .
Constraint: m1 .
2:     n IntegerInput
On entry: the number of data values in each Hermitian sequence, n .
Constraint: n1 .
3:     x[m×n] doubleInput/Output
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 ] .
On exit: the imaginary parts y j p  are negated. The real parts x j p  are not referenced.
4:     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, m=value.
Constraint: m1.
On entry, n=value.
Constraint: n1.

7
Accuracy

Exact.

8
Parallelism and Performance

nag_multiple_conjugate_hermitian (c06gqc) is not threaded in any implementation.

9
Further Comments

None.

10
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 expanded into full complex form using nag_multiple_hermitian_to_complex (c06gsc) and printed. The sequences are then conjugated (using nag_multiple_conjugate_hermitian (c06gqc)) and the conjugated sequences are expanded into complex form using nag_multiple_hermitian_to_complex (c06gsc) and printed out.

10.1
Program Text

Program Text (c06gqce.c)

10.2
Program Data

Program Data (c06gqce.d)

10.3
Program Results

Program Results (c06gqce.r)