naginterfaces.library.blas.zhbmv

naginterfaces.library.blas.zhbmv(uplo, k, alpha, a, x, beta, y=None)

zhbmv computes the matrix-vector product for a complex Hermitian band matrix.

For full information please refer to the NAG Library document for f06sd

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/f06/f06sdf.html

Parameters

uplostr, length 1

Specifies whether the upper or lower triangular part of $A$ is stored.

$uplo=\text{'U'}$

The upper triangular part of $A$ is stored.

$uplo=\text{'L'}$

The lower triangular part of $A$ is stored.

kint

$k$, the number of subdiagonals or superdiagonals of the matrix $A$.

alphacomplex

The scalar $\alpha$.

acomplex, array-like, shape $(k+1,n)$

The $n\times n$ Hermitian band matrix $A$.

xcomplex, array-like, shape $\left(n\right)$

The $n$-element vector $x$.

betacomplex

The scalar $\beta$.

yNone or complex, array-like, shape $\left(n\right)$, optional

The $n$-element vector $y$, if $beta=0.0$, $y$ need not be set.

Returns

ycomplex, ndarray, shape $\left(n\right)$

The updated vector $y$.

Raises

NagValueError

(errno $1$)

On entry, error in parameter $uplo$.

Constraint: $uplo=\text{'U'}$ or $\text{'L'}$.

(errno $2$)

On entry, error in parameter $\text{n}$.

Constraint: $n\ge 0$.

(errno $3$)

On entry, error in parameter $k$.

Constraint: $k\ge 0$.

(errno $8$)

On entry, error in parameter $\text{incx}$.

Constraint: $\text{incx}\ne 0$.

(errno $11$)

On entry, error in parameter $\text{incy}$.

Constraint: $\text{incy}\ne 0$.

Notes

In the NAG Library the traditional C interface for this routine uses a different algorithmic base. Please contact NAG if you have any questions about compatibility.

zhbmv performs the matrix-vector operation

$$y\leftarrow \alpha Ax+\beta y\text{,}$$

where $A$ is an $n\times n$ complex Hermitian band matrix with $k$ subdiagonals and $k$ superdiagonals, $x$ and $y$ are $n$-element complex vectors, and $\alpha$ and $\beta$ are complex scalars.