NAG Library Manual, Mark 29.2
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16el:
FL
CL
CPP
AD
PY
MB
NAG CL Interface
f16elc (dsum)
Keyword Search:
NAG Library Manual, Mark 29.2
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16el:
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. 2023
Settings help
CL Name Style:
Short (
a00aac
)
Long (
impl_details
)
Full (
nag_info_impl_details
)
1
Purpose
f16elc
sums the elements of a real vector.
2
Specification
copy
#include <nag.h>
double
f16elc
(
Integer
n
,
const double
x
[],
Integer
incx
,
NagError *
fail
)
The function may be called by the names:
f16elc
,
nag_blast_dsum
or
nag_dsum
.
3
Description
f16elc
returns the sum
x
1
+
x
2
+
⋯
+
x
n
of the elements of an
n
-element real vector
x
.
If
n
=
0
on entry,
f16elc
returns the value
0
.
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 double
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.
f16elc
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
,
11.5
,
-
2.7
,
9.2
)
T
.
10.1
Program Text
Program Text (f16elce.c)
10.2
Program Data
Program Data (f16elce.d)
10.3
Program Results
Program Results (f16elce.r)
NAG Library Manual, Mark 29.2
Interfaces:
FL
CL
CPP
AD
PY
MB
NAG CL Interface Introduction
F16 (Blast) Chapter Contents
F16 (Blast) Chapter Introduction
f16el:
FL
CL
CPP
AD
PY
MB
© The Numerical Algorithms Group Ltd. 2023