 | Float |
Class FloatMatrix represents a general mathematical matrix class of
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.4
SyntaxThe FloatMatrix type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | FloatMatrix | An undefined matrix. Must be resized before using. |
| FloatMatrix(DataRow) | Constructs a FloatMatrix instance whose values are derived from the entire contents of the given array of rows. |
| FloatMatrix(DataRowCollection) | Constructs a FloatMatrix instance whose values are derived from the entire contents of the given row collection. |
| FloatMatrix(DataTable) | Constructs a FloatMatrix instance whose values are derived from the entire contents of the given data table. |
| FloatMatrix(DataView) | Constructs a FloatMatrix instance whose values are derived from the entire contents of the given data view. |
| FloatMatrix(FloatMatrix) | Constructs a deep copy of a FloatMatrix. |
| FloatMatrix(FloatVector) | Constructs a n x 1 FloatMatrix instance from a given vector. |
| FloatMatrix(Single) | Constructs a FloatMatrix instance initialized with data in a given two-dimensional array. |
 | FloatMatrix(String) | Constructs a FloatMatrix instance from a formatted string. |
| FloatMatrix(TextReader) | Constructs a FloatMatrix instance from the given text reader. |
| FloatMatrix(Int32, Int32) | Constructs a FloatMatrix instance with the specifed number of rows and columns. |
| FloatMatrix(String, Char) | Constructs a FloatMatrix instance from a formatted string with a specified delimiter. |
| FloatMatrix(String, NumberStyles) | Constructs a FloatMatrix instance from a formatted string and a NumberStyles object. |
| FloatMatrix(TextReader, NumberStyles) | Constructs a FloatMatrix instance from the given text reader. |
| FloatMatrix(Int32, Int32, FloatDataBlock) | Constructs a FloatMatrix instance from a data block. |
| FloatMatrix(Int32, Int32, RandomNumberGenerator) | Constructs a FloatMatrix instance from a random number generator. |
| FloatMatrix(Int32, Int32, Single) | Constructs a FloatMatrix instance of the specifed dimensions and initializes all matrix element values to the given value. |
| FloatMatrix(String, NumberStyles, Char) | Constructs a FloatMatrix instance from a formatted string with a specified delimiter and style. |
| FloatMatrix(Int32, Int32, RandomNumberStream, IRandomNumberDistributionSingle) | Constructs a FloatMatrix instance from a random number generator. |
| FloatMatrix(Int32, Int32, TextReader, Char) | Constructs a FloatMatrix instance from a given text reader with a specified delimiter. |
| FloatMatrix(Int32, Int32, Single, Single) | Constructs a FloatMatrix 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. |
| FloatMatrix(Int32, Int32, Single, StorageType) | Constructs a FloatMatrix instance of the specified dimensions, initialized with the values in a given array. |
| FloatMatrix(Int32, Int32, String, Char) | Constructs a FloatMatrix instance from a formatted string with a specified delimiter. |
| FloatMatrix(Int32, Int32, FloatDataBlock, Int32, Int32) | Constructs a FloatMatrix instance from a data block with the given row and column strides. |
| FloatMatrix(Int32, Int32, TextReader, NumberStyles, Char) | Constructs a FloatMatrix instance from a given text reader with specified delimiter and styles. |
| FloatMatrix(Int32, Int32, String, NumberStyles, Char) | Constructs a FloatMatrix 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(FloatMatrix, FloatMatrix) | Adds two matrices. |
| Add(FloatMatrix, Single) | Adds a matrix and a scalar. |
| Add(Single, FloatMatrix) | Adds a scalar and a matrix. |
| Add(FloatMatrix, FloatMatrix, FloatMatrix) | Adds two matrices. |
| Add(FloatMatrix, Single, FloatMatrix) | Adds a scalar to a matrix |
| Add(Single, FloatMatrix, FloatMatrix) | Adds a scalar and a matrix. |
| Apply(FuncSingle, Single) | 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(FuncSingle, Int32, Single, 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. |
| Apply(FuncSingle, Single, Single, FloatMatrix) | 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(FuncSingle, Single, Single, Single) | 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 floating point 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(FloatMatrix, FloatMatrix) | Divide a matrix by another. |
| Divide(FloatMatrix, Single) | Divide a matrix by a scalar. |
| Divide(Single, FloatMatrix) | Divide a scalar by a matrix. |
| Divide(FloatMatrix, FloatMatrix, FloatMatrix) | Divide a matrix by another. |
| Divide(FloatMatrix, Single, FloatMatrix) | Divide a matrix by a scalar. |
| Divide(Single, FloatMatrix, FloatMatrix) | Divide a scalar by a matrix. |
| 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. |
| GetEnumerator | Creates an IEnumerator{float} out of the data elements in this matrix. |
| GetFloatEnumerator | Creates an IFloatEnumerator out of the data elements in this vector. |
| 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(FloatMatrix) | Increments each element of the given matrix. |
| Increment(Single) | Adds the specified value to each element in the 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(FloatMatrix, FloatMatrix) | Multiply two matrices. |
| Multiply(FloatMatrix, Single) | Multiply a matrix and a scalar. |
| Multiply(Single, FloatMatrix) | Multiple a scalar and a matrix. |
| Multiply(FloatMatrix, FloatMatrix, FloatMatrix) | Multiply two matrices. |
| Multiply(FloatMatrix, Single, FloatMatrix) | Multiply a matrix and a scalar. |
| Multiply(Single, FloatMatrix, FloatMatrix) | Multiply a scalar and a matrix. |
| 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(String) | Constructs a FloatMatrix instance from a formatted string. |
| Parse(TextReader) | Returns a new FloatMatrix instance from the given text reader. |
| Parse(String, NumberStyles) | Constructs a FloatMatrix instance from a formatted string and a NumberStyles object. |
| Parse(TextReader, NumberStyles) | Returns a new FloatMatrix instance from the given text reader. |
| ReadXml |
Generates a FloatMatrix instance form its XML representation.
Example
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(Single) | Sets the data elements of this vector to the specified value. |
| Set(Int32, Slice, Single) | Sets the values in the specified row and columns to the given value. |
| Set(Slice, Slice, Single) | Sets the values of the submatrix determined by the specified slices to a given value. |
| Set(Slice, Int32, Single) | 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(FloatMatrix, FloatMatrix) | Subtracts one matrix from another. |
| Subtract(FloatMatrix, Single) | Subtracts a scalar from a matrix. |
| Subtract(Single, FloatMatrix) | Subtracts a matrix from a scalar. |
| Subtract(FloatMatrix, FloatMatrix, FloatMatrix) | Subtracts one matrix from another. |
| Subtract(FloatMatrix, Single, FloatMatrix) | Subtracts a scalar from a matrix. |
| Subtract(Single, FloatMatrix, FloatMatrix) | Subtracts a matrix from a scalar. |
| ToArray | Copies data into a new 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(FuncSingle) | Modifies the elements of this matrix by applying the given no-argument function to each element. |
| Transform(FuncSingle, Single) | Modifies the elements of this matrix by applying the given unary function to each element. |
| Transform(FuncSingle, Int32, Single, 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. |
| Transform(FuncSingle, Single, Single, FloatMatrix) | 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(FuncSingle, Single, Single, Single) | 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 floating point 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.
Example
The matrix:
| 1 2 3 |
| 4 5 6 |
| 7 8 9 |
would be serialized as:
|
Operators| Name | Description | |
|---|---|---|
 | Addition(FloatMatrix, FloatMatrix) | Adds two matrices. |
| Addition(FloatMatrix, Single) | Adds a matrix and a scalar. |
| Addition(Single, FloatMatrix) | Adds a scalar and a matrix. |
| Decrement(FloatMatrix) | Decrements each element of the input matrix. |
| Division(FloatMatrix, FloatMatrix) | Divide a matrix by another. |
| Division(FloatMatrix, Single) | Divide a matrix by a scalar. |
| Division(Single, FloatMatrix) | Divide a scalar by a matrix. |
| Equality(FloatMatrix, FloatMatrix) | Tests for equality of two matrices. Two matrices are equal if they have the same dimensions and all values are equal. |
| Increment(FloatMatrix) | Increments each element of the given matrix. |
| Inequality(FloatMatrix, FloatMatrix) | Tests for inequality of two matrices. Two matrices are not equal if they have different dimensions or their values are not all equal. |
| Multiply(FloatMatrix, FloatMatrix) | Multiple two matrices. |
| Multiply(FloatMatrix, Single) | Multiply a matrix and a scalar. |
| Multiply(Single, FloatMatrix) | Multiple a scalar and a matrix. |
| Subtraction(FloatMatrix, FloatMatrix) | Subtracts one matrix from another. |
| Subtraction(FloatMatrix, Single) | Subtracts a scalar from a matrix. |
| Subtraction(Single, FloatMatrix) | Subtracts a matrix from a scalar. |
| UnaryNegation(FloatMatrix) | Negation operator. |
| UnaryPlus(FloatMatrix) | 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