pnull

use Lapack to find a particular solution <code>xp</code> of under-determined least
squares system <code>Ax=b</code> and build null space basis <code>B</code> of <code>A</code>
(derived from MASS::Null). In such a way, a general solution is given by
<code>x=xp+Bz</code> where z is an arbitrary vector of size <code>ncol(A)-rank(A)</code>.

We solve non linear least squares problems with optional
equality and/or inequality constraints. Non linear iterations are
globalized with back-tracking method. Linear problems are solved by
dense QR decomposition from 'LAPACK' which can limit the size of
treated problems. On the other side, we avoid condition number
degradation which happens in classical quadratic programming approach.
Inequality constraints treatment on each non
linear iteration is based on 'NNLS' method (by Lawson and Hanson).
We provide an original function 'lsi_ln' for solving linear least squares
problem with inequality constraints in least norm sens. Thus if Jacobian of
the problem is rank deficient a solution still can be provided.
However, truncation errors are probable in this case.
Equality constraints are treated by using a basis of Null-space.
User defined function calculating residuals must return a list having
residual vector (not their squared sum) and Jacobian. If Jacobian is
not in the returned list, package 'numDeriv' is used to calculated
finite difference version of Jacobian. The 'NLSIC' method was fist
published in Sokol et al. (2012) <doi:10.1093/bioinformatics/btr716>.

Serguei Sokol

nlsic

Non Linear Least Squares with Inequality Constraints

pnull function

<dl><dt>A</dt>
<dd>matrix (or its QR decomposition) such that <code>A%*%B=0</code>
where B is a basis of <code>Kern(A)</code> (aka Null-space).</dd>
<dt>b</dt>
<dd>is the right hand side of the least squares system <code>Ax=b</code>.</dd>
<dt>qrat</dt>
<dd>is QR decomposition of <code>t(A)</code>.</dd>
<dt>rcond</dt>
<dd>maximal condition number for rank definition</dd>
<dt>keepqr</dt>
<dd>if TRUE strore qr and qrat as attribute of B</dd></dl>

Arguments

Particular least-squares solution and Null-space basis — pnull

<dl>

<dt>A</dt>
<dd>matrix (or its QR decomposition) such that <code>A%*%B=0</code>
where B is a basis of <code>Kern(A)</code> (aka Null-space).</dd>


<dt>b</dt>
<dd>is the right hand side of the least squares system <code>Ax=b</code>.</dd>


<dt>qrat</dt>
<dd>is QR decomposition of <code>t(A)</code>.</dd>


<dt>rcond</dt>
<dd>maximal condition number for rank definition</dd>


<dt>keepqr</dt>
<dd>if TRUE strore qr and qrat as attribute of B</dd>

</dl>

pnull: Particular least-squares solution and Null-space basis

Description

Usage

Value

Arguments

See Also

Examples