Jump to content

LU decomposition

From Wikipedia, the free encyclopedia
(Redirected from LDU decomposition)

In numerical analysis and linear algebra, lower–upper (LU) decomposition or factorization factors a matrix as the product of a lower triangular matrix and an upper triangular matrix (see matrix decomposition). The product sometimes includes a permutation matrix as well. LU decomposition can be viewed as the matrix form of Gaussian elimination. Computers usually solve square systems of linear equations using LU decomposition, and it is also a key step when inverting a matrix or computing the determinant of a matrix. The LU decomposition was introduced by the Polish astronomer Tadeusz Banachiewicz in 1938.[1] To quote: "It appears that Gauss and Doolittle applied the method [of elimination] only to symmetric equations. More recent authors, for example, Aitken, Banachiewicz, Dwyer, and Crout … have emphasized the use of the method, or variations of it, in connection with non-symmetric problems … Banachiewicz … saw the point … that the basic problem is really one of matrix factorization, or “decomposition” as he called it."[2] It is also sometimes referred to as LR decomposition (factors into left and right triangular matrices).

Definitions

[edit]
LDU decomposition of a Walsh matrix

Let A be a square matrix. An LU factorization refers to the factorization of A, with proper row and/or column orderings or permutations, into two factors – a lower triangular matrix L and an upper triangular matrix U:

In the lower triangular matrix all elements above the diagonal are zero, in the upper triangular matrix, all the elements below the diagonal are zero. For example, for a 3 × 3 matrix A, its LU decomposition looks like this:

Without a proper ordering or permutations in the matrix, the factorization may fail to materialize. For example, it is easy to verify (by expanding the matrix multiplication) that . If , then at least one of and has to be zero, which implies that either L or U is singular. This is impossible if A is nonsingular (invertible). This is a procedural problem. It can be removed by simply reordering the rows of A so that the first element of the permuted matrix is nonzero. The same problem in subsequent factorization steps can be removed the same way; see the basic procedure below.

LU factorization with partial pivoting

[edit]

It turns out that a proper permutation in rows (or columns) is sufficient for LU factorization. LU factorization with partial pivoting (LUP) refers often to LU factorization with row permutations only:

where L and U are again lower and upper triangular matrices, and P is a permutation matrix, which, when left-multiplied to A, reorders the rows of A. It turns out that all square matrices can be factorized in this form,[3] and the factorization is numerically stable in practice.[4] This makes LUP decomposition a useful technique in practice.

LU factorization with full pivoting

[edit]

An LU factorization with full pivoting involves both row and column permutations:

where L, U and P are defined as before, and Q is a permutation matrix that reorders the columns of A.[5]

Lower-diagonal-upper (LDU) decomposition

[edit]

A Lower-diagonal-upper (LDU) decomposition is a decomposition of the form

where D is a diagonal matrix, and L and U are unitriangular matrices, meaning that all the entries on the diagonals of L and U are one.

Rectangular matrices

[edit]

Above we required that A be a square matrix, but these decompositions can all be generalized to rectangular matrices as well.[6] In that case, L and D are square matrices both of which have the same number of rows as A, and U has exactly the same dimensions as A. Upper triangular should be interpreted as having only zero entries below the main diagonal, which starts at the upper left corner. Similarly, the more precise term for U is that it is the row echelon form of the matrix A.

Example

[edit]

We factor the following 2-by-2 matrix:

One way to find the LU decomposition of this simple matrix would be to simply solve the linear equations by inspection. Expanding the matrix multiplication gives

This system of equations is underdetermined. In this case any two non-zero elements of L and U matrices are parameters of the solution and can be set arbitrarily to any non-zero value. Therefore, to find the unique LU decomposition, it is necessary to put some restriction on L and U matrices. For example, we can conveniently require the lower triangular matrix L to be a unit triangular matrix, so that all the entries of its main diagonal are set to one. Then the system of equations has the following solution:

Substituting these values into the LU decomposition above yields

Existence and uniqueness

[edit]

Square matrices

[edit]

Any square matrix admits LUP and PLU factorizations.[3] If is invertible, then it admits an LU (or LDU) factorization if and only if all its leading principal minors[7] are nonzero[8] (for example does not admit an LU or LDU factorization). If is a singular matrix of rank , then it admits an LU factorization if the first leading principal minors are nonzero, although the converse is not true.[9]

If a square, invertible matrix has an LDU (factorization with all diagonal entries of L and U equal to 1), then the factorization is unique.[8] In that case, the LU factorization is also unique if we require that the diagonal of (or ) consists of ones.

In general, any square matrix could have one of the following:

  1. a unique LU factorization (as mentioned above);
  2. infinitely many LU factorizations if any of the first (n−1) columns are linearly dependent;
  3. no LU factorization if the first (n−1) columns are linearly independent and at least one leading principal minor is zero.

In Case 3, one can approximate an LU factorization by changing a diagonal entry to to avoid a zero leading principal minor.[10]

Symmetric positive-definite matrices

[edit]

If A is a symmetric (or Hermitian, if A is complex) positive-definite matrix, we can arrange matters so that U is the conjugate transpose of L. That is, we can write A as

This decomposition is called the Cholesky decomposition. If is positive definite, then the Cholesky decomposition exists and is unique. Furthermore, computing the Cholesky decomposition is more efficient and numerically more stable than computing some other LU decompositions.

General matrices

[edit]

For a (not necessarily invertible) matrix over any field, the exact necessary and sufficient conditions under which it has an LU factorization are known. The conditions are expressed in terms of the ranks of certain submatrices. The Gaussian elimination algorithm for obtaining LU decomposition has also been extended to this most general case.[11]

Algorithms

[edit]

Closed formula

[edit]

When an LDU factorization exists and is unique, there is a closed (explicit) formula for the elements of L, D, and U in terms of ratios of determinants of certain submatrices of the original matrix A.[12] In particular, , and for , is the ratio of the -th principal submatrix to the -th principal submatrix. Computation of the determinants is computationally expensive, so this explicit formula is not used in practice.

Using Gaussian elimination

[edit]

The following algorithm is essentially a modified form of Gaussian elimination. Computing an LU decomposition using this algorithm requires floating-point operations, ignoring lower-order terms. Partial pivoting adds only a quadratic term; this is not the case for full pivoting.[13]

Generalized explanation

[edit]
Notation
[edit]

Given an N × N matrix , define as the original, unmodified version of the matrix . The parenthetical superscript (e.g., ) of the matrix is the version of the matrix. The matrix is the matrix in which the elements below the main diagonal have already been eliminated to 0 through Gaussian elimination for the first columns.

Below is a matrix to observe to help us remember the notation (where each represents any real number in the matrix):

Procedure
[edit]

During this process, we gradually modify the matrix using row operations until it becomes the matrix in which all the elements below the main diagonal are equal to zero. During this, we will simultaneously create two separate matrices and , such that .

We define the final permutation matrix as the identity matrix which has all the same rows swapped in the same order as the matrix while it transforms into the matrix . For our matrix , we may start by swapping rows to provide the desired conditions for the n-th column. For example, we might swap rows to perform partial pivoting, or we might do it to set the pivot element on the main diagonal to a non-zero number so that we can complete the Gaussian elimination.

For our matrix , we want to set every element below to zero (where is the element in the n-th column of the main diagonal). We will denote each element below as (where ). To set to zero, we set for each row . For this operation, . Once we have performed the row operations for the first columns, we have obtained an upper triangular matrix which is denoted by .

We can also create the lower triangular matrix denoted as , by directly inputting the previously calculated values of via the formula below.

Example

[edit]

If we are given the matrixwe will choose to implement partial pivoting and thus swap the first and second row so that our matrix and the first iteration of our matrix respectively becomeOnce we have swapped the rows, we can eliminate the elements below the main diagonal on the first column by performing such that,Once these rows have been subtracted, we have derived from the matrix Because we are implementing partial pivoting, we swap the second and third rows of our derived matrix and the current version of our matrix respectively to obtainNow, we eliminate the elements below the main diagonal on the second column by performing such that . Because no non-zero elements exist below the main diagonal in our current iteration of after this row subtraction, this row subtraction derives our final matrix (denoted as ) and final matrix:After also switching the corresponding rows, we obtain our final matrix:Now these matrices have a relation such that .

Relations when no rows are swapped

[edit]

If we did not swap rows at all during this process, we can perform the row operations simultaneously for each column by setting where is the N × N identity matrix with its n-th column replaced by the transposed vector In other words, the lower triangular matrix

Performing all the row operations for the first columns using the formula is equivalent to finding the decomposition Denote so that .

Now let's compute the sequence of . We know that has the following formula.

If there are two lower triangular matrices with 1s in the main diagonal, and neither have a non-zero item below the main diagonal in the same column as the other, then we can include all non-zero items at their same location in the product of the two matrices. For example:

Finally, multiply together and generate the fused matrix denoted as (as previously mentioned). Using the matrix , we obtain

It is clear that in order for this algorithm to work, one needs to have at each step (see the definition of ). If this assumption fails at some point, one needs to interchange n-th row with another row below it before continuing. This is why an LU decomposition in general looks like .

LU Crout decomposition

[edit]

Note that the decomposition obtained through this procedure is a Doolittle decomposition: the main diagonal of L is composed solely of 1s. If one would proceed by removing elements above the main diagonal by adding multiples of the columns (instead of removing elements below the diagonal by adding multiples of the rows), we would obtain a Crout decomposition, where the main diagonal of U is of 1s.

Another (equivalent) way of producing a Crout decomposition of a given matrix A is to obtain a Doolittle decomposition of the transpose of A. Indeed, if is the LU-decomposition obtained through the algorithm presented in this section, then by taking and , we have that is a Crout decomposition.

Through recursion

[edit]

Cormen et al.[14] describe a recursive algorithm for LUP decomposition.

Given a matrix A, let P1 be a permutation matrix such that

,

where , if there is a nonzero entry in the first column of A; or take P1 as the identity matrix otherwise. Now let , if ; or otherwise. We have

Now we can recursively find an LUP decomposition . Let . Therefore

which is an LUP decomposition of A.

Randomized algorithm

[edit]

It is possible to find a low rank approximation to an LU decomposition using a randomized algorithm. Given an input matrix and a desired low rank , the randomized LU returns permutation matrices and lower/upper trapezoidal matrices of size and respectively, such that with high probability , where is a constant that depends on the parameters of the algorithm and is the -th singular value of the input matrix .[15]

Theoretical complexity

[edit]

If two matrices of order n can be multiplied in time M(n), where M(n) ≥ na for some a > 2, then an LU decomposition can be computed in time O(M(n)).[16] This means, for example, that an O(n2.376) algorithm exists based on the Coppersmith–Winograd algorithm.

Sparse-matrix decomposition

[edit]

Special algorithms have been developed for factorizing large sparse matrices. These algorithms attempt to find sparse factors L and U. Ideally, the cost of computation is determined by the number of nonzero entries, rather than by the size of the matrix.

These algorithms use the freedom to exchange rows and columns to minimize fill-in (entries that change from an initial zero to a non-zero value during the execution of an algorithm).

General treatment of orderings that minimize fill-in can be addressed using graph theory.

Applications

[edit]

Solving linear equations

[edit]

Given a system of linear equations in matrix form

we want to solve the equation for x, given A and b. Suppose we have already obtained the LUP decomposition of A such that , so .

In this case the solution is done in two logical steps:

  1. First, we solve the equation for y.
  2. Second, we solve the equation for x.

In both cases we are dealing with triangular matrices (L and U), which can be solved directly by forward and backward substitution without using the Gaussian elimination process (however we do need this process or equivalent to compute the LU decomposition itself).

The above procedure can be repeatedly applied to solve the equation multiple times for different b. In this case it is faster (and more convenient) to do an LU decomposition of the matrix A once and then solve the triangular matrices for the different b, rather than using Gaussian elimination each time. The matrices L and U could be thought to have "encoded" the Gaussian elimination process.

The cost of solving a system of linear equations is approximately floating-point operations if the matrix has size . This makes it twice as fast as algorithms based on QR decomposition, which costs about floating-point operations when Householder reflections are used. For this reason, LU decomposition is usually preferred.[17]

Inverting a matrix

[edit]

When solving systems of equations, b is usually treated as a vector with a length equal to the height of matrix A. In matrix inversion however, instead of vector b, we have matrix B, where B is an n-by-p matrix, so that we are trying to find a matrix X (also a n-by-p matrix):

We can use the same algorithm presented earlier to solve for each column of matrix X. Now suppose that B is the identity matrix of size n. It would follow that the result X must be the inverse of A.[18]

Computing the determinant

[edit]

Given the LUP decomposition of a square matrix A, the determinant of A can be computed straightforwardly as

The second equation follows from the fact that the determinant of a triangular matrix is simply the product of its diagonal entries, and that the determinant of a permutation matrix is equal to (−1)S where S is the number of row exchanges in the decomposition.

In the case of LU decomposition with full pivoting, also equals the right-hand side of the above equation, if we let S be the total number of row and column exchanges.

The same method readily applies to LU decomposition by setting P equal to the identity matrix.

Code examples

[edit]

Fortran90 code example

[edit]
Module mlu
      Implicit None
      Integer, Parameter :: SP = Kind(1d0) ! set I/O real precision
      Private
      Public luban, lusolve
Contains
      Subroutine luban (a,tol,g,h,ip,condinv,detnth)
! By LU decomposition calculates such upper triangles L=G^T, and U=H 
! that square A=LU=G^TH. Partial pivoting IP(:) is modern addition.
! Normal use is for square A, however for RHS a already known
! input of (A|a)^T yields (L|y^T)^T where x in L^Tx=y is solution of Ax=a.
         Real (SP), Intent (In)  :: a (:, :) ! input matrix A(m,n), n<=m
         Real (SP), Intent (In)  :: tol      ! tolerance for near zero pivot
         Real (SP), Intent (Out) :: g (size(a,dim=1), size(a,dim=2)), &! L(m,n)
                                    h (size(a,dim=2), size(a,dim=2)), &! U(n,n)
                                    condinv, & ! 1/cond(A), 0 for singular A
                                    detnth     ! sign*Abs(det(A))**(1/n)
         Integer, Intent (Out)   :: ip (size(a,dim=2)) ! columns permutation
         
         Integer :: k, n, j, l, isig
         Real (SP) :: tol0, pivmax, pivmin, piv
!
         n = size (a, dim=2)
         tol0 = max(tol, 3._SP * epsilon(tol0)) ! use default for tol=0
! Rectangular A and G are permitted under condition:  
         If (n > size(a, dim=1) .Or. n < 1) Stop 90
         Forall (k=1:n) ip(k) = k
         h=0._SP
         g=0._SP
         isig = 1
         detnth = 0._SP
!
         Do k = 1, n 
! Banachiewicz (1938) Eq. (2.3)
            h(k,ip(k:n)) = a(k,ip(k:)) - Matmul(g(k, :k-1),h(:k-1, ip(k:)))
! Find row pivot
            j = (Maxloc(Abs(h(k, ip(k:))), dim=1)+k-1)
            If (j /= k) Then     ! Swap columns j and k
               isig = -isig      ! Change Det(A) sign because of permutation
               l = ip(k)
               ip(k) = ip(j)
               ip(j) = l
            End If
            piv = Abs(h(k, ip(k)))
            If (k == 1) Then     ! Initialize condinv
               pivmax = piv
               pivmin = piv
            Else                 ! Adjust condinv
               pivmax = Max(piv, pivmax)
               pivmin = Min(piv, pivmin)
            End If               
            If (piv < tol0) Then ! singular matrix
               isig = 0
               pivmax = 1._SP
               Exit
            Else ! Account for pivot contribution to Det(A) sign and value
               If (h(k, ip(k)) < 0._SP) isig = -isig
               detnth = detnth + Log(piv)
            End If   
! Banachiewicz (1938) Eq. (2.4)
            g(k+1:, k) = (a(k+1:, ip(k))-Matmul(g(k+1:, :k-1),h(:k-1,ip(k)))) &
               / h(k,ip(k))
            g(k,k) = 1._SP
         End Do
         detnth = isig * exp(detnth / n)
         condinv = Abs(isig) * pivmin / pivmax 
! Test for square A(n,n) by uncommenting below       
!         Print *, '|AP-LU| ',Maxval (Abs(a(:,ip(:))-Matmul(g, h(:,ip(:)))))
      End Subroutine luban
      
      Subroutine lusolve(l,u,ip,x)
! Solves Ax=a system using triangle factors LU=A      
         Real (SP), Intent (In)    :: l (:, :) ! lower triangle matrix L(n,n)
         Real (SP), Intent (In)    :: u (:, :) ! upper triangle matrix U(n,n)
         Integer, Intent (In)      :: ip (:)   ! columns permutation IP(n)
         Real (SP), Intent (InOut) :: x (:, :) ! X(n,m) for m sets of input
            ! right hand sides replaced with output unknowns
         
         Integer :: n, m, i, j
        
         n = size(ip)
         m = size(x, dim=2)
         If (n<1.Or.m<1.Or.Any([n,n]/=shape(l)).Or.Any(shape(l)/=shape(u)).Or. &
            n/=size(x,dim=1)) Stop 91
         Do i = 1, m
            Do j = 1, n
               x(j,i) = x(j,i)-dot_product(x(:j-1,i),l(j,:j-1))
            End Do
            Do j = n, 1, -1
               x(j,i) = (x(j,i)-dot_product(x(j+1:,i),u(j,ip(j+1:)))) / &
                  u(j,ip(j))
            End Do
         End Do
      End Subroutine lusolve     
End Module mlu

C code example

[edit]
/* INPUT: A - array of pointers to rows of a square matrix having dimension N
 *        Tol - small tolerance number to detect failure when the matrix is near degenerate
 * OUTPUT: Matrix A is changed, it contains a copy of both matrices L-E and U as A=(L-E)+U such that P*A=L*U.
 *        The permutation matrix is not stored as a matrix, but in an integer vector P of size N+1 
 *        containing column indexes where the permutation matrix has "1". The last element P[N]=S+N, 
 *        where S is the number of row exchanges needed for determinant computation, det(P)=(-1)^S    
 */
int LUPDecompose(double **A, int N, double Tol, int *P) {

    int i, j, k, imax; 
    double maxA, *ptr, absA;

    for (i = 0; i <= N; i++)
        P[i] = i; //Unit permutation matrix, P[N] initialized with N

    for (i = 0; i < N; i++) {
        maxA = 0.0;
        imax = i;

        for (k = i; k < N; k++)
            if ((absA = fabs(A[k][i])) > maxA) { 
                maxA = absA;
                imax = k;
            }

        if (maxA < Tol) return 0; //failure, matrix is degenerate

        if (imax != i) {
            //pivoting P
            j = P[i];
            P[i] = P[imax];
            P[imax] = j;

            //pivoting rows of A
            ptr = A[i];
            A[i] = A[imax];
            A[imax] = ptr;

            //counting pivots starting from N (for determinant)
            P[N]++;
        }

        for (j = i + 1; j < N; j++) {
            A[j][i] /= A[i][i];

            for (k = i + 1; k < N; k++)
                A[j][k] -= A[j][i] * A[i][k];
        }
    }

    return 1;  //decomposition done 
}

/* INPUT: A,P filled in LUPDecompose; b - rhs vector; N - dimension
 * OUTPUT: x - solution vector of A*x=b
 */
void LUPSolve(double **A, int *P, double *b, int N, double *x) {

    for (int i = 0; i < N; i++) {
        x[i] = b[P[i]];

        for (int k = 0; k < i; k++)
            x[i] -= A[i][k] * x[k];
    }

    for (int i = N - 1; i >= 0; i--) {
        for (int k = i + 1; k < N; k++)
            x[i] -= A[i][k] * x[k];

        x[i] /= A[i][i];
    }
}

/* INPUT: A,P filled in LUPDecompose; N - dimension
 * OUTPUT: IA is the inverse of the initial matrix
 */
void LUPInvert(double **A, int *P, int N, double **IA) {
  
    for (int j = 0; j < N; j++) {
        for (int i = 0; i < N; i++) {
            IA[i][j] = P[i] == j ? 1.0 : 0.0;

            for (int k = 0; k < i; k++)
                IA[i][j] -= A[i][k] * IA[k][j];
        }

        for (int i = N - 1; i >= 0; i--) {
            for (int k = i + 1; k < N; k++)
                IA[i][j] -= A[i][k] * IA[k][j];

            IA[i][j] /= A[i][i];
        }
    }
}

/* INPUT: A,P filled in LUPDecompose; N - dimension. 
 * OUTPUT: Function returns the determinant of the initial matrix
 */
double LUPDeterminant(double **A, int *P, int N) {

    double det = A[0][0];

    for (int i = 1; i < N; i++)
        det *= A[i][i];

    return (P[N] - N) % 2 == 0 ? det : -det;
}

C# code example

[edit]
public class SystemOfLinearEquations
{
    public double[] SolveUsingLU(double[,] matrix, double[] rightPart, int n)
    {
        // decomposition of matrix
        double[,] lu = new double[n, n];
        double sum = 0;
        for (int i = 0; i < n; i++)
        {
            for (int j = i; j < n; j++)
            {
                sum = 0;
                for (int k = 0; k < i; k++)
                    sum += lu[i, k] * lu[k, j];
                lu[i, j] = matrix[i, j] - sum;
            }
            for (int j = i + 1; j < n; j++)
            {
                sum = 0;
                for (int k = 0; k < i; k++)
                    sum += lu[j, k] * lu[k, i];
                lu[j, i] = (1 / lu[i, i]) * (matrix[j, i] - sum);
            }
        }

        // lu = L+U-I
        // find solution of Ly = b
        double[] y = new double[n];
        for (int i = 0; i < n; i++)
        {
            sum = 0;
            for (int k = 0; k < i; k++)
                sum += lu[i, k] * y[k];
            y[i] = rightPart[i] - sum;
        }
        // find solution of Ux = y
        double[] x = new double[n];
        for (int i = n - 1; i >= 0; i--)
        {
            sum = 0;
            for (int k = i + 1; k < n; k++)
                sum += lu[i, k] * x[k];
            x[i] = (1 / lu[i, i]) * (y[i] - sum);
        }
        return x;
    }
}

MATLAB code example

[edit]
function LU = LUDecompDoolittle(A)
    n = length(A);
    LU = A;
    % decomposition of matrix, Doolittle's Method
    for i = 1:1:n
        for j = 1:(i - 1)
            LU(i,j) = (LU(i,j) - LU(i,1:(j - 1))*LU(1:(j - 1),j)) / LU(j,j);
        end
        j = i:n;
        LU(i,j) = LU(i,j) - LU(i,1:(i - 1))*LU(1:(i - 1),j);
    end
    %LU = L+U-I
end

function x = SolveLinearSystem(LU, B)
    n = length(LU);
    y = zeros(size(B));
    % find solution of Ly = B
    for i = 1:n
        y(i,:) = B(i,:) - LU(i,1:i)*y(1:i,:);
    end
    % find solution of Ux = y
    x = zeros(size(B));
    for i = n:(-1):1
        x(i,:) = (y(i,:) - LU(i,(i + 1):n)*x((i + 1):n,:))/LU(i, i);
    end    
end

A = [ 4 3 3; 6 3 3; 3 4 3 ]
LU = LUDecompDoolittle(A)
B = [ 1 2 3; 4 5 6; 7 8 9; 10 11 12 ]'
x = SolveLinearSystem(LU, B)
A * x

See also

[edit]

Notes

[edit]
  1. ^ Banachiewicz (1938).
  2. ^ Dwyer (1951).
  3. ^ a b Okunev & Johnson (1997), Corollary 3.
  4. ^ Trefethen & Bau (1997), p. 166.
  5. ^ Trefethen & Bau (1997), p. 161.
  6. ^ Lay, Lay & McDonald (2021), p. 133, 2.5: Matrix Factorizations.
  7. ^ Rigotti (2001), Leading Principal Minor.
  8. ^ a b Horn & Johnson (1985), Corollary 3.5.5
  9. ^ Horn & Johnson (1985), Theorem 3.5.2.
  10. ^ Nhiayi, Ly; Phan-Yamada, Tuyetdong (2021). "Examining Possible LU Decomposition". North American GeoGebra Journal. 9 (1).
  11. ^ Okunev & Johnson (1997).
  12. ^ Householder (1975).
  13. ^ Golub & Van Loan (1996), pp. 112, 119.
  14. ^ Cormen et al. (2009), p. 819, 28.1: Solving systems of linear equations.
  15. ^ Shabat, Gil; Shmueli, Yaniv; Aizenbud, Yariv; Averbuch, Amir (2016). "Randomized LU Decomposition". Applied and Computational Harmonic Analysis. 44 (2): 246–272. arXiv:1310.7202. doi:10.1016/j.acha.2016.04.006. S2CID 1900701.
  16. ^ Bunch & Hopcroft (1974).
  17. ^ Trefethen & Bau (1997), p. 152.
  18. ^ Golub & Van Loan (1996), p. 121.

References

[edit]
[edit]

References

Computer code

Online resources