\(\text{UpperCholesky}\)

You can use the \(\text{UpperCholesky}\) function to perform an upper Cholesky decomposition of a real or complex matrix, creating \(U ^ T \times U\) for real matrices and \(U ^H \times U\) for complex matrices.

You can use the \ucholesky backslash command to insert this function.

The following variants of this function are available:

  • \(\text{real matrix } \text{UpperCholesky} \left ( \text{<boolean matrix>} \right )\)

  • \(\text{real matrix } \text{UpperCholesky} \left ( \text{<integer matrix>} \right )\)

  • \(\text{real matrix } \text{UpperCholesky} \left ( \text{<real matrix>} \right )\)

  • \(\text{complex matrix } \text{UpperCholesky} \left ( \text{<complex matrix>} \right )\)

The \(\text{UpperCholesky}\) function returns the upper triangular matrix. You can use use the transpose or Hermitian operator to calculate the second matrix term.

Note that this function is only defined for symmetric positive-definite matrices (or Hermitian positive-definite matrices). The \(\text{UpperCholesky}\) function will trigger a run-time error or return an empty matrix if the input matrix does not meet this constraint.

The function is implemented internally for real and complex matrices although you can supply boolean and integer matrices which will be converted to real matrices prior to performing the decomposition operation.

Figure 213 shows the basic use of the \(\text{UpperCholesky}\) function.

../_images/upper_cholesky_example.png

Figure 213 Example Use Of The UpperCholesky Function