PaStiX Handbook  6.4.0

Functions

parsec_taskpool_t * parsec_zpxtrf_sp1dplus_New (parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Generate the PaRSEC taskpool object for the LL^t factorization with 1D kernels. More...
 
void parsec_zpxtrf_sp1dplus_Destruct (parsec_taskpool_t *taskpool)
 Free the data structure associated to a taskpool created with parsec_zpxtrf_sp1dplus_New(). More...
 
int parsec_zpxtrf_sp1dplus (parsec_context_t *parsec, parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization with 1D kernels. More...
 
parsec_taskpool_t * parsec_zpxtrf_sp2d_New (parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Generate the PaRSEC taskpoolr object for the LL^t factorization with 1D and 2D kernels. More...
 
void parsec_zpxtrf_sp2d_Destruct (parsec_taskpool_t *taskpool)
 Free the data structure associated to a taskpool created with parsec_zpxtrf_sp2d_New(). More...
 
int parsec_zpxtrf_sp2d (parsec_context_t *parsec, parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization with 1D and 2D kernels. More...
 
void parsec_zpxtrf (pastix_data_t *pastix_data, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization using PaRSEC runtime. More...
 
parsec_taskpool_t * parsec_cpxtrf_sp1dplus_New (parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Generate the PaRSEC taskpool object for the LL^t factorization with 1D kernels. More...
 
void parsec_cpxtrf_sp1dplus_Destruct (parsec_taskpool_t *taskpool)
 Free the data structure associated to a taskpool created with parsec_cpxtrf_sp1dplus_New(). More...
 
int parsec_cpxtrf_sp1dplus (parsec_context_t *parsec, parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization with 1D kernels. More...
 
parsec_taskpool_t * parsec_cpxtrf_sp2d_New (parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Generate the PaRSEC taskpoolr object for the LL^t factorization with 1D and 2D kernels. More...
 
void parsec_cpxtrf_sp2d_Destruct (parsec_taskpool_t *taskpool)
 Free the data structure associated to a taskpool created with parsec_cpxtrf_sp2d_New(). More...
 
int parsec_cpxtrf_sp2d (parsec_context_t *parsec, parsec_sparse_matrix_desc_t *A, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization with 1D and 2D kernels. More...
 
void parsec_cpxtrf (pastix_data_t *pastix_data, sopalin_data_t *sopalin_data)
 Perform a sparse LL^t factorization using PaRSEC runtime. More...
 

Detailed Description

Function Documentation

◆ parsec_zpxtrf_sp1dplus_New()

parsec_taskpool_t* parsec_zpxtrf_sp1dplus_New ( parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Generate the PaRSEC taskpool object for the LL^t factorization with 1D kernels.

The function only return the object that describes the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

In this object, all operations are panel based operation which might result in lower parallelism for large problems.

Warning
The computations are not done by this call.
Parameters
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_zpxtrf_sp1dplus_Destruct().
See also
parsec_zpxtrf_sp1dplus
parsec_zpxtrf_sp1dplus_Destruct
parsec_zpxtrf_sp1dplus
parsec_cpxtrf_sp1dplus_New
parsec_dpxtrf_sp1dplus_New
parsec_spxtrf_sp1dplus_New

Definition at line 78 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp1dplus(), pastix_int_t, and PastixCompressNever.

Referenced by parsec_zpxtrf_sp1dplus().

◆ parsec_zpxtrf_sp1dplus_Destruct()

void parsec_zpxtrf_sp1dplus_Destruct ( parsec_taskpool_t *  taskpool)

Free the data structure associated to a taskpool created with parsec_zpxtrf_sp1dplus_New().

Parameters
[in,out]taskpoolOn entry, the taskpool to destroy. On exit, the taskpool cannot be used anymore.

Definition at line 121 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp1dplus().

Referenced by parsec_zpxtrf_sp1dplus().

◆ parsec_zpxtrf_sp1dplus()

int parsec_zpxtrf_sp1dplus ( parsec_context_t *  parsec,
parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization with 1D kernels.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L \times L^t \]

where L is a sparse lower triangular matrix.

Parameters
[in,out]parsecThe parsec context of the application that will run the operation.
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_zpxtrf_sp1dplus_Destruct().
See also
parsec_zpxtrf_sp1dplus_New
parsec_zpxtrf_sp1dplus_Destruct

Definition at line 171 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp1dplus_Destruct(), and parsec_zpxtrf_sp1dplus_New().

Referenced by parsec_zpxtrf(), parsec_zpxtrf_sp1dplus_Destruct(), and parsec_zpxtrf_sp1dplus_New().

◆ parsec_zpxtrf_sp2d_New()

parsec_taskpool_t* parsec_zpxtrf_sp2d_New ( parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Generate the PaRSEC taskpoolr object for the LL^t factorization with 1D and 2D kernels.

The function only return the object that describes the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L \times L^t \]

where L is a sparse lower triangular matrix.

In this object, operations are panel based operations for the lower levels of the elimination tree, and the higher levels are taskpoold by 2D tasks scheme to create more parallelism and adapt to large architectures.

Warning
The computations are not done by this call.
Parameters
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_zpxtrf_sp2d_Destruct().
See also
parsec_zpxtrf_sp2d
parsec_zpxtrf_sp2d_Destruct
parsec_zpxtrf_sp2d
parsec_cpxtrf_sp2d_New
parsec_dpxtrf_sp2d_New
parsec_spxtrf_sp2d_New

Definition at line 239 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp2d(), pastix_int_t, and PastixCompressNever.

Referenced by parsec_zpxtrf_sp2d().

◆ parsec_zpxtrf_sp2d_Destruct()

void parsec_zpxtrf_sp2d_Destruct ( parsec_taskpool_t *  taskpool)

Free the data structure associated to a taskpool created with parsec_zpxtrf_sp2d_New().

Parameters
[in,out]taskpoolOn entry, the taskpool to destroy. On exit, the taskpool cannot be used anymore.

Definition at line 282 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp2d().

Referenced by parsec_zpxtrf_sp2d().

◆ parsec_zpxtrf_sp2d()

int parsec_zpxtrf_sp2d ( parsec_context_t *  parsec,
parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization with 1D and 2D kernels.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

Parameters
[in,out]parsecThe parsec context of the application that will run the operation.
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_zpxtrf_sp2d_Destruct().
See also
parsec_zpxtrf_sp2d_New
parsec_zpxtrf_sp2d_Destruct

Definition at line 332 of file parsec_zpxtrf.c.

References parsec_zpxtrf_sp2d_Destruct(), and parsec_zpxtrf_sp2d_New().

Referenced by parsec_zpxtrf(), parsec_zpxtrf_sp2d_Destruct(), and parsec_zpxtrf_sp2d_New().

◆ parsec_zpxtrf()

void parsec_zpxtrf ( pastix_data_t pastix_data,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization using PaRSEC runtime.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

The algorithm is automatically chosen between the 1D and 2D version based on the API parameter IPARM_TASKS2D_LEVEL. If IPARM_TASKS2D_LEVEL != 0 the 2D scheme is applied, the 1D otherwise.

Parameters
[in,out]pastix_dataThe pastix_data structure that describes the solver instance.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
See also
parsec_zpxtrf_sp1dplus
parsec_zpxtrf_sp2d

Definition at line 385 of file parsec_zpxtrf.c.

References pastix_data_s::inter_node_procnbr, pastix_data_s::inter_node_procnum, pastix_data_s::iparm, IPARM_TASKS2D_LEVEL, pastix_data_s::parsec, parsec_sparse_matrix_init(), parsec_zpxtrf_sp1dplus(), parsec_zpxtrf_sp2d(), pastix_parsec_init(), PastixSymmetric, and parsec_sparse_matrix_desc_s::solvmtx.

◆ parsec_cpxtrf_sp1dplus_New()

parsec_taskpool_t* parsec_cpxtrf_sp1dplus_New ( parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Generate the PaRSEC taskpool object for the LL^t factorization with 1D kernels.

The function only return the object that describes the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

In this object, all operations are panel based operation which might result in lower parallelism for large problems.

Warning
The computations are not done by this call.
Parameters
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_cpxtrf_sp1dplus_Destruct().
See also
parsec_cpxtrf_sp1dplus
parsec_cpxtrf_sp1dplus_Destruct
parsec_cpxtrf_sp1dplus
parsec_cpxtrf_sp1dplus_New
parsec_dpxtrf_sp1dplus_New
parsec_spxtrf_sp1dplus_New

Definition at line 78 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp1dplus(), pastix_int_t, and PastixCompressNever.

Referenced by parsec_cpxtrf_sp1dplus().

◆ parsec_cpxtrf_sp1dplus_Destruct()

void parsec_cpxtrf_sp1dplus_Destruct ( parsec_taskpool_t *  taskpool)

Free the data structure associated to a taskpool created with parsec_cpxtrf_sp1dplus_New().

Parameters
[in,out]taskpoolOn entry, the taskpool to destroy. On exit, the taskpool cannot be used anymore.

Definition at line 121 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp1dplus().

Referenced by parsec_cpxtrf_sp1dplus().

◆ parsec_cpxtrf_sp1dplus()

int parsec_cpxtrf_sp1dplus ( parsec_context_t *  parsec,
parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization with 1D kernels.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L \times L^t \]

where L is a sparse lower triangular matrix.

Parameters
[in,out]parsecThe parsec context of the application that will run the operation.
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_cpxtrf_sp1dplus_Destruct().
See also
parsec_cpxtrf_sp1dplus_New
parsec_cpxtrf_sp1dplus_Destruct

Definition at line 171 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp1dplus_Destruct(), and parsec_cpxtrf_sp1dplus_New().

Referenced by parsec_cpxtrf(), parsec_cpxtrf_sp1dplus_Destruct(), and parsec_cpxtrf_sp1dplus_New().

◆ parsec_cpxtrf_sp2d_New()

parsec_taskpool_t* parsec_cpxtrf_sp2d_New ( parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Generate the PaRSEC taskpoolr object for the LL^t factorization with 1D and 2D kernels.

The function only return the object that describes the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L \times L^t \]

where L is a sparse lower triangular matrix.

In this object, operations are panel based operations for the lower levels of the elimination tree, and the higher levels are taskpoold by 2D tasks scheme to create more parallelism and adapt to large architectures.

Warning
The computations are not done by this call.
Parameters
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_cpxtrf_sp2d_Destruct().
See also
parsec_cpxtrf_sp2d
parsec_cpxtrf_sp2d_Destruct
parsec_cpxtrf_sp2d
parsec_cpxtrf_sp2d_New
parsec_dpxtrf_sp2d_New
parsec_spxtrf_sp2d_New

Definition at line 239 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp2d(), pastix_int_t, and PastixCompressNever.

Referenced by parsec_cpxtrf_sp2d().

◆ parsec_cpxtrf_sp2d_Destruct()

void parsec_cpxtrf_sp2d_Destruct ( parsec_taskpool_t *  taskpool)

Free the data structure associated to a taskpool created with parsec_cpxtrf_sp2d_New().

Parameters
[in,out]taskpoolOn entry, the taskpool to destroy. On exit, the taskpool cannot be used anymore.

Definition at line 282 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp2d().

Referenced by parsec_cpxtrf_sp2d().

◆ parsec_cpxtrf_sp2d()

int parsec_cpxtrf_sp2d ( parsec_context_t *  parsec,
parsec_sparse_matrix_desc_t A,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization with 1D and 2D kernels.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

Parameters
[in,out]parsecThe parsec context of the application that will run the operation.
[in,out]ADescriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
Return values
NULLif incorrect parameters are given.
Theparsec taskpool describing the operation that can be enqueued in the runtime with parsec_enqueue(). It, then, needs to be destroy with parsec_cpxtrf_sp2d_Destruct().
See also
parsec_cpxtrf_sp2d_New
parsec_cpxtrf_sp2d_Destruct

Definition at line 332 of file parsec_cpxtrf.c.

References parsec_cpxtrf_sp2d_Destruct(), and parsec_cpxtrf_sp2d_New().

Referenced by parsec_cpxtrf(), parsec_cpxtrf_sp2d_Destruct(), and parsec_cpxtrf_sp2d_New().

◆ parsec_cpxtrf()

void parsec_cpxtrf ( pastix_data_t pastix_data,
sopalin_data_t *  sopalin_data 
)

Perform a sparse LL^t factorization using PaRSEC runtime.

The function performs the LL^t factorization of a sparse symmetric complex matrix A. The factorization has the form

\[ A = L\times L^t \]

where L is a sparse lower triangular matrix.

The algorithm is automatically chosen between the 1D and 2D version based on the API parameter IPARM_TASKS2D_LEVEL. If IPARM_TASKS2D_LEVEL != 0 the 2D scheme is applied, the 1D otherwise.

Parameters
[in,out]pastix_dataThe pastix_data structure that describes the solver instance.
[in,out]sopalin_dataSolver matrix information structure that will guide the algorithm.
See also
parsec_cpxtrf_sp1dplus
parsec_cpxtrf_sp2d

Definition at line 385 of file parsec_cpxtrf.c.

References pastix_data_s::inter_node_procnbr, pastix_data_s::inter_node_procnum, pastix_data_s::iparm, IPARM_TASKS2D_LEVEL, pastix_data_s::parsec, parsec_cpxtrf_sp1dplus(), parsec_cpxtrf_sp2d(), parsec_sparse_matrix_init(), pastix_parsec_init(), PastixSymmetric, and parsec_sparse_matrix_desc_s::solvmtx.