NAG Library Manual, Mark 30
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16gl:
FL
CL
CPP
AD
PY
MB
NAG CL Interface
f16glc (zsum)
Keyword Search:
NAG Library Manual, Mark 30
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16gl:
FL
CL
CPP
AD
PY
MB
▸
▿
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
© The Numerical Algorithms Group Ltd. 2024
Settings help
CL Name Style:
Short (
a00aac
)
Long (
impl_details
)
Full (
nag_info_impl_details
)
1
Purpose
f16glc
sums the elements of a complex vector.
2
Specification
copy
#include <nag.h>
Complex
f16glc
(
Integer
n
,
const Complex
x
[],
Integer
incx
,
NagError *
fail
)
The function may be called by the names:
f16glc
,
nag_blast_zsum
or
nag_zsum
.
3
Description
f16glc
returns the sum
x
1
+
x
2
+
⋯
+
x
n
of the elements of an
n
-element complex vector
x
.
If
n
=
0
on entry,
f16glc
returns the value
0
+
0
i
.
4
References
Basic Linear Algebra Subprograms Technical (BLAST) Forum (2001)
Basic Linear Algebra Subprograms Technical (BLAST) Forum Standard
University of Tennessee, Knoxville, Tennessee
https://www.netlib.org/blas/blast-forum/blas-report.pdf
5
Arguments
1:
n
–
Integer
Input
On entry
:
n
, the number of elements in
x
.
Constraint
:
n
≥
0
.
2:
x
[
dim
]
–
const Complex
Input
Note:
the dimension,
dim
, of the array
x
must be at least
max
(
1
,
1
+
(
n
-
1
)
×
|
incx
|
)
.
On entry
: the
n
-element vector
x
.
If
incx
>
0
,
x
i
must be stored in
x
[
(
i
-
1
)
×
incx
]
, for
i
=
1
,
2
,
…
,
n
.
If
incx
<
0
,
x
i
must be stored in
x
[
(
n
-
i
)
×
|
incx
|
]
, for
i
=
1
,
2
,
…
,
n
.
Intermediate elements of
x
are not referenced. If
n
=
0
,
x
is not referenced and may be
NULL
.
3:
incx
–
Integer
Input
On entry
: the increment in the subscripts of
x
between successive elements of
x
.
Constraint
:
incx
≠
0
.
4:
fail
–
NagError *
Input/Output
The NAG error argument (see
Section 7
in the Introduction to the NAG Library CL Interface).
6
Error Indicators and Warnings
NE_ALLOC_FAIL
Dynamic memory allocation failed.
See
Section 3.1.2
in the Introduction to the NAG Library CL Interface for further information.
NE_BAD_PARAM
On entry, argument
⟨
value
⟩
had an illegal value.
NE_INT
On entry,
incx
=
⟨
value
⟩
.
Constraint:
incx
≠
0
.
On entry,
n
=
⟨
value
⟩
.
Constraint:
n
≥
0
.
NE_NO_LICENCE
Your licence key may have expired or may not have been installed correctly.
See
Section 8
in the Introduction to the NAG Library CL Interface for further information.
7
Accuracy
The BLAS standard requires accurate implementations which avoid unnecessary over/underflow (see Section 2.7 of
Basic Linear Algebra Subprograms Technical (BLAST) Forum (2001)
).
8
Parallelism and Performance
Background information to multithreading can be found in the
Multithreading
documentation.
f16glc
is not threaded in any implementation.
9
Further Comments
None.
10
Example
This example computes the sum of the elements of
x
=
(
1.1
+
10.2
i
,
11.5
-
2.7
i
,
9.2
)
T
.
10.1
Program Text
Program Text (f16glce.c)
10.2
Program Data
Program Data (f16glce.d)
10.3
Program Results
Program Results (f16glce.r)
NAG Library Manual, Mark 30
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16gl:
FL
CL
CPP
AD
PY
MB
© The Numerical Algorithms Group Ltd. 2024