PaStiX Handbook: PaRSEC extra LL^t factorization

Functions
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...

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...

Detailed Description

Function Documentation

◆ 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]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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] taskpool On 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]	parsec	The parsec context of the application that will run the operation.
[in,out]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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] taskpool On 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]	parsec	The parsec context of the application that will run the operation.
[in,out]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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_data	The pastix_data structure that describes the solver instance.
[in,out]	sopalin_data	Solver 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.

◆ 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]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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] taskpool On 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]	parsec	The parsec context of the application that will run the operation.
[in,out]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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.

Warning: The computations are not done by this call.

Parameters

[in,out]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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] taskpool On 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]	parsec	The parsec context of the application that will run the operation.
[in,out]	A	Descriptor of the sparse matrix A. On exit, A is overwritten with the factorized matrix.
[in,out]	sopalin_data	Solver matrix information structure that will guide the algorithm.

Return values

NULL	if incorrect parameters are given.
The	parsec 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_data	The pastix_data structure that describes the solver instance.
[in,out]	sopalin_data	Solver 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.

Functions

Detailed Description

Function Documentation

◆ parsec_cpxtrf_sp1dplus_New()

◆ parsec_cpxtrf_sp1dplus_Destruct()

◆ parsec_cpxtrf_sp1dplus()

◆ parsec_cpxtrf_sp2d_New()

◆ parsec_cpxtrf_sp2d_Destruct()

◆ parsec_cpxtrf_sp2d()

◆ parsec_cpxtrf()

◆ parsec_zpxtrf_sp1dplus_New()

◆ parsec_zpxtrf_sp1dplus_Destruct()

◆ parsec_zpxtrf_sp1dplus()

◆ parsec_zpxtrf_sp2d_New()

◆ parsec_zpxtrf_sp2d_Destruct()

◆ parsec_zpxtrf_sp2d()

◆ parsec_zpxtrf()