Admin Production ni-theme
Current Publication

QR

LabWindows/CVI

QR

Advanced Analysis Library Only

AnalysisLibErrType QR (void *inputMatrix, ssize_t numberOfRows, ssize_t numberOfColumns, int inputMatrixlgorithm, void *qMatrix, void *rMatrix);

Purpose

Note Note  This function has been superseded by QREx.

Calculates the QR factorization of the real input matrix. The input matrix can be square or rectangular.

The following formula defines the QR factorization of an n-by-m matrix A:

A = QR

where qMatrix is an orthogonal matrix of dimensions n-by-n
rMatrix is an upper triangular matrix of dimensions n-by-m
numberOfRows is the number of rows
numberOfColumns is the number of columns

QR can calculate factorization in many ways. QR provides three methods for the factorization: Householder, Givens, and Fast Givens. You can use QR factorization to solve linear systems with more equations than unknowns.

Parameters

Input
Name Type Description
inputMatrix void * The matrix to factorize. The input matrix can be either square or rectangular.
numberOfRows ssize_t The number of rows in inputMatrix.
numberOfColumns ssize_t The number of columns in inputMatrix.
inputMatrixlgorithm int The algorithm to use for QR factorization. The following table shows valid algorithm values for the factorization methods.

Algorithm Value
Householder 0
Givens 1
Fast Givens 2
Output
Name Type Description
qMatrix void * The calculated orthogonal matrix of the QR factorization, whose size is numberOfRows by numberOfRows.
rMatrix void * The calculated upper triangular matrix of the QR factorization, whose size of numberOfRows by numberOfColumns.

Return Value

Name Type Description
status AnalysisLibErrType A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants.

Additional Information

Library: Advanced Analysis Library

Include file: analysis.h

LabWindows/CVI compatibility: LabWindows/CVI 5.0 and later