goog.math.Matrix

Provided By	`goog.math.Matrix`

Class for representing and manipulating matrices.

The entry that lies in the i-th row and the j-th column of a matrix is typically referred to as the i,j entry of the matrix.

The m-by-n matrix A would have its entries referred to as: [ a0,0 a0,1 a0,2 ... a0,j ... a0,n ] [ a1,0 a1,1 a1,2 ... a1,j ... a1,n ] [ a2,0 a2,1 a2,2 ... a2,j ... a2,n ] [ . . . . . ] [ . . . . . ] [ . . . . . ] [ ai,0 ai,1 ai,2 ... ai,j ... ai,n ] [ . . . . . ] [ . . . . . ] [ . . . . . ] [ am,0 am,1 am,2 ... am,j ... am,n ]

new Matrix( `m`, `opt_n` )

Parameters

`m`	`(goog.math.Matrix\|Array<Array<number>>\|goog.math.Size\|number)`
	A matrix to copy, a 2D-array to take as a template, a size object for dimensions, or the number of rows.
`opt_n`	`number=`
	Number of columns of the matrix (only applicable if the first argument is also numeric).

Instance Methods

Returns a new matrix that is the sum of this and the provided matrix.

Parameters

`m`	`(goog.math.Matrix\|null)`
	The matrix to add to this one.

Returns

goog.math.Matrix

Resultant sum.

Appends the given matrix to the right side of this matrix.

Parameters

`m`	`(goog.math.Matrix\|null)`
	The matrix to augment this matrix with.

Returns

goog.math.Matrix

A new matrix with additional columns on the right.

Appends the given matrix to the bottom of this matrix.

Parameters

`m`	`(goog.math.Matrix\|null)`
	The matrix to augment this matrix with.

Returns

goog.math.Matrix

A new matrix with added columns on the bottom.

Returns whether the given matrix equals this matrix.

Parameters

`m`	`(goog.math.Matrix\|null)`
	The matrix to compare to this one.
`opt_tolerance`	`number=`
	The tolerance when comparing array entries.

Returns

boolean

Whether the given matrix equals this matrix.

Returns the determinant of this matrix. The determinant of a matrix A is often denoted as |A| and can only be applied to a square matrix.

Parameters

None.

Returns

number

The determinant of this matrix.

Returns the inverse of this matrix if it exists or null if the matrix is not invertible.

Parameters

None.

Returns

(goog.math.Matrix|null)

A new matrix which is the inverse of this matrix.

Transforms this matrix into reduced row echelon form.

Parameters

None.

Returns

goog.math.Matrix

A new matrix reduced row echelon form.

Parameters

None.

Returns

goog.math.Size

The dimensions of the matrix.

Return the transpose of this matrix. For an m-by-n matrix, the transpose is the n-by-m matrix which results from turning rows into columns and columns into rows

Parameters

None.

Returns

goog.math.Matrix

A new matrix A^T.

Retrieves the value of a particular coordinate in the matrix or null if the requested coordinates are out of range.

Parameters

`i`	`number`
	The i index of the coordinate.
`j`	`number`
	The j index of the coordinate.

Returns

(number|null)

The value at the specified coordinate.

Parameters

None.

Returns

boolean

Whether the horizontal and vertical dimensions of this matrix are the same.

Performs matrix or scalar multiplication on a matrix and returns the resultant matrix.

Matrix multiplication is defined between two matrices only if the number of columns of the first matrix is the same as the number of rows of the second matrix. If A is an m-by-n matrix and B is an n-by-p matrix, then their product AB is an m-by-p matrix

Scalar multiplication returns a matrix of the same size as the original, each value multiplied by the given value.

Parameters

`m`	`(goog.math.Matrix\|number\|null)`
	Matrix/number to multiply the matrix by.

Returns

goog.math.Matrix

Resultant product.

Sets the value at a particular coordinate (if the coordinate is within the bounds of the matrix).

Parameters

`i`	`number`
	The i index of the coordinate.
`j`	`number`
	The j index of the coordinate.
`value`	`number`
	The new value for the coordinate.

Returns a new matrix that is the difference of this and the provided matrix.

Parameters

`m`	`(goog.math.Matrix\|null)`
	The matrix to subtract from this one.

Returns

goog.math.Matrix

Resultant difference.

Parameters

None.

Returns

Array<Array<number>>

A 2D internal array representing this matrix. Not a clone.

Returns a string representation of the matrix. e.g.

 [ 12  5  9  1 ]
 [  4 16  0 17 ]
 [ 12  5  1 23 ]

Parameters

None.

Returns

string

A string representation of this matrix.

Static Functions

Creates a square identity matrix. i.e. for n = 3:

 [ 1 0 0 ]
 [ 0 1 0 ]
 [ 0 0 1 ]

Parameters

`n`	`number`
	The size of the square identity matrix.

Returns

goog.math.Matrix

Identity matrix of width and height n.

Calls a function for each cell in a matrix.

Parameters

`matrix`	`(goog.math.Matrix\|null)`
	The matrix to iterate over.
`fn`	`function(number, number, number, goog.math.Matrix): ?`
	The function to call for every element. This function takes 4 arguments (value, i, j, and the matrix) and the return value is irrelevant.
`opt_obj`	`(T\|null)=`
	The object to be used as the value of 'this' within `fn`.

Tests whether an array is a valid matrix. A valid array is an array of arrays where all arrays are of the same length and all elements are numbers.

Parameters

`arr`	`Array<Array<number>>`
	An array to test.

Returns

boolean

Whether the array is a valid matrix.

Calls a function for every cell in a matrix and inserts the result into a new matrix of equal dimensions.

Parameters

`matrix`	`goog.math.Matrix`
	The matrix to iterate over.
`fn`	`function(number, number, number, goog.math.Matrix): number`
	The function to call for every element. This function takes 4 arguments (value, i, j and the matrix) and should return a number, which will be inserted into a new matrix.
`opt_obj`	`(T\|null)=`
	The object to be used as the value of 'this' within `fn`.

Returns

goog.math.Matrix

A new matrix with the results from fn.