_NullSpace

it.grypho.scala.leonardo.matrix._NullSpace
case class _NullSpace(which: Subspace, m: _Expression, tol: Option[_Expression] = ...) extends _Expression

An orthonormal basis of the null space, nullspace(A), or of the range, orth(A), each with rank's optional relative tolerance (F_0087).

The answer is a matrix whose columns are the basis. A trivial subspace answers false — the null space of a full-column-rank matrix, the range of the zero matrix — since a matrix cannot have zero columns, and false is what tfpoles and stationary answer for provably none. The zero matrix's null space is the whole space. The basis is unique only up to rotation; its columns come from the SVD's V or U. An exact matrix demotes and a symbolic one stays symbolic, the rank rules; a tolerance that is not a number in [0, 1) leaves the call as written, with the reason in declineReason.

It is the null-space method's N in z = z₀ + N·w for equality constraints, which is why it was filed (F_0061 Decision A, for F_0074 and F_0066).

Value parameters

m

the matrix expression

tol

the optional relative tolerance

which

the subspace

Attributes

Graph
Supertypes
trait Serializable
trait Product
trait Equals
trait _Expression
class Object
trait Matchable
class Any
Show all

Members list

Value members

Concrete methods

override def children: List[_Expression]

Sub-expressions subject to recursive structural traversal. Binder positions (e.g. the differentiation variable) are excluded.

Sub-expressions subject to recursive structural traversal. Binder positions (e.g. the differentiation variable) are excluded.

Attributes

Definition Classes
def declineReason(env: Environment): Option[String]

Why this call stays unevaluated: a tolerance that is a number outside [0, 1), or a real matrix refused by the decomposition (see svdDecline).

Why this call stays unevaluated: a tolerance that is a number outside [0, 1), or a real matrix refused by the decomposition (see svdDecline).

Value parameters

env

the evaluation environment

Attributes

Returns

the reason, or None

override def eval(env: Environment): Either[_Expression, _Value]

Reduces this expression in the given environment.

Reduces this expression in the given environment.

Value parameters

env

variable bindings and display precision

Attributes

Returns

Right(v) when all free variables resolved to concrete values; Left(e) when reduction is partial or impossible

Definition Classes
override def rebuild(c: List[_Expression]): _Expression

Reconstructs the same node shape with replacement sub-expressions.

Reconstructs the same node shape with replacement sub-expressions.

Value parameters

newChildren

replacements in the same order and count as children

Attributes

Definition Classes
override def toString: String

Returns a string representation of the object.

Returns a string representation of the object.

The default representation is platform dependent.

Attributes

Returns

a string representation of the object.

Definition Classes
Any

Inherited methods

def productElementNames: Iterator[String]

Attributes

Inherited from:
Product
def productIterator: Iterator[Any]

Attributes

Inherited from:
Product

Inherited fields

lazy val freeVars: Set[String]

Cached set of free variable names; O(1) after the first access.

Cached set of free variable names; O(1) after the first access.

Attributes

Inherited from:
_Expression