naginterfaces.library.blas.zgemv

naginterfaces.library.blas.zgemv(trans, m, alpha, a, x, beta, y=None)

zgemv computes the matrix-vector product for a complex general matrix, its transpose or its conjugate transpose.

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

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/f06/f06saf.html

Parameters

transstr, length 1

Specifies the operation to be performed.

$trans=\text{'N'}$

$y\leftarrow \alpha Ax+\beta y$.

$trans=\text{'T'}$

$y\leftarrow \alpha A^{T}x+\beta y$.

$trans=\text{'C'}$

$y\leftarrow \alpha A^{H}x+\beta y$.

mint

$m$, the number of rows of the matrix $A$.

alphacomplex

The scalar $\alpha$.

acomplex, array-like, shape $(m,n)$

The $m\times n$ matrix $A$.

xcomplex, array-like, shape $(:)$

Note: the required length for this argument is determined as follows: if $trans=\text{'N'}$: $n$; if $trans\text{in}(\text{'T'},\text{'C'})$: $m$; otherwise: $0$.

The vector $x$.

betacomplex

The scalar $\beta$.

yNone or complex, array-like, shape $(:)$, optional

Note: the required length for this argument is determined as follows: if $trans=\text{'N'}$: $m$; if $trans\text{in}(\text{'T'},\text{'C'})$: $n$; otherwise: $0$.

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

Returns

ycomplex, ndarray, shape $(:)$

The updated vector $y$.

Raises

NagValueError

(errno $1$)

On entry, error in parameter $trans$.

Constraint: $trans=\text{'N'}$, $\text{'T'}$ or $\text{'C'}$.

(errno $2$)

On entry, error in parameter $m$.

Constraint: $m\ge 0$.

(errno $3$)

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

Constraint: $n\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.

zgemv performs one of the matrix-vector operations

$$y\leftarrow \alpha Ax+\beta y\text{,}y\leftarrow \alpha A^{T}x+\beta y\text{or}y\leftarrow \alpha A^{H}x+\beta y\text{,}$$

where $A$ is an $m\times n$ complex matrix, $x$ and $y$ are complex vectors, and $\alpha$ and $\beta$ are complex scalars.

If $m=0$ or $n=0$, no operation is performed.