csharpfftfsharpintegrationinterpolationlinear-algebramathdifferentiationmatrixnumericsrandomregressionstatisticsmathnet
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
248 lines
15 KiB
248 lines
15 KiB
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8"/>
|
|
<title>MATLAB Level-5 Mat Files
|
|
</title>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
|
|
<meta name="description" content="Math.NET Numerics, providing methods and algorithms for numerical computations in science, engineering and every day use. .Net 4, .Net 3.5, SL5, Win8, WP8, PCL 47 and 136, Mono, Xamarin Android/iOS."/>
|
|
<meta name="author" content="Christoph Ruegg, Marcus Cuda, Jurgen Van Gael"/>
|
|
|
|
<script src="https://code.jquery.com/jquery-1.8.0.js"></script>
|
|
<script src="https://code.jquery.com/ui/1.8.23/jquery-ui.js"></script>
|
|
<script src="https://netdna.bootstrapcdn.com/twitter-bootstrap/2.2.1/js/bootstrap.min.js"></script>
|
|
<link href="https://netdna.bootstrapcdn.com/twitter-bootstrap/2.2.1/css/bootstrap-combined.min.css" rel="stylesheet"/>
|
|
|
|
<link type="text/css" rel="stylesheet" href="https://numerics.mathdotnet.com/content/style.css" />
|
|
<style>
|
|
#main table:not(.pre) {
|
|
border: 1px solid #dddddd;
|
|
max-width: 100%;
|
|
border-style: solid;
|
|
border-width: 1px;
|
|
border-color: gray;
|
|
border-collapse: collapse;
|
|
border-right-width: 1px;
|
|
border-bottom-width: 1px;
|
|
margin-top: 15px;
|
|
margin-bottom: 25px;
|
|
}
|
|
#main table:not(.pre) th, #main table:not(.pre) td {
|
|
border: 1px solid #dddddd;
|
|
padding: 6px;
|
|
}
|
|
#main table:not(.pre) th p, #main table:not(.pre) td p {
|
|
margin-bottom: 5px;
|
|
}
|
|
</style>
|
|
<script type="text/javascript" src="https://numerics.mathdotnet.com/content/tips.js"></script>
|
|
<!-- HTML5 shim, for IE6-8 support of HTML5 elements -->
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
|
|
<![endif]-->
|
|
|
|
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div class="masthead">
|
|
<ul class="nav nav-pills pull-right">
|
|
<li><a href="https://www.mathdotnet.com">Math.NET Project</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com">Math.NET Numerics</a></li>
|
|
<li><a href="https://github.com/mathnet/mathnet-numerics">GitHub</a></li>
|
|
</ul>
|
|
<h3 class="muted">Math.NET Numerics</h3>
|
|
</div>
|
|
<hr />
|
|
<div class="row">
|
|
<div class="span9" id="main">
|
|
|
|
<h1><a name="MATLAB-Level-5-Mat-Files" class="anchor" href="#MATLAB-Level-5-Mat-Files">MATLAB Level-5 Mat Files</a></h1>
|
|
<p>Level-5 MATLAB Mat files are popular as binary file container for storing one or more matrices.
|
|
Math.NET Numerics provides basic support for such Mat files with the <strong>MathNet.Numerics.Data.Matlab</strong> package,
|
|
which is available on NuGet as separate package and not included in the basic distribution.</p>
|
|
<h2><a name="Reading-matrices-from-a-MATLAB-file" class="anchor" href="#Reading-matrices-from-a-MATLAB-file">Reading matrices from a MATLAB file</a></h2>
|
|
<p>The <code>MatlabReader</code> class provides static functions to list all matrices stored in a MAT file or stream,
|
|
and to read them individually as Math.NET matrices:</p>
|
|
<table class="pre"><tr><td class="lines"><pre class="fssnip"><span class="l"> 1: </span>
|
|
<span class="l"> 2: </span>
|
|
<span class="l"> 3: </span>
|
|
<span class="l"> 4: </span>
|
|
<span class="l"> 5: </span>
|
|
<span class="l"> 6: </span>
|
|
<span class="l"> 7: </span>
|
|
<span class="l"> 8: </span>
|
|
<span class="l"> 9: </span>
|
|
<span class="l">10: </span>
|
|
<span class="l">11: </span>
|
|
<span class="l">12: </span>
|
|
<span class="l">13: </span>
|
|
<span class="l">14: </span>
|
|
<span class="l">15: </span>
|
|
<span class="l">16: </span>
|
|
<span class="l">17: </span>
|
|
<span class="l">18: </span>
|
|
</pre></td>
|
|
<td class="snippet"><pre class="fssnip highlighted"><code lang="csharp"><span class="k">using</span> MathNet.Numerics.LinearAlgebra;
|
|
<span class="k">using</span> MathNet.Numerics.Data.Matlab;
|
|
|
|
<span class="c">// read the first matrix as double</span>
|
|
Matrix<<span class="k">double</span>> m <span class="o">=</span> MatlabReader.Read<<span class="k">double</span>>(<span class="s">"collection.mat"</span>);
|
|
|
|
<span class="c">// read a specific matrix named "vd":</span>
|
|
Matrix<<span class="k">double</span>> m <span class="o">=</span> MatlabReader.Read<<span class="k">double</span>>(<span class="s">"collection.mat"</span>, <span class="s">"vd"</span>);
|
|
|
|
<span class="c">// we can also choose to convert to a different type:</span>
|
|
Matrix<Complex> m <span class="o">=</span> MatlabReader.Read<Complex>(<span class="s">"collection.mat"</span>);
|
|
|
|
<span class="c">// read all matrices of a file by name into a dictionary</span>
|
|
Dictionary<<span class="k">string</span>,Matrix<<span class="k">double</span>><span class="o">></span> ms <span class="o">=</span>
|
|
MatlabReader.ReadAll<<span class="k">double</span>>(<span class="s">"collection.mat"</span>);
|
|
|
|
<span class="c">// read the matrices named "Ad" and "vd" into a dictionary</span>
|
|
<span class="k">var</span> ms <span class="o">=</span> MatlabReader.ReadAll<<span class="k">double</span>>(<span class="s">"collection.mat"</span>, <span class="s">"vd"</span>, <span class="s">"Ad"</span>);
|
|
</code></pre></td></tr></table>
|
|
<p>Alternatively the reader can list all matrices of a file into named data elements,
|
|
which can then be read into matrices individually. This is useful e.g. if we need to
|
|
read some of the matrices to a different type:</p>
|
|
<table class="pre"><tr><td class="lines"><pre class="fssnip"><span class="l">1: </span>
|
|
<span class="l">2: </span>
|
|
<span class="l">3: </span>
|
|
</pre></td>
|
|
<td class="snippet"><pre class="fssnip highlighted"><code lang="csharp">List<MatlabMatrix> ms <span class="o">=</span> MatlabReader.List(<span class="s">"collection.mat"</span>);
|
|
Matrix<<span class="k">double</span>> Ad <span class="o">=</span> MatlabReader.Unpack<<span class="k">double</span>>(ms.Find(m <span class="o">=</span><span class="o">></span> m.Name <span class="o">=</span><span class="o">=</span> <span class="s">"Ad"</span>));
|
|
Matrix<<span class="k">float</span>> vd <span class="o">=</span> MatlabReader.Unpack<<span class="k">float</span>>(ms.Find(m <span class="o">=</span><span class="o">></span> m.Name <span class="o">=</span><span class="o">=</span> <span class="s">"vd"</span>));
|
|
</code></pre></td></tr></table>
|
|
<h2><a name="Writing-matrices-to-a-MATLAB-file" class="anchor" href="#Writing-matrices-to-a-MATLAB-file">Writing matrices to a MATLAB file</a></h2>
|
|
<p>The dual to the reader above is the <code>MatlabWriter</code> class that can serialize matrices
|
|
to a MATLAB file or stream. Like the reader, the writer can use <code>MatlabMatrix</code> data elements
|
|
to compose packed matrices into a file. Each matrix has a name which must not contain spaces.</p>
|
|
<table class="pre"><tr><td class="lines"><pre class="fssnip"><span class="l">1: </span>
|
|
<span class="l">2: </span>
|
|
<span class="l">3: </span>
|
|
<span class="l">4: </span>
|
|
</pre></td>
|
|
<td class="snippet"><pre class="fssnip highlighted"><code lang="csharp"><span class="k">var</span> matrices <span class="o">=</span> <span class="k">new</span> List<MatlabMatrix>();
|
|
m.Add(MatlabWriter.Pack(myFirstMatrix, <span class="s">"m1"</span>);
|
|
m.Add(MatlabWriter.Pack(mySecondMatrix, <span class="s">"m2"</span>);
|
|
MatlabWrier.Store(<span class="s">"file.mat"</span>, matrices);
|
|
</code></pre></td></tr></table>
|
|
<p>But there are also direct routines if only a single matrix or matrices of all the same data type
|
|
are to be stored in a file:</p>
|
|
<table class="pre"><tr><td class="lines"><pre class="fssnip"><span class="l"> 1: </span>
|
|
<span class="l"> 2: </span>
|
|
<span class="l"> 3: </span>
|
|
<span class="l"> 4: </span>
|
|
<span class="l"> 5: </span>
|
|
<span class="l"> 6: </span>
|
|
<span class="l"> 7: </span>
|
|
<span class="l"> 8: </span>
|
|
<span class="l"> 9: </span>
|
|
<span class="l">10: </span>
|
|
<span class="l">11: </span>
|
|
</pre></td>
|
|
<td class="snippet"><pre class="fssnip highlighted"><code lang="csharp"><span class="c">// write a single matrix "myMatrix" and name it "m1".</span>
|
|
MatlabWriter.Write(<span class="s">"file.mat"</span>, myMatrix, <span class="s">"m1"</span>);
|
|
|
|
<span class="c">// write multiple matrices, from a list of matrices and a list of their names:</span>
|
|
MatlabWriter.Write(<span class="s">"file.mat"</span>, <span class="k">new</span>[] { m<span class="n">1</span>, m<span class="n">2</span> }, <span class="k">new</span>[] { <span class="s">"m1"</span>, <span class="s">"m2"</span> });
|
|
|
|
<span class="c">// write a dictionary of matrices:</span>
|
|
<span class="k">var</span> dict <span class="o">=</span> <span class="k">new</span> Dictionary<<span class="k">string</span>, Matrix<<span class="k">double</span>><span class="o">></span>();
|
|
dict.Add(<span class="s">"m1"</span>, m<span class="n">1</span>);
|
|
dict.Add(<span class="s">"m2"</span>, m<span class="n">2</span>);
|
|
MatlabWriter.Write(<span class="s">"file.mat"</span>, dict);
|
|
</code></pre></td></tr></table>
|
|
<h2><a name="Alternatives" class="anchor" href="#Alternatives">Alternatives</a></h2>
|
|
<p>The data extension packages also offer other ways to serialize a matrix to a text file.
|
|
Among others:</p>
|
|
<ul>
|
|
<li><a href="CSV.html">Delimited Text Files (CSV & TSV)</a></li>
|
|
<li><a href="MatrixMarket.html">NIST MatrixMarket text files</a></li>
|
|
</ul>
|
|
|
|
|
|
</div>
|
|
<div class="span3">
|
|
<ul class="nav nav-list" id="menu">
|
|
|
|
<li class="nav-header">Math.NET Numerics</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Packages.html">NuGet & Binaries</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/ReleaseNotes.html">Release Notes</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/License.html">MIT/X11 License</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Compatibility.html">Platform Support</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/api/">Class Reference</a></li>
|
|
<li><a href="https://github.com/mathnet/mathnet-numerics/issues">Issues & Bugs</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Users.html">Who is using Math.NET?</a></li>
|
|
|
|
<li class="nav-header">Contributing</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Contributors.html">Contributors</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Contributing.html">Contributing</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Build.html">Build & Tools</a></li>
|
|
<li><a href="http://feedback.mathdotnet.com/forums/2060-math-net-numerics">Your Ideas</a></li>
|
|
|
|
<li class="nav-header">Getting Help</li>
|
|
<li><a href="https://discuss.mathdotnet.com/c/numerics">Discuss</a></li>
|
|
<li><a href="https://stackoverflow.com/questions/tagged/mathdotnet">Stack Overflow</a></li>
|
|
|
|
<li class="nav-header">Getting Started</li>
|
|
<li><a href="https://numerics.mathdotnet.com/">Getting started</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Constants.html">Constants</a></li>
|
|
<li>Floating-Point Numbers</li>
|
|
<li>Arbitrary Precision Numbers</li>
|
|
<li>Complex Numbers</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Matrix.html">Matrices and Vectors</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Euclid.html">Euclid & Number Theory</a></li>
|
|
<li>Combinatorics</li>
|
|
|
|
<li class="nav-header">Evaluation</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Functions.html">Special Functions</a></li>
|
|
<li>Differentiation</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Integration.html">Integration</a></li>
|
|
|
|
<li class="nav-header">Statistics/Probability</li>
|
|
<li><a href="https://numerics.mathdotnet.com/DescriptiveStatistics.html">Descriptive Statistics</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Probability.html">Probability Distributions</a></li>
|
|
|
|
<li class="nav-header">Generation</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Generate.html">Generating Data</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/Random.html">Random Numbers</a></li>
|
|
|
|
<li class="nav-header">Transformation</li>
|
|
<li>Fourier Transform (FFT)</li>
|
|
<li>Filtering & DSP</li>
|
|
<li>Window Functions</li>
|
|
|
|
<li class="nav-header">Solving Equations</li>
|
|
<li><a href="https://numerics.mathdotnet.com/LinearEquations.html">Linear Equation Systems</a></li>
|
|
<li>Nonlinear Root Finding</li>
|
|
|
|
<li class="nav-header">Optimization</li>
|
|
<li>Linear Least Squares</li>
|
|
<li>Nonlinear Optimization</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Distance.html">Distance Metrics</a></li>
|
|
|
|
<li class="nav-header">Curve Fitting</li>
|
|
<li><a href="https://numerics.mathdotnet.com/Regression.html">Regression</a></li>
|
|
<li>Interpolation</li>
|
|
<li>Fourier Approximation</li>
|
|
|
|
<li class="nav-header">Native Providers</li>
|
|
<li><a href="https://numerics.mathdotnet.com/MKL.html">Intel MKL</a></li>
|
|
|
|
<li class="nav-header">Working Together</li>
|
|
<li><a href="https://numerics.mathdotnet.com/CSV.html">Delimited Text Files (CSV)</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/MatrixMarket.html">NIST MatrixMarket</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/MatlabFiles.html">MATLAB</a></li>
|
|
<li><a href="https://numerics.mathdotnet.com/IFSharpNotebook.html">IF# Notebook</a></li>
|
|
<li>FsLab & Deedle</li>
|
|
<li>Microsoft Excel</li>
|
|
<li>numl.net machine learning</li>
|
|
<li>R-project</li>
|
|
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
|