naginterfaces.library.blas.dgemm

naginterfaces.library.blas.dgemm(transa, transb, alpha, a, b, beta, c=None)

dgemm performs one of the matrix-matrix operations

$$\begin{array}{c}\begin{array}{cc}C\leftarrow \alpha AB+\beta C\text{,}& C\leftarrow \alpha A^{T}B+\beta C\text{,}\\ C\leftarrow \alpha A{B}^T+\beta C\text{or}& C\leftarrow \alpha A^T{B}^T+\beta C\text{,}\end{array}\end{array}$$

where $A$, $B$ and $C$ are real matrices, and $\alpha$ and $\beta$ are real scalars; $C$ is always $m\times n$.

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

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

Parameters

transastr, length 1

Specifies whether the operation involves $A$ or $A^T$.

$transa=\text{'N'}$

The operation involves $A$.

$transa=\text{'T'}$ or $\text{'C'}$

The operation involves $A^T$.

transbstr, length 1

Specifies whether the operation involves $B$ or $B^T$.

$transb=\text{'N'}$

The operation involves $B$.

$transb=\text{'T'}$ or $\text{'C'}$

The operation involves $B^T$.

alphafloat

The scalar $\alpha$.

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

Note: the required extent for this argument in dimension 1 is determined as follows: if $transa=\text{'N'}$: $m$; if $transa\text{in}(\text{'T'},\text{'C'})$: $k$; otherwise: $0$.

Note: the required extent for this argument in dimension 2 is determined as follows: if $transa=\text{'N'}$: $k$; if $transa\text{in}(\text{'T'},\text{'C'})$: $m$; otherwise: $0$.

The matrix $A$; $A$ is $m\times k$ if $transa=\text{'N'}$, or $k\times m$ if $transa=\text{'T'}$ or $\text{'C'}$.

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

Note: the required extent for this argument in dimension 1 is determined as follows: if $transb=\text{'N'}$: $k$; if $transb\text{in}(\text{'T'},\text{'C'})$: $n$; otherwise: $0$.

Note: the required extent for this argument in dimension 2 is determined as follows: if $transb=\text{'N'}$: $n$; if $transb\text{in}(\text{'T'},\text{'C'})$: $k$; otherwise: $0$.

The matrix $B$; $B$ is $k\times n$ if $transb=\text{'N'}$, or $n\times k$ if $transb=\text{'T'}$ or $\text{'C'}$.

betafloat

The scalar $\beta$.

cNone or float, array-like, shape $(m,n)$, optional

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

If $beta=0.0$, $c$ need not be set.

Returns

cfloat, ndarray, shape $(m,n)$

The updated matrix $C$.

Raises

NagValueError

(errno $1$)

On entry, error in parameter $transa$.

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

(errno $2$)

On entry, error in parameter $transb$.

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

(errno $3$)

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

Constraint: $m\ge 0$.

(errno $4$)

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

Constraint: $n\ge 0$.

(errno $5$)

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

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