nag_multiple_conjugate_hermitian (c06gqc) (PDF version)
c06 Chapter Contents
c06 Chapter Introduction
NAG Library Manual
Keyword Search:
NAG Library Function Document
nag_multiple_conjugate_hermitian (c06gqc)
▸
▿
Contents
1
Purpose
2
Specification
3
Description
4
References
5
Arguments
6
Error Indicators and Warnings
7
Accuracy
8
Parallelism and Performance
9
Further Comments
▸
▿
10
Example
10.1
Program Text
10.2
Program Data
10.3
Program Results
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
–
Integer
Input
On entry
: the number of Hermitian sequences to be conjugated,
m
.
Constraint
:
m
≥
1
.
2:
n
–
Integer
Input
On entry
: the number of data values in each Hermitian sequence,
n
.
Constraint
:
n
≥
1
.
3:
x
[
m
×
n
]
–
double
Input/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
+
i
y
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:
m
≥
1
.
On entry,
n
=
value
.
Constraint:
n
≥
1
.
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)
nag_multiple_conjugate_hermitian (c06gqc) (PDF version)
c06 Chapter Contents
c06 Chapter Introduction
NAG Library Manual
© The Numerical Algorithms Group Ltd, Oxford, UK. 2017