ExtensionsMathNet 0.1.0 mathnetinterop

Lodestar.Extensions.MathNet 0.1.0. This page is frozen at that release. Read the current documentation for what main says now. A link to a decision or a migration page follows main, and leaves the archive.

MathNetInterop

Converts between CsrMatrix and Math.NET Numerics' sparse matrix.

public static class MathNetInterop

Example — a matrix out of Lodestar, into Math.NET, and back.

using Lodestar.Abstractions;
using Lodestar.Extensions.MathNet;
using MathNet.Numerics.LinearAlgebra.Double;

var matrix = new CsrMatrix(
    rowCount: 2,
    columnCount: 3,
    values: [1.0, 2.0, 3.0],
    columnIndices: [0, 2, 1],
    rowPointers: [0, 2, 3]);

SparseMatrix sparse = MathNetInterop.ToSparseMatrix(matrix);
double corner = sparse[0, 2];              // => 2

CsrMatrix back = MathNetInterop.ToCsrMatrix(sparse);
int stored = back.NonZeroCount;            // => 3

Remarks — the two sides agree on the layout, so a conversion moves three arrays rather than visiting rows × columns cells. Neither result shares an array with its source: Math.NET's storage is mutable through At, and a shared buffer would let a write on one matrix move the other.

One asymmetry is worth knowing. CsrMatrix validates four things — the row pointers start at zero, do not decrease, end at the stored count, and every column index is in range — and says nothing about the order of column indices within a row, about explicit zeros, or about a column appearing twice. Math.NET reaches a cell by searching the row, which assumes the order. So MathNetInterop.ToSparseMatrix sorts each row and adds duplicate columns together, after a pass that detects the already-sorted case and copies straight through — the case every vectorizer in this repository produces. decisions/0089 records why it repairs rather than refuses.

Applies to — net10.0, netstandard2.0.

See also — the matrix conversion index, sparse matrices, matrix factorization.

Members

Member	What it does
MathNetInterop.ToCsrMatrix	Converts a Math.NET matrix into a CsrMatrix.
MathNetInterop.ToSparseMatrix	Converts a CsrMatrix into a Math.NET SparseMatrix.