Integer type:  int32  int64  nag_int  show int32  show int32  show int64  show int64  show nag_int  show nag_int

PDF version (NAG web site, 64-bit version, 64-bit version)
Chapter Contents
Chapter Introduction
NAG Toolbox

# NAG Toolbox: nag_blast_zsum (f16gl)

## Purpose

nag_blast_zsum (f16gl) sums the elements of a complex vector.

## Syntax

[result] = f16gl(n, x, incx)
[result] = nag_blast_zsum(n, x, incx)

## Description

nag_blast_zsum (f16gl) returns the sum
 x1 + x2 + ⋯ + xn $x1 + x2 + ⋯ + xn$
of the elements of an n$n$-element complex vector x$x$, via the function name.
If n0${\mathbf{n}}\le 0$ on entry, nag_blast_zsum (f16gl) returns the value 0 + 0i$0+0i$.

## References

Basic Linear Algebra Subprograms Technical (BLAST) Forum (2001) Basic Linear Algebra Subprograms Technical (BLAST) Forum Standard University of Tennessee, Knoxville, Tennessee http://www.netlib.org/blas/blast-forum/blas-report.pdf

## Parameters

### Compulsory Input Parameters

1:     n – int64int32nag_int scalar
n$n$, the number of elements in x$x$.
2:     x(1 + (n1) × |incx|$1+\left({\mathbf{n}}-1\right)×|{\mathbf{incx}}|$) – complex array
The vector x$x$. Element xi${x}_{\mathit{i}}$ is stored in x((i1) × |incx| + 1)${\mathbf{x}}\left(\left(\mathit{i}-1\right)×|{\mathbf{incx}}|+1\right)$, for i = 1,2,,n$\mathit{i}=1,2,\dots ,n$.
3:     incx – int64int32nag_int scalar
The increment in the subscripts of x between successive elements of x$x$.
Constraint: incx0${\mathbf{incx}}\ne 0$.

None.

None.

### Output Parameters

1:     result – complex scalar
The result of the function.

## 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)).

None.

## Example

```function nag_blast_zsum_example
n = int64(3);
x = [ 1.1 + 10.2i;
11.5 - 2.7i;
9.2 + 0i];
incx = int64(1);
[result] = nag_blast_zsum(n, x, incx)
```
```

result =

21.8000 + 7.5000i

```
```function f16gl_example
n = int64(3);
x = [ 1.1 + 10.2i;
11.5 - 2.7i;
9.2 + 0i];
incx = int64(1);
[result] = f16gl(n, x, incx)
```
```

result =

21.8000 + 7.5000i

```

PDF version (NAG web site, 64-bit version, 64-bit version)
Chapter Contents
Chapter Introduction
NAG Toolbox

© The Numerical Algorithms Group Ltd, Oxford, UK. 2009–2013