HLIBpro
2.7

All Hmatrix arithmetic, with the exception of matrixvector multiplication, is approximativ with respect to a predefined accuracy, e.g., fixed rank or fixed blockwise precision (see Accuracy Control for details).
Matrixvector multiplication in 𝖧𝖫𝖨𝖡𝗉𝗋𝗈 is provided in the form of a vector update:
\[ y := \alpha \cdot M \cdot x + \beta y \]
Here, \( M \) is either \( A \), \( A^T \) or \( A^H \) for a given matrix \( A \). The individual form of \( A \) is specified by a value of type matop_t:
apply_normal/MATOP_NORM
: \( A \), apply_transposed/MATOP_TRANS
: \( A^T \), apply_adjoint/MATOP_ADJ
: \( A^H \).Each matrix classes provides the method mul_vec
for real and cmul_vec
for complex valued factors \( \alpha,\beta \) (see TMatrix), which perform the corresponding operations:
Additionally, the function mul_vec
is available, which also handles the case of a distributed matrix (on distributed memory). To use it, the header file algebra/mul_vec.hh
has to be included.
After including algebra/mat_add.hh
into the corresponding source file, the function add
is available for matrix addition. It implements the matrix update
\[ C := \alpha \cdot A + \beta \cdot C \]
with matrices \( A, C \). Here, \( \alpha \) and \( \beta \) are real valued. For the complex valued case, the corresponding function is called cadd:
A crucial requirement for the matrix addition as well as for all matrix operations, is the compatibility of the corresponding index sets and cluster trees, i.e. if \( A \in K^{I \times J} \) then also \( C \in K^{I \times J} \) must hold and the cluster trees for \( I \) and \( J \) have to be equal for both matrices. Only the block cluster trees may differ, e.g. a different admissibility condition can be used for both matrices.
A special for of matrix addition is implemented in add_identity
(cadd_identity
), in which
\[ A := A + \lambda I \]
is implemented:
Currently, this is only implemented if \( A \) has dense diagonal blocks, e.g. which is th case for standard admissibility. Furthermore, since the operation only affects the diagonal part, it is an exact addition without truncation.
General matrix multiplication is provided by the module mat_mul
, e.g. you have to include algebra/mat_mul.hh
. It is again implemented in the form of a matrix update:
\[ C := \alpha \cdot A \cdot B + \beta \cdot C \]
Both, \( A \) and \( B \) may furthermore be transposed or conjugate transposed during multiplication, e.g. \( A \) may be replaced by \( A^T \) or \( A^H \) and analogously for \( B \).
The actual multiplication is implemented in the functions multiply
(for real valued \( \alpha,\beta \)) and cmultiply
(for complex valued \( \alpha,\beta \)).
Since matrix multiplication is computationally expensive, a progress meter may be provided to show the current state of the operation:
As for the matrix addition, the index sets and cluster trees of the involved matrices have to be compatible, otherwise an exception is thrown during multiplication.