<?php
|
|
/**
|
|
* @package JAMA
|
|
*
|
|
* For an m-by-n matrix A with m >= n, the QR decomposition is an m-by-n
|
|
* orthogonal matrix Q and an n-by-n upper triangular matrix R so that
|
|
* A = Q*R.
|
|
*
|
|
* The QR decompostion always exists, even if the matrix does not have
|
|
* full rank, so the constructor will never fail. The primary use of the
|
|
* QR decomposition is in the least squares solution of nonsquare systems
|
|
* of simultaneous linear equations. This will fail if isFullRank()
|
|
* returns false.
|
|
*
|
|
* @author Paul Meagher
|
|
* @license PHP v3.0
|
|
* @version 1.1
|
|
*/
|
|
class PHPExcel_Shared_JAMA_QRDecomposition
|
|
{
|
|
const MATRIX_RANK_EXCEPTION = "Can only perform operation on full-rank matrix.";
|
|
|
|
/**
|
|
* Array for internal storage of decomposition.
|
|
* @var array
|
|
*/
|
|
private $QR = array();
|
|
|
|
/**
|
|
* Row dimension.
|
|
* @var integer
|
|
*/
|
|
private $m;
|
|
|
|
/**
|
|
* Column dimension.
|
|
* @var integer
|
|
*/
|
|
private $n;
|
|
|
|
/**
|
|
* Array for internal storage of diagonal of R.
|
|
* @var array
|
|
*/
|
|
private $Rdiag = array();
|
|
|
|
|
|
/**
|
|
* QR Decomposition computed by Householder reflections.
|
|
*
|
|
* @param matrix $A Rectangular matrix
|
|
* @return Structure to access R and the Householder vectors and compute Q.
|
|
*/
|
|
public function __construct($A)
|
|
{
|
|
if ($A instanceof PHPExcel_Shared_JAMA_Matrix) {
|
|
// Initialize.
|
|
$this->QR = $A->getArrayCopy();
|
|
$this->m = $A->getRowDimension();
|
|
$this->n = $A->getColumnDimension();
|
|
// Main loop.
|
|
for ($k = 0; $k < $this->n; ++$k) {
|
|
// Compute 2-norm of k-th column without under/overflow.
|
|
$nrm = 0.0;
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$nrm = hypo($nrm, $this->QR[$i][$k]);
|
|
}
|
|
if ($nrm != 0.0) {
|
|
// Form k-th Householder vector.
|
|
if ($this->QR[$k][$k] < 0) {
|
|
$nrm = -$nrm;
|
|
}
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$this->QR[$i][$k] /= $nrm;
|
|
}
|
|
$this->QR[$k][$k] += 1.0;
|
|
// Apply transformation to remaining columns.
|
|
for ($j = $k+1; $j < $this->n; ++$j) {
|
|
$s = 0.0;
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$s += $this->QR[$i][$k] * $this->QR[$i][$j];
|
|
}
|
|
$s = -$s/$this->QR[$k][$k];
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$this->QR[$i][$j] += $s * $this->QR[$i][$k];
|
|
}
|
|
}
|
|
}
|
|
$this->Rdiag[$k] = -$nrm;
|
|
}
|
|
} else {
|
|
throw new PHPExcel_Calculation_Exception(PHPExcel_Shared_JAMA_Matrix::ARGUMENT_TYPE_EXCEPTION);
|
|
}
|
|
} // function __construct()
|
|
|
|
|
|
/**
|
|
* Is the matrix full rank?
|
|
*
|
|
* @return boolean true if R, and hence A, has full rank, else false.
|
|
*/
|
|
public function isFullRank()
|
|
{
|
|
for ($j = 0; $j < $this->n; ++$j) {
|
|
if ($this->Rdiag[$j] == 0) {
|
|
return false;
|
|
}
|
|
}
|
|
return true;
|
|
} // function isFullRank()
|
|
|
|
/**
|
|
* Return the Householder vectors
|
|
*
|
|
* @return Matrix Lower trapezoidal matrix whose columns define the reflections
|
|
*/
|
|
public function getH()
|
|
{
|
|
for ($i = 0; $i < $this->m; ++$i) {
|
|
for ($j = 0; $j < $this->n; ++$j) {
|
|
if ($i >= $j) {
|
|
$H[$i][$j] = $this->QR[$i][$j];
|
|
} else {
|
|
$H[$i][$j] = 0.0;
|
|
}
|
|
}
|
|
}
|
|
return new PHPExcel_Shared_JAMA_Matrix($H);
|
|
} // function getH()
|
|
|
|
/**
|
|
* Return the upper triangular factor
|
|
*
|
|
* @return Matrix upper triangular factor
|
|
*/
|
|
public function getR()
|
|
{
|
|
for ($i = 0; $i < $this->n; ++$i) {
|
|
for ($j = 0; $j < $this->n; ++$j) {
|
|
if ($i < $j) {
|
|
$R[$i][$j] = $this->QR[$i][$j];
|
|
} elseif ($i == $j) {
|
|
$R[$i][$j] = $this->Rdiag[$i];
|
|
} else {
|
|
$R[$i][$j] = 0.0;
|
|
}
|
|
}
|
|
}
|
|
return new PHPExcel_Shared_JAMA_Matrix($R);
|
|
} // function getR()
|
|
|
|
/**
|
|
* Generate and return the (economy-sized) orthogonal factor
|
|
*
|
|
* @return Matrix orthogonal factor
|
|
*/
|
|
public function getQ()
|
|
{
|
|
for ($k = $this->n-1; $k >= 0; --$k) {
|
|
for ($i = 0; $i < $this->m; ++$i) {
|
|
$Q[$i][$k] = 0.0;
|
|
}
|
|
$Q[$k][$k] = 1.0;
|
|
for ($j = $k; $j < $this->n; ++$j) {
|
|
if ($this->QR[$k][$k] != 0) {
|
|
$s = 0.0;
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$s += $this->QR[$i][$k] * $Q[$i][$j];
|
|
}
|
|
$s = -$s/$this->QR[$k][$k];
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$Q[$i][$j] += $s * $this->QR[$i][$k];
|
|
}
|
|
}
|
|
}
|
|
}
|
|
/*
|
|
for($i = 0; $i < count($Q); ++$i) {
|
|
for($j = 0; $j < count($Q); ++$j) {
|
|
if (! isset($Q[$i][$j]) ) {
|
|
$Q[$i][$j] = 0;
|
|
}
|
|
}
|
|
}
|
|
*/
|
|
return new PHPExcel_Shared_JAMA_Matrix($Q);
|
|
} // function getQ()
|
|
|
|
/**
|
|
* Least squares solution of A*X = B
|
|
*
|
|
* @param Matrix $B A Matrix with as many rows as A and any number of columns.
|
|
* @return Matrix Matrix that minimizes the two norm of Q*R*X-B.
|
|
*/
|
|
public function solve($B)
|
|
{
|
|
if ($B->getRowDimension() == $this->m) {
|
|
if ($this->isFullRank()) {
|
|
// Copy right hand side
|
|
$nx = $B->getColumnDimension();
|
|
$X = $B->getArrayCopy();
|
|
// Compute Y = transpose(Q)*B
|
|
for ($k = 0; $k < $this->n; ++$k) {
|
|
for ($j = 0; $j < $nx; ++$j) {
|
|
$s = 0.0;
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$s += $this->QR[$i][$k] * $X[$i][$j];
|
|
}
|
|
$s = -$s/$this->QR[$k][$k];
|
|
for ($i = $k; $i < $this->m; ++$i) {
|
|
$X[$i][$j] += $s * $this->QR[$i][$k];
|
|
}
|
|
}
|
|
}
|
|
// Solve R*X = Y;
|
|
for ($k = $this->n-1; $k >= 0; --$k) {
|
|
for ($j = 0; $j < $nx; ++$j) {
|
|
$X[$k][$j] /= $this->Rdiag[$k];
|
|
}
|
|
for ($i = 0; $i < $k; ++$i) {
|
|
for ($j = 0; $j < $nx; ++$j) {
|
|
$X[$i][$j] -= $X[$k][$j]* $this->QR[$i][$k];
|
|
}
|
|
}
|
|
}
|
|
$X = new PHPExcel_Shared_JAMA_Matrix($X);
|
|
return ($X->getMatrix(0, $this->n-1, 0, $nx));
|
|
} else {
|
|
throw new PHPExcel_Calculation_Exception(self::MATRIX_RANK_EXCEPTION);
|
|
}
|
|
} else {
|
|
throw new PHPExcel_Calculation_Exception(PHPExcel_Shared_JAMA_Matrix::MATRIX_DIMENSION_EXCEPTION);
|
|
}
|
|
}
|
|
}
|