NAG Library Function Document

nag_zger (f16smc)

void	nag_zger (Nag_OrderType order, Nag_ConjType conj, Integer m, Integer n, Complex alpha, const Complex x[], Integer incx, const Complex y[], Integer incy, Complex beta, Complex a[], Integer pda, NagError *fail)

3 Description

nag_zger (f16smc) performs the rank-1 update operation

A \leftarrow α x y^{T} + β A,

A \leftarrow α x y^{H} + β A,

where

A

is an

m

n

complex matrix,

x

is an

m

element complex vector,

y

is an

n

-element complex vector, and

α

and

β

are complex scalars.

4 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

5 Arguments

1: order – Nag_OrderTypeInput

On entry: the order argument specifies the two-dimensional storage scheme being used, i.e., row-major ordering or column-major ordering. C language defined storage is specified by

order = Nag_RowMajor

. See Section 3.2.1.3 in the Essential Introduction for a more detailed explanation of the use of this argument.

Constraint:

order = Nag_RowMajor

Nag_ColMajor

2: conj – Nag_ConjTypeInput

On entry: the argument conj specifies whether the elements

y_{i}

are used unconjugated or conjugated, as follows:

$conj = Nag_NoConj$: The elements $y_{i}$ are not conjugated.
$conj = Nag_Conj$: The complex conjugate of the elements $y_{i}$ are used.

Constraint:

conj = Nag_NoConj

Nag_Conj

3: m – IntegerInput

On entry:

m

, the number of rows of the matrix

A

Constraint:

m \geq 0

4: n – IntegerInput

On entry:

n

, the number of columns of the matrix

A

Constraint:

n \geq 0

5: alpha – ComplexInput

On entry: the scalar

α

6: x[ $\dim$ ] – const ComplexInput

Note: the dimension, dim, of the array x must be at least

\max (1, 1 + (n - 1) |incx|)

On entry: the vector

x

7: incx – IntegerInput

On entry: the increment in the subscripts of x between successive elements of

x

Constraint:

incx \neq 0

8: y[ $\dim$ ] – const ComplexInput

Note: the dimension, dim, of the array y must be at least

\max (1, 1 + (n - 1) |incy|)

On entry: the vector

y

9: incy – IntegerInput

On entry: the increment in the subscripts of y between successive elements of

y

Constraint:

incy \neq 0

10: beta – ComplexInput

On entry: the scalar

β

11: a[ $\dim$ ] – ComplexInput/Output

Note: the dimension, dim, of the array a must be at least

$\max (1, pda \times n)$ when $order = Nag_ColMajor$ ;
$\max (1, m \times pda)$ when $order = Nag_RowMajor$ .

order = Nag_ColMajor

A_{i j}

is stored in

a [(j - 1) \times pda + i - 1]

order = Nag_RowMajor

A_{i j}

is stored in

a [(i - 1) \times pda + j - 1]

On entry: the

m

n

matrix

A

On exit: the updated matrix

A

12: pda – IntegerInput

On entry: the stride separating row or column elements (depending on the value of order) in the array a.

Constraints:

if $order = Nag_ColMajor$ , $pda \geq \max (1, m)$ ;
if $order = Nag_RowMajor$ , $pda \geq n$ .

13: fail – NagError *Input/Output

The NAG error argument (see Section 3.6 in the Essential Introduction).

6 Error Indicators and Warnings

NE_ALLOC_FAIL: Dynamic memory allocation failed.
NE_BAD_PARAM: On entry, argument $⟨value⟩$ had an illegal value.
NE_INT: On entry, $incx = ⟨value⟩$ .
Constraint: $incx \neq 0$ .
On entry, $incy = ⟨value⟩$ .
Constraint: $incy \neq 0$ .
On entry, $m = ⟨value⟩$ .
Constraint: $m \geq 0$ .
On entry, $n = ⟨value⟩$ .
Constraint: $n \geq 0$ .
NE_INT_2: On entry, $pda = ⟨value⟩$ , $m = ⟨value⟩$ .
Constraint: $pda \geq \max (1, m)$ .
On entry, $pda = ⟨value⟩$ and $n = ⟨value⟩$ .
Constraint: $pda \geq n$ .
NE_INTERNAL_ERROR: An internal error has occurred in this function. Check the function call and any array sizes. If the call is correct then please contact NAG for assistance.

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

Not applicable.

9 Further Comments

None.

10 Example

Perform rank-1 update of complex matrix

A

using vectors

x

and

y

A \leftarrow A - x y^{H},

where

A

is the

3

2

complex matrix given by

A = (\begin{array}{r} 4.0 + 4.0 i & 2.0 + 2.0 i \\ 4.0 + 7.0 i & 4.0 + 3.0 i \\ 11.0 + 3.0 i & 9.0 + 7.0 i \end{array}),

and the vectors

x

and

y

are

x = (\begin{array}{r} 2.0 + 1.0 i \\ 3.0 + 2.0 i \\ 5.0 - 1.0 i \end{array})

and

y = (\begin{array}{r} 2.0 + 1.0 i \\ 1.0 - 2.0 i \end{array}) .

The vector

y

is stored in every second element of array y (

incy = 2

NAG Library Function Documentnag_zger (f16smc)

+− 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

NAG Library Function Document

nag_zger (f16smc)