Computes the natural logarithm of a square Input Matrix. Wire data to the Input Matrix input to determine the polymorphic instance to use or manually select the instance.


icon

Inputs/Outputs

  • c2ddbl.png Input Matrix —

    Input Matrix is the real square matrix for which you want the natural logarithm.

  • cu16.png logarithm option —

    logarithm option specifies the option for the logarithm that this VI returns.

    0General (default)– Specifies that Input Matrix is regarded as a complex matrix.
    1Real– Returns an exact real logarithm when Input Matrix is a non-singular normal matrix and each of the negative eigenvalues occur an even number of times. When Input Matrix is not normal or one of its negative eigenvalues occurs an odd number of times, LabVIEW returns Matrix Logarithm as if logarithm option was General.
  • i2dcdb.png Matrix Logarithm —

    Matrix Logarithm returns the natural logarithm of Input Matrix.

  • ii32.png error —

    error returns any error or warning from the VI. You can wire error to the Error Cluster From Error Code VI to convert the error code or warning into an error cluster.

    • The natural logarithm is the inverse operation of the exponential. The following equation defines the natural logarithm of a matrix A: eB = A, where matrix B is the logarithm of matrix A. A matrix has a logarithm if and only if its inverse matrix exists. For a real matrix A, its logarithm matrix B can be complex, and the conjugate of matrix B is also the natural logarithm of A.

    A real matrix A is normal if AAT = ATA. For a non-singular normal matrix, if each negative eigenvalues of A occur an even number of times, A has a real logarithm. Note that this does not guarantee the uniqueness of the real logarithm.