nag_dsbmv (f16pdc) performs the matrix-vector operation
where is an by real symmetric band matrix with subdiagonals and superdiagonals, and are -element real vectors, and and are real 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:
– 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 . See Section 3.3.1.3 in How to Use the NAG Library and its Documentation for a more detailed explanation of the use of this argument.
Constraint:
or .
2:
– Nag_UploTypeInput
On entry: specifies whether the upper or lower triangular part of is stored.
The upper triangular part of is stored.
The lower triangular part of is stored.
Constraint:
or .
3:
– IntegerInput
On entry: , the order of the matrix .
Constraint:
.
4:
– IntegerInput
On entry: , the number of subdiagonals or superdiagonals of the matrix .
Constraint:
.
5:
– doubleInput
On entry: the scalar .
6:
– const doubleInput
Note: the dimension, dim, of the array ab
must be at least
.
On entry: the by symmetric band matrix .
This is stored as a notional two-dimensional array with row elements or column elements stored contiguously. The storage of elements of , depends on the order and uplo arguments as follows:
if and ,
is stored in , for and ;
if and ,
is stored in , for and ;
if and ,
is stored in , for and ;
if and ,
is stored in , for and .
7:
– IntegerInput
On entry: the stride separating row or column elements (depending on the value of order) of the matrix in the array
ab.
Constraint:
.
8:
– const doubleInput
Note: the dimension, dim, of the array x
must be at least
.
On entry: the -element vector .
If ,
must be stored in , for .
If ,
must be stored in , for .
Intermediate elements of x are not referenced. If , x is not referenced and may be NULL.
9:
– IntegerInput
On entry: the increment in the subscripts of x between successive elements of .
Constraint:
.
10:
– doubleInput
On entry: the scalar .
11:
– doubleInput/Output
Note: the dimension, dim, of the array y
must be at least
.
On entry: the vector . See x for details of storage.
On entry: the increment in the subscripts of y between successive elements of .
Constraint:
.
13:
– 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_ALLOC_FAIL
Dynamic memory allocation failed.
See Section 2.3.1.2 in How to Use the NAG Library and its Documentation for further information.
NE_BAD_PARAM
On entry, argument had an illegal value.
NE_INT
On entry, .
Constraint: .
On entry, .
Constraint: .
On entry, .
Constraint: .
On entry, .
Constraint: .
NE_INT_2
On entry, , .
Constraint: .
NE_NO_LICENCE
Your licence key may have expired or may not have been installed correctly.
See Section 2.7.5 in How to Use the NAG Library and its Documentation for further information.