com.numericalmethod.suanshu.matrix.doubles.operation

Class Pow

java.lang.Object

com.numericalmethod.suanshu.matrix.doubles.matrixtype.dense.DenseMatrix

com.numericalmethod.suanshu.matrix.doubles.operation.Pow

All Implemented Interfaces:

Table, DeepCopyable, AbelianGroup<Matrix>, Monoid<Matrix>, Ring<Matrix>, Matrix, MatrixAccess, MatrixRing, MatrixTable, Densifiable, java.io.Serializable

public class Pow
extends DenseMatrix

This is a square matrix A to the power of an integer n, Aⁿ. To avoid overflow of double precision, we represent the result as a product of

Aⁿ = base^scale * B;

E.g.,

Aⁿ = 1e100^scale * B = 10^{100 * scale} * B

All entries in B can be represented in double precision.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Pow(Matrix A, int n) Construct the power matrix An so that An = (1e100)scale * B
Pow(Matrix A, int n, double base) Construct the power matrix An so that An = basescale * B

Method Summary

Modifier and Type	Method and Description
ImmutableMatrix	B() Get the double precision matrix.
double	base() Get the radix or base of the coefficient.
int	scale() Get the exponential of the coefficient.

Methods inherited from class com.numericalmethod.suanshu.matrix.doubles.matrixtype.dense.DenseMatrix

add, deepCopy, equals, get, getColumn, getColumn, getRow, getRow, hashCode, minus, multiply, multiply, nCols, nRows, ONE, opposite, scaled, set, setColumn, setRow, t, toDense, toString, ZERO

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Pow

public Pow(Matrix A,
           int n,
           double base)

Construct the power matrix Aⁿ so that

Aⁿ = base^scale * B

Parameters:

A - a matrix

n - a positive integer exponent

base - the base to scale down the product to avoid overflow

Pow

public Pow(Matrix A,
           int n)

Construct the power matrix Aⁿ so that

Aⁿ = (1e100)^scale * B

Parameters:

A - a matrix

n - a positive integer exponent

Method Detail

base

public double base()

Get the radix or base of the coefficient.

Returns:

the base

See Also:

Wikipedia: Radix

scale

public int scale()

Get the exponential of the coefficient.

Returns:

the exponential of the coefficient

B

public ImmutableMatrix B()

Get the double precision matrix.

Returns:

the double precision matrix