mpsmatrixdecompositioncholesky(3) [mojave man page]

MPSMatrixDecompositionCholesky(3)			 MetalPerformanceShaders.framework			 MPSMatrixDecompositionCholesky(3)

NAME

       MPSMatrixDecompositionCholesky

SYNOPSIS

       #import <MPSMatrixDecomposition.h>

       Inherits MPSMatrixUnaryKernel.

   Instance Methods
       (nonnull instancetype) - initWithDevice:lower:order:
       (void) - encodeToCommandBuffer:sourceMatrix:resultMatrix:status:

   Additional Inherited Members
Detailed Description
       This depends on Metal.framework.

       A kernel for computing the Cholesky factorization of a matrix.

       A MPSMatrixDecompositionLU object computes one of the following factorizations of a matrix A:

       A = L * L**T
       A = U**T * U

       A is a symmetric positive-definite matrix for which the factorization is to be computed. L and U are lower and upper triangular matrices
       respectively.

Method Documentation
   - (void) encodeToCommandBuffer: (nonnull id< MTLCommandBuffer >) commandBuffer(MPSMatrix *__nonnull) sourceMatrix(MPSMatrix *__nonnull)
       resultMatrix(__nullable id< MTLBuffer >) status
       Encode a MPSMatrixDecompositionCholesky kernel into a command Buffer.

       Parameters:
	   commandBuffer A valid MTLCommandBuffer to receive the encoded filter
	   sourceMatrix A valid MPSMatrix containing the source data. Must have enough space to hold a order x order matrix.
	   resultMatrix A valid MPSMatrix to contain the result. Must have enough space to hold a order x order matrix.
	   status A MTLBuffer which indicates the resulting MPSMatrixDecompositionStatus value.

       This function encodes the MPSMatrixDecompositionCholesky object to a valid command buffer.

       If during the factorization a leading minor of the matrix is found to be not positive definite, MPSMatrixDecompositionNonPositiveDefinite
       will be returned in the provided status buffer. Previously computed pivots and the non positive pivot are written to the result, but the
       factorization does not complete. The data referenced by the MTLBuffer is not valid until the command buffer has completed execution. If the
       matrix return status is not desired NULL may be provided.

       If the return status is MPSMatrixDecompositionStatusSuccess, resultMatrix contains the resulting factors in its lower or upper triangular
       regions respectively.

       This kernel functions either in-place, if the result matrix completely aliases the source matrix, or out-of-place. If there is any partial
       overlap between input and output data the results are undefined.

   - (nonnull instancetype) initWithDevice: (nonnull id< MTLDevice >) device(BOOL) lower(NSUInteger) order
       Initialize an MPSMatrixDecompositionCholesky object on a device

       Parameters:
	   device The device on which the kernel will execute.
	   lower A boolean value indicating if the lower triangular part of the source matrix is stored. If lower = YES the lower triangular part
	   will be used and the factor will be written to the lower triangular part of the result, otherwise the upper triangular part will be
	   used and the factor will be written to the upper triangular part.
	   order The number of rows and columns in the source matrix.

       Returns:
	   A valid MPSMatrixDecompositionCholesky object or nil, if failure.

Author
       Generated automatically by Doxygen for MetalPerformanceShaders.framework from the source code.

Version MetalPerformanceShaders-100				  Thu Feb 8 2018				 MPSMatrixDecompositionCholesky(3)

Check Out this Related Man Page

MPSMatrixSolveLU(3)					 MetalPerformanceShaders.framework				       MPSMatrixSolveLU(3)

NAME

       MPSMatrixSolveLU

SYNOPSIS

       #import <MPSMatrixSolve.h>

       Inherits MPSMatrixBinaryKernel.

   Instance Methods
       (nonnull instancetype) - initWithDevice:transpose:order:numberOfRightHandSides:
       (void) - encodeToCommandBuffer:sourceMatrix:rightHandSideMatrix:pivotIndices:solutionMatrix:

   Additional Inherited Members
Detailed Description
       This depends on Metal.framework.

       A kernel for computing the solution of a linear system of equations using the LU factorization resulting from a MPSMatrixDecompositionLU
       kernel.

       A MPSMatrixSolveLU finds the solution matrix to the system:

		   op(A) * X = B

	       Where op(A) is A**T or A.  B is the array of right hand sides for which
	       the equations are to be solved.	X is the resulting matrix of solutions.

Method Documentation
   - (void) encodeToCommandBuffer: (nonnull id< MTLCommandBuffer >) commandBuffer(MPSMatrix *__nonnull) sourceMatrix(MPSMatrix *__nonnull)
       rightHandSideMatrix(MPSMatrix *__nonnull) pivotIndices(MPSMatrix *__nonnull) solutionMatrix
       Encode a MPSMatrixSolveLU kernel into a command Buffer.

       Parameters:
	   commandBuffer A valid MTLCommandBuffer to receive the encoded filter
	   sourceMatrix A valid MPSMatrix containing the source matrix in factored form as returned by a previous successful execution of a
	   MPSMatrixDecompositionLU kernel.
	   rightHandSideMatrix A valid MPSMatrix containing the right hand side values.
	   pivotIndices A valid MPSMatrix which contains the pivot indices as returned by a previous successful execution of a
	   MPSMatrixDecompositionLU kernel.
	   solutionMatrix A valid MPSMatrix to contain the result.

       This function encodes the MPSMatrixSolveLU object to a valid command buffer. sourceMatrix should contain the lower and upper triangular
       factors of A as results from a previous execution of MPSMatrixDecompositionLU.

       pivotIndices is an array of pivots resulting from a previous execution of MPSMatrixDecompositionLU.

       rightHandSideMatrix and solutionMatrix must be large enough to hold a matrix of size order x numberOfRightHandSides starting at
       secondarySourceMatrixOrigin and resultMatrixOrigin respectively.

       sourceMatrix must be at least size order x order starting at primarySourceMatrixOrigin.

   - (nonnull instancetype) initWithDevice: (nonnull id< MTLDevice >) device(BOOL) transpose(NSUInteger) order(NSUInteger) numberOfRightHandSides
       Initialize an MPSMatrixSolveLU object on a device

       Parameters:
	   device The device on which the kernel will execute.
	   transpose A boolean value which indicates if the source matrix should be used in transposed form.
	   order The order of the source matrix and the number of rows in the solution and right hand side matrices.
	   numberOfRightHandSides The number of columns in the solution and right hand side matrices.

       Returns:
	   A valid MPSMatrixSolveLU object or nil, if failure.

Author
       Generated automatically by Doxygen for MetalPerformanceShaders.framework from the source code.

Version MetalPerformanceShaders-100				  Thu Feb 8 2018					       MPSMatrixSolveLU(3)

Linux and UNIX Man Pages

mpsmatrixdecompositioncholesky(3) [mojave man page]

Check Out this Related Man Page