syconv(3)

📦
version 3.12.1 · 9 versions
, in arch rolling

syconv(3) 🦋

okay bestie, welcome to the Library Functions Manual page for syconv. This is the whole cute little family of LAPACK routines that convert to/from L and D from hetrf. ✨

💖 NAME 💖

syconv — syconv: convert to/from L and D from hetrf.

✨ SYNOPSIS ✨

Functions

  • CSYCONV — subroutine csyconv (uplo, way, n, a, lda, ipiv, e, info)
  • DSYCONV — subroutine dsyconv (uplo, way, n, a, lda, ipiv, e, info)
  • SSYCONV — subroutine ssyconv (uplo, way, n, a, lda, ipiv, e, info)
  • ZSYCONV — subroutine zsyconv (uplo, way, n, a, lda, ipiv, e, info)

🌈 Detailed Description 🌈

okay so this page is the whole syconv saga: four LAPACK subroutines doing the convert/revert dance between L/D and TRF. The full function-by-function lore is right below in Function Documentation. 💅

🔥 Function Documentation 🔥

💅 CSYCONV 💅

subroutine csyconv (character uplo, character way, integer n, complex,
    dimension( lda, * ) a, integer lda, integer, dimension( * ) ipiv,
    complex, dimension( * ) e, integer info)

CSYCONV

Purpose

CSYCONV converts A given by TRF into L and D and vice-versa. It gets the Non-diag elements of D (returned in workspace) and applies or reverses the permutation done in TRF. 🫶

Parameters

  • UPLO — CHARACTER*1. Specifies whether the details of the factorization are stored as an upper or lower triangular matrix. = 'U': Upper triangular, form is A = U*D*U**T; = 'L': Lower triangular, form is A = L*D*L**T.
  • WAY — CHARACTER*1. = 'C': Convert; = 'R': Revert.
  • N — INTEGER. The order of the matrix A. N >= 0.
  • A — COMPLEX array, dimension (LDA,N). The block diagonal matrix D and the multipliers used to obtain the factor U or L as computed by CSYTRF.
  • LDA — INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • IPIV — INTEGER array, dimension (N). Details of the interchanges and the block structure of D as determined by CSYTRF.
  • E — COMPLEX array, dimension (N). E stores the supdiagonal/subdiagonal of the symmetric 1-by-1 or 2-by-2 block diagonal matrix D in LDLT.
  • INFO — INTEGER. = 0: successful exit; < 0: if INFO = -i, the i-th argument had an illegal value.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 113 of file csyconv.f.

💅 DSYCONV 💅

subroutine dsyconv (character uplo, character way, integer n, double
    precision, dimension( lda, * ) a, integer lda, integer, dimension( * )
    ipiv, double precision, dimension( * ) e, integer info)

DSYCONV

Purpose

DSYCONV converts A given by TRF into L and D and vice-versa. It gets the Non-diag elements of D (returned in workspace) and applies or reverses the permutation done in TRF. 🫶

Parameters

  • UPLO — CHARACTER*1. Specifies whether the details of the factorization are stored as an upper or lower triangular matrix. = 'U': Upper triangular, form is A = U*D*U**T; = 'L': Lower triangular, form is A = L*D*L**T.
  • WAY — CHARACTER*1. = 'C': Convert; = 'R': Revert.
  • N — INTEGER. The order of the matrix A. N >= 0.
  • A — DOUBLE PRECISION array, dimension (LDA,N). The block diagonal matrix D and the multipliers used to obtain the factor U or L as computed by DSYTRF.
  • LDA — INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • IPIV — INTEGER array, dimension (N). Details of the interchanges and the block structure of D as determined by DSYTRF.
  • E — DOUBLE PRECISION array, dimension (N). E stores the supdiagonal/subdiagonal of the symmetric 1-by-1 or 2-by-2 block diagonal matrix D in LDLT.
  • INFO — INTEGER. = 0: successful exit; < 0: if INFO = -i, the i-th argument had an illegal value.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 113 of file dsyconv.f.

💅 SSYCONV 💅

subroutine ssyconv (character uplo, character way, integer n, real,
    dimension( lda, * ) a, integer lda, integer, dimension( * ) ipiv, real,
    dimension( * ) e, integer info)

SSYCONV

Purpose

SSYCONV converts A given by TRF into L and D and vice-versa. It gets the Non-diag elements of D (returned in workspace) and applies or reverses the permutation done in TRF. 🫶

Parameters

  • UPLO — CHARACTER*1. Specifies whether the details of the factorization are stored as an upper or lower triangular matrix. = 'U': Upper triangular, form is A = U*D*U**T; = 'L': Lower triangular, form is A = L*D*L**T.
  • WAY — CHARACTER*1. = 'C': Convert; = 'R': Revert.
  • N — INTEGER. The order of the matrix A. N >= 0.
  • A — REAL array, dimension (LDA,N). The block diagonal matrix D and the multipliers used to obtain the factor U or L as computed by SSYTRF.
  • LDA — INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • IPIV — INTEGER array, dimension (N). Details of the interchanges and the block structure of D as determined by SSYTRF.
  • E — REAL array, dimension (N). E stores the supdiagonal/subdiagonal of the symmetric 1-by-1 or 2-by-2 block diagonal matrix D in LDLT.
  • INFO — INTEGER. = 0: successful exit; < 0: if INFO = -i, the i-th argument had an illegal value.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 113 of file ssyconv.f.

💅 ZSYCONV 💅

subroutine zsyconv (character uplo, character way, integer n, complex*16,
    dimension( lda, * ) a, integer lda, integer, dimension( * ) ipiv,
    complex*16, dimension( * ) e, integer info)

ZSYCONV

Purpose

ZSYCONV converts A given by ZHETRF into L and D or vice-versa. It gets the nondiagonal elements of D (returned in workspace) and applies or reverses the permutation done in TRF. 🫶

Parameters

  • UPLO — CHARACTER*1. Specifies whether the details of the factorization are stored as an upper or lower triangular matrix. = 'U': Upper triangular, form is A = U*D*U**T; = 'L': Lower triangular, form is A = L*D*L**T.
  • WAY — CHARACTER*1. = 'C': Convert; = 'R': Revert.
  • N — INTEGER. The order of the matrix A. N >= 0.
  • A — COMPLEX*16 array, dimension (LDA,N). The block diagonal matrix D and the multipliers used to obtain the factor U or L as computed by ZSYTRF.
  • LDA — INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • IPIV — INTEGER array, dimension (N). Details of the interchanges and the block structure of D as determined by ZSYTRF.
  • E — COMPLEX*16 array, dimension (N). E stores the supdiagonal/subdiagonal of the symmetric 1-by-1 or 2-by-2 block diagonal matrix D in LDLT.
  • INFO — INTEGER. = 0: successful exit; < 0: if INFO = -i, the i-th argument had an illegal value.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 113 of file zsyconv.f.

👑 Author 👑

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Generated automatically by Doxygen for LAPACK from the source code.

okay that’s the whole syconv(3) experience — source LAPACK, Version 3.12.0, no date in the footer, so consider this your cute sign-off bestie 💖✨

📦 where this page comes from