SuperLU 6.0.0

Functions | Variables
sitersol.c File Reference
Example

Example #1 showing how to use ILU to precondition GMRES. More...

`#include <unistd.h>`
`#include "slu_sdefs.h"`
Include dependency graph for sitersol.c:

## Functions
void | spsolve (int n, float x[], float y[])
| Performs sgsisx with original matrix A. More...
void | smatvec_mult (float alpha, float x[], float beta, float y[])
| Performs matrix-vector multipliation sp_sgemv with original matrix A. More...
int | main (int argc, char *argv[])

## Variables
superlu_options_t * | GLOBAL_OPTIONS
float * | GLOBAL_R
float * | GLOBAL_C
int * | GLOBAL_PERM_C
int * | GLOBAL_PERM_R
SuperMatrix * | GLOBAL_A
SuperMatrix * | GLOBAL_L
SuperMatrix * | GLOBAL_U
SuperLUStat_t * | GLOBAL_STAT
mem_usage_t * | GLOBAL_MEM_USAGE

## Detailed Description

This example shows that ILU is computed from the equilibrated matrix, and the preconditioned GMRES is applied to the equilibrated system. The driver routine SGSISX is called twice to perform factorization and apply preconditioner separately.

Note that SGSISX performs the following factorization: Pr*Dr*A*Dc*Pc^T ~= LU with Pr being obtained from MC64 statically then partial pivoting dynamically. On return, A is overwritten as A1 = Dr*A*Dc.

We can solve the transformed system, A1*y = Dr*B, using FGMRES. B is first overwritten as Dr*B. Then GMRES step requires requires 2 procedures: 1) Apply preconditioner M^{-1} = Pc^T*U^{-1}*L^{-1}*Pr 2) Matrix-vector multiplication: w = A1*v

## Function Documentation

## ◆ main()

int main | ( | int | argc,
|  | char * | argv[]
| ) |  |

Here is the call graph for this function:

## ◆ smatvec_mult()

void smatvec_mult | ( | float | alpha,
|  | float | x[],
|  | float | beta,
|  | float | y[]
| ) |  |

The operations is y := alpha*A*x + beta*y. See documentation of sp_sgemv for further details.

Parameters

  [in] | alpha | Scalar factor for A*x
  [in] | x | Vector to multiply with A
  [in] | beta | Scalar factor for y
  [in,out] | y | Vector to add to to matrix-vector multiplication and storage for result.

Here is the call graph for this function:

## ◆ spsolve()

void spsolve | ( | int | n,
|  | float | x[],
|  | float | y[]
| ) |  |

See documentation of sgsisx for more details.

Parameters

  [in] | n | Dimension of matrices
  [out] | x | Solution
  [in,out] | y | Right-hand side

Here is the call graph for this function:

## Variable Documentation

## ◆ GLOBAL_A

SuperMatrix* GLOBAL_A

## ◆ GLOBAL_C

float * GLOBAL_C

## ◆ GLOBAL_L

SuperMatrix * GLOBAL_L

## ◆ GLOBAL_MEM_USAGE

mem_usage_t* GLOBAL_MEM_USAGE

## ◆ GLOBAL_OPTIONS

superlu_options_t* GLOBAL_OPTIONS

## ◆ GLOBAL_PERM_C

int* GLOBAL_PERM_C

## ◆ GLOBAL_PERM_R

int * GLOBAL_PERM_R

## ◆ GLOBAL_R

float* GLOBAL_R

## ◆ GLOBAL_STAT

SuperLUStat_t* GLOBAL_STAT

## ◆ GLOBAL_U

SuperMatrix * GLOBAL_U