 | DoubleMatrix Class |
Class DoubleMatrix represents a general mathematical matrix class of
double-precision floating point numbers. Methods are provided for
performing algebraic operations, data manipulation, and slicing.
Inheritance HierarchyNamespace: CenterSpace.NMath.Core
Assembly: NMath (in NMath.dll) Version: 7.3
SyntaxThe DoubleMatrix type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | DoubleMatrix |
An undefined matrix. Must be resized before using.
|
| DoubleMatrix(DataRow) |
Constructs a DoubleMatrix instance whose values are derived from the entire
contents of the given array of rows.
|
| DoubleMatrix(DataRowCollection) |
Constructs a DoubleMatrix instance whose values are derived from the entire
contents of the given row collection.
|
| DoubleMatrix(DataTable) |
Constructs a DoubleMatrix instance whose values are derived from the
entire contents of the given data table.
|
| DoubleMatrix(DataView) |
Constructs a DoubleMatrix instance whose values are derived from the entire
contents of the given data view.
|
| DoubleMatrix(Double) |
Constructs a DoubleMatrix instance initialized with data in a
given two-dimensional array.
|
 | DoubleMatrix(TextReader) |
Constructs a DoubleMatrix instance from the given text reader.
|
| DoubleMatrix(String) |
Constructs a DoubleMatrix instance from a formatted string.
|
| DoubleMatrix(DoubleMatrix) |
Constructs a deep copy of a DoubleMatrix.
|
| DoubleMatrix(DoubleVector) |
Constructs a n x 1 DoubleMatrix instance from a given vector.
|
| DoubleMatrix(Int32, Int32) |
Constructs a DoubleMatrix instance with the specifed number of rows and
columns.
|
| DoubleMatrix(TextReader, NumberStyles) |
Constructs a DoubleMatrix instance from the given text reader.
|
| DoubleMatrix(String, Char) |
Constructs a DoubleMatrix instance from a formatted string with
a specified delimiter.
|
| DoubleMatrix(String, NumberStyles) |
Constructs a DoubleMatrix instance from a formatted string and a
NumberStyles object.
|
| DoubleMatrix(Int32, Int32, DoubleDataBlock) |
Constructs a DoubleMatrix instance from a data block.
|
| DoubleMatrix(Int32, Int32, RandomNumberGenerator) |
Constructs a DoubleMatrix instance from a random number generator.
|
| DoubleMatrix(Int32, Int32, Double) |
Constructs a DoubleMatrix instance of the specifed dimensions and
initializes all matrix element values to the given value.
|
| DoubleMatrix(String, NumberStyles, Char) |
Constructs a DoubleMatrix instance from a formatted string with
a specified delimiter and style.
|
| DoubleMatrix(Int32, Int32, RandomNumberStream, IRandomNumberDistributionDouble) |
Constructs a DoubleMatrix instance from a random number generator.
|
| DoubleMatrix(Int32, Int32, Double, Double) |
Constructs a DoubleMatrix instance of the specifed dimensions.
Values are initialized starting with a given initial value,
incremented by the specified amount for each element in the matrix.
|
| DoubleMatrix(Int32, Int32, Double, StorageType) |
Constructs a DoubleMatrix instance of the specified dimensions,
initialized with the values in a given array.
|
| DoubleMatrix(Int32, Int32, TextReader, Char) |
Constructs a DoubleMatrix instance from a given text reader with
a specified delimiter.
|
| DoubleMatrix(Int32, Int32, String, Char) |
Constructs a DoubleMatrix instance from a formatted string with
a specified delimiter.
|
| DoubleMatrix(Int32, Int32, DoubleDataBlock, Int32, Int32) |
Constructs a DoubleMatrix instance from a data block with the given row and column strides.
|
| DoubleMatrix(Int32, Int32, TextReader, NumberStyles, Char) |
Constructs a DoubleMatrix instance from a given text reader with
specified delimiter and styles.
|
| DoubleMatrix(Int32, Int32, String, NumberStyles, Char) |
Constructs a DoubleMatrix instance from a formatted string with
a specified delimiter and style.
|
Properties| Name | Description | |
|---|---|---|
 | Cols |
Gets number of columns in this matrix.
|
| ColStride |
Gets the increment between successive elements in a column.
|
| DataBlock |
Gets a reference to the underly data that this matrix is viewing.
|
| IsCompactStride |
Returns true if the matrix data is in column major contiguous
storage.
|
| ItemInt32, Slice |
Creates a vector view of the specifed slice of the specified
row of this matrix.
|
| ItemInt32, Int32 |
Indexer for returning the element at a specified row and column
position.
|
| ItemSlice, Slice |
Returns the submatrix determined by the specified slices.
|
| ItemSlice, Int32 |
Creates a vector view of the specifed slice of the specified
column of this matrix.
|
| Rows |
Gets the number of rows in this matrix.
|
| RowStride |
Gets the increment between successive elements in a row.
|
Methods| Name | Description | |
|---|---|---|
 | Add(Double, DoubleMatrix) |
Adds a scalar and a matrix.
|
| Add(DoubleMatrix, DoubleMatrix) |
Adds two matrices.
|
| Add(DoubleMatrix, Double) |
Adds a matrix and a scalar.
|
| Add(Double, DoubleMatrix, DoubleMatrix) |
Adds a scalar and a matrix.
|
| Add(DoubleMatrix, DoubleMatrix, DoubleMatrix) |
Adds two matrices.
|
| Add(DoubleMatrix, Double, DoubleMatrix) |
Adds a scalar to a matrix
|
| Apply(FuncDouble, Double) |
Returns a new matrix with the same size as this matrix, whose values are
the result of applying the given unary function to each element of this matrix.
|
| Apply(FuncDouble, Double, Double, DoubleMatrix) |
Returns a new matrix with the same size as this matrix, whose values are
the result of applying the given binary function to each element of this matrix.
The first parameter to the binary function is the matrix element; the
second parameter is the corresponding element of the passed matrix.
|
| Apply(FuncDouble, Double, Double, Double) |
Returns a new matrix with the same size as this matrix, whose values are
the result of applying the given binary function to each element of this matrix.
The first parameter to the binary function is the matrix element; the second
parameter is the passed double-precision value.
|
| Apply(FuncDouble, Int32, Double, Int32) |
Returns a new matrix with the same size as this matrix, whose values are
the result of applying the given binary function to each element of this matrix.
The first parameter to the binary function is the matrix element; the second
parameter is the passed integer value.
|
| ApplyColumns |
Returns a new vector containing an element for each column in this matrix.
The elements are the results of applying a function that takes a vector and
returns a single-precision number.
|
| Clear |
Sets the data elements of this vector to zero.
|
| Clear(Int32, Slice) |
Sets the values of the submatrix determined by the specified slices to zero.
|
| Clear(Slice, Slice) |
Sets the values of the submatrix determined by the specified slices to zero.
|
| Clear(Slice, Int32) |
Sets the values of the submatrix determined by the specified slices to zero.
|
| Clone |
Creates a deep copy of this matrix.
|
| Col |
Returns a column of this matrix as a vector. The returned vector
and the matrix share the data.
|
| Decrement |
Decrements each element of the given matrix.
|
| DeepenThisCopy |
Guarantees that there is only one reference to the underlying
data and that this data is in contiguous storage.
|
| Diagonal |
Returns a vector view of the main diagonal of this matrix.
|
| Diagonal(Int32) |
Returns a vector view of a diagonal of this matrix.
|
| Divide(Double, DoubleMatrix) |
Divide a scalar by a matrix.
|
| Divide(DoubleMatrix, DoubleMatrix) |
Divide a matrix by another.
|
| Divide(DoubleMatrix, Double) |
Divide a matrix by a scalar.
|
| Divide(Double, DoubleMatrix, DoubleMatrix) |
Divide a scalar by a matrix.
|
| Divide(DoubleMatrix, DoubleMatrix, DoubleMatrix) |
Divide a matrix by another.
|
| Divide(DoubleMatrix, Double, DoubleMatrix) |
Divide a matrix by a scalar.
|
| Equals |
Tests for equality of this matrix and another matrix.
Two matrices are equal if they have the same dimensions and all
values are equal.
(Overrides ObjectEquals(Object).) |
| FrobeniusNorm |
Computes the Frobenius norm for this matrix.
|
| GetDoubleEnumerator |
Creates an IDoubleEnumerator out of the data elements in this vector.
|
| GetEnumerator |
Creates an IEnumerator{double} out of the data elements in this matrix.
|
| GetHashCode |
Returns an integer hash code for this matrix.
(Overrides ObjectGetHashCode.) |
| GetSchema |
The method is reserved and should not be used.
|
| Identity |
Returns an identity matrix of the specified size.
|
| Increment(Double) |
Adds the specified value to each element in the matrix.
|
| Increment(DoubleMatrix) |
Increments each element of the given matrix.
|
| InfinityNorm |
Computes the infinity-norm of this matrix.
|
| IsNumeric |
Checks every matrix element for NaN or Infinity values, if none are found, true is returned, otherwise false is returned.
|
| Multiply(Double, DoubleMatrix) |
Multiple a scalar and a matrix.
|
| Multiply(DoubleMatrix, DoubleMatrix) |
Multiply two matrices.
|
| Multiply(DoubleMatrix, Double) |
Multiply a matrix and a scalar.
|
| Multiply(Double, DoubleMatrix, DoubleMatrix) |
Multiply a scalar and a matrix.
|
| Multiply(DoubleMatrix, DoubleMatrix, DoubleMatrix) |
Multiply two matrices.
|
| Multiply(DoubleMatrix, Double, DoubleMatrix) |
Multiply a matrix and a scalar.
|
| NaNEquals |
Tests for equality of this matrix and another matrix.
Two matrices are equal if they have the same dimensions and all
values are equal.
|
| Negate |
Negation operator.
|
| OneNorm |
Computes the 1-norm of this matrix.
|
| Parse(TextReader) |
Returns a new DoubleMatrix instance from the given text reader.
|
| Parse(String) |
Constructs a DoubleMatrix instance from a formatted string.
|
| Parse(TextReader, NumberStyles) |
Returns a new DoubleMatrix instance from the given text reader.
|
| Parse(String, NumberStyles) |
Constructs a DoubleMatrix instance from a formatted string and a
NumberStyles object.
|
| ReadXml |
Generates a DoubleMatrix instance form its XML representation.
Examples
The matrix:
| 1 2 3 |
| 4 5 6 |
| 7 8 9 |
would be serialized as:
|
| Resize |
Changes the dimensions of this matrix to those specified, adding
zeros or truncating as necessary.
|
| ResizeAndClear |
Changes the dimensions of this matrix to those specified. Matrix
values are not preserved during this operation and are reset to
zero.
|
| Row |
Returns a row of this matrix as a vector. The returned vector
and the matrix share the data.
|
| Scale |
Scales each element in the matrix by the specified value.
|
| Set(Double) |
Sets the data elements of this vector to the specified value.
|
| Set(Int32, Slice, Double) |
Sets the values in the specified row and columns to the
given value.
|
| Set(Slice, Slice, Double) |
Sets the values of the submatrix determined by the specified slices to
a given value.
|
| Set(Slice, Int32, Double) |
Sets the values in the specified rows and column to a
given value.
|
| ShallowCopy |
Creates a shallow copy of this matrix.
|
| Slice |
Returns a vector that views a slice of this matrix. The slice begins at
element i,j and extends for n elements. The increment
between successive elements in the vector is rowStride rows and
colStride columns.
|
| Subtract(Double, DoubleMatrix) |
Subtracts a matrix from a scalar.
|
| Subtract(DoubleMatrix, DoubleMatrix) |
Subtracts one matrix from another.
|
| Subtract(DoubleMatrix, Double) |
Subtracts a scalar from a matrix.
|
| Subtract(Double, DoubleMatrix, DoubleMatrix) |
Subtracts a matrix from a scalar.
|
| Subtract(DoubleMatrix, DoubleMatrix, DoubleMatrix) |
Subtracts one matrix from another.
|
| Subtract(DoubleMatrix, Double, DoubleMatrix) |
Subtracts a scalar from a matrix.
|
| ToArray |
Copies data into an array and returns it.
|
| ToCommaSeparated |
Returns a formatted string representation of this matrix using commas
and newlines.
|
| ToCommaSeparated(String) |
Returns a formatted string representation of this matrix using commas
and newlines. Numbers are formatted using the specified format string.
|
| ToDataTable |
Creates a data table containing the values in this matrix.
|
| ToDataTable(String) |
Creates a data table with the specified name containing the
values in this matrix.
|
| ToString |
Returns a formatted string representation of this matrix.
(Overrides ObjectToString.) |
| ToString(String) |
Returns a formatted string representation of this matrix. Numbers are displayed
using the specified format.
|
| ToTabDelimited |
Returns a formatted string representation of this matrix using tabs
and newlines.
|
| ToTabDelimited(String) |
Returns a formatted string representation of this matrix using tabs
and newlines. Numbers are formatted using the specified format string.
|
| Transform(FuncDouble) |
Modifies the elements of this matrix by applying the given no-argument function to
each element.
|
| Transform(FuncDouble, Double) |
Modifies the elements of this matrix by applying the given unary function to
each element.
|
| Transform(FuncDouble, Double, Double, DoubleMatrix) |
Modifies the contents of this matrix by applying the given binary function
to each element. The first parameter to the binary function is the matrix
element; the second parameter is the corresponding element of the passed matrix.
|
| Transform(FuncDouble, Double, Double, Double) |
Modifies the contents of this matrix by applying the given binary function
to each element. The first parameter to the binary function is
the matrix element; the second parameter is the passed double-precision value.
|
| Transform(FuncDouble, Int32, Double, Int32) |
Modifies the contents of this matrix by applying the given binary function
to each element. The first parameter to the binary function is
the matrix element; the second parameter is the passed integer value.
|
| Transpose |
Returns the transpose of this matrix.
|
| Write(TextWriter) |
Writes a text representation of this matrix to the writer.
|
| Write(TextWriter, String) |
Writes a formatted text representation of this matrix to the writer
using the specified format.
|
| WriteAsCSV(TextWriter) |
Writes a formatted text representation of this matrix using commas
and newlines.
|
| WriteAsCSV(TextWriter, String) |
Writes a formatted string representation of this matrix using commas
and newlines. Numbers are formatted using the specified format string.
|
| WriteXml |
Converts an object into its XML representation.
Examples
The matrix:
| 1 2 3 |
| 4 5 6 |
| 7 8 9 |
would be serialized as:
|
Operators| Name | Description | |
|---|---|---|
 | Addition(Double, DoubleMatrix) |
Adds a scalar and a matrix.
|
| Addition(DoubleMatrix, DoubleMatrix) |
Adds two matrices.
|
| Addition(DoubleMatrix, Double) |
Adds a matrix and a scalar.
|
| Decrement |
Decrements each element of the given matrix.
|
| Division(Double, DoubleMatrix) |
Divide a scalar by a matrix.
|
| Division(DoubleMatrix, DoubleMatrix) |
Divide a matrix by another.
|
| Division(DoubleMatrix, Double) |
Divide a matrix by a scalar.
|
| Equality |
Tests for equality of two matrices. Two matrices are equal if they
have the same dimensions and all values are equal.
|
| (FloatMatrix to DoubleMatrix) |
Implicitly converts a FloatMatrix instance into a DoubleMatrix instance.
|
| Increment |
Increments each element of the given matrix.
|
| Inequality |
Tests for inequality of two matrices. Two matrices are not equal if they
have different dimensions or their values are not all equal.
|
| Multiply(Double, DoubleMatrix) |
Multiply a scalar and a matrix.
|
| Multiply(DoubleMatrix, DoubleMatrix) |
Multiple two matrices.
|
| Multiply(DoubleMatrix, Double) |
Multiply a matrix and a scalar.
|
| Subtraction(Double, DoubleMatrix) |
Subtracts a matrix from a scalar.
|
| Subtraction(DoubleMatrix, DoubleMatrix) |
Subtracts one matrix from another.
|
| Subtraction(DoubleMatrix, Double) |
Subtracts a scalar from a matrix.
|
| UnaryNegation |
Negation operator.
|
| UnaryPlus |
Unary + operator. Just returns the input matrix.
|
Fields| Name | Description | |
|---|---|---|
 | XmlColumnsAttribute |
XML columns attribute name.
|
| XmlDataElement |
XML data element name.
|
| XmlDatumElement |
XML datum element name.
|
| XmlRowsAttribute |
XML rows attribute name.
|
See Also