MatPlotLibNet 1.4.0

MatPlotLibNet

A .NET 10 / .NET 8 charting library inspired by matplotlib. Fluent API, dependency injection, parallel SVG rendering, polymorphic export (SVG / PNG / PDF / GIF), and multi-platform output to Blazor, MAUI, Avalonia, Uno Platform, ASP.NET Core, Angular, React, and Vue.

v1.4.0 — Streaming & Realtime. First-class live data support for dashboards and telemetry:

1. Streaming series — four new series types (StreamingLineSeries, StreamingScatterSeries, StreamingSignalSeries, StreamingCandlestickSeries) backed by DoubleRingBuffer with AppendPoint(x, y) / AppendBar(o, h, l, c). Thread-safe snapshot pattern for render isolation. Series count: 70 → 74.
2. StreamingFigure — wraps Figure with render throttling (configurable 16ms–1000ms), data version tracking, and auto-scaling axes via AxisScaleMode (Fixed, AutoScale, SlidingWindow, StickyRight). BuildStreaming() on the fluent builder.
3. 11 streaming indicators — StreamingSma, StreamingEma, StreamingRsi, StreamingBollinger, StreamingMacd, StreamingObv, StreamingAtr, StreamingStochastic, StreamingWilliamsR, StreamingCci, StreamingVwap. All O(1) per append, auto-attach to candlestick via BarAppended event.
4. 5 platform streaming controls — MplStreamingChartControl (Avalonia), MplStreamingChartElement (Uno), MplStreamingChartView (MAUI), MplStreamingChart (Blazor), StreamingChartSession (ASP.NET Core server push).
5. SVG diff engine + Rx IObservable<T> adapter for bandwidth optimization and reactive pipelines.

4 183 tests green across 11 test projects.

For earlier releases, see the full CHANGELOG.

Packages

Documentation

Full documentation is on the GitHub Wiki, the Cookbook (runnable examples with rendered images), and the API Reference (generated from XML doc comments):

• Playground — try charts live in the browser — pick an example, tweak parameters, see the SVG update instantly
• Cookbook — copy-paste code examples with rendered output for every chart type
• API Reference — full API documentation from source
• Getting Started — installation, output formats, subplots
• Fluent Cheatsheet — one-page reference for Plt / FigureBuilder / AxesBuilder
• Package Map — all 11 NuGet + 3 npm packages in detail
• Chart Types — all 74 series with code examples
• Streaming & Realtime — ring buffers, StreamingFigure, axis scaling, 11 streaming indicators, platform controls
• Interactive Controls — Avalonia + Uno native controls, managed interaction layer
• Bidirectional SignalR — server-authoritative interactive charts, event hierarchy, hub wiring
• DataFrame — indicators, polynomial regression from Microsoft.Data.Analysis.DataFrame
• Notebooks — Polyglot Notebooks + Jupyter inline rendering
• Styling — themes, colormaps, PropCycler
• Accessibility — SVG semantics, keyboard navigation, color-blind palette
• Advanced — date axes, math text, animations, GIF, real-time
• Benchmarks — SVG rendering, SIMD transforms, indicators
• Roadmap — version history and planned phases
• Contributing — build, test, coding conventions

Quick start

using MatPlotLibNet;
using MatPlotLibNet.Styling;

double[] x = [1, 2, 3, 4, 5];
double[] y = [2, 4, 3, 5, 1];

Plt.Create()
    .WithTitle("My First Chart")
    .WithTheme(Theme.Dark)
    .Plot(x, y, s => { s.Color = Color.Blue; s.Label = "Data"; })
    .WithLegend()
    .Save("chart.svg");

Features

74 series types — line, scatter, bar, histogram, pie, box, violin, heatmap, contour, candlestick, OHLC, treemap, sunburst, Sankey, polar, polar heatmap, 3D surface, Bar3D, PlanarBar3D, Line3D, Trisurf3D, Contour3D, Quiver3D, Voxels, Text3D, radar, waterfall, funnel, gauge, streaming line/scatter/signal/candlestick, and more.

Native UI controls — MplChartControl for Avalonia 12 and MplChartElement for Uno Platform render charts natively via SkiaSharp — no browser, no WebView, no SignalR required. Set IsInteractive="True" for local pan / zoom / reset / brush-select. Connect to a SignalR hub with .WithServerInteraction(hubConnection) for server-authoritative mode.

MathText — LaTeX-like inline math in any label or title: $\alpha^{2}$, $\frac{a}{b}$, $\sqrt{x}$, $\hat{x}$, $\mathbf{F}$, $\mathbb{R}$. 96 symbol mappings (Greek, math operators, arrows, relations, set/logic, blackboard bold), fractions, square roots, accents, font variants, spacing, and scaling delimiters.

3-D charts — 12 series types: Surface, Scatter3D, Bar3D, PlanarBar3D, Line3D, Trisurf3D (Delaunay), Contour3D (marching squares), Quiver3D (vector field), Voxels (face-culled cubes), Text3D (annotations). Full Projection3D pipeline, DepthQueue3D painter's algorithm, LightingHelper shading, and Svg3DRotationScript client-side rotation.

Streaming & Realtime — StreamingLineSeries, StreamingScatterSeries, StreamingSignalSeries, StreamingCandlestickSeries backed by DoubleRingBuffer with AppendPoint(x, y). StreamingFigure provides throttled re-rendering and auto-scaling axes (SlidingWindow, StickyRight, AutoScale). 11 streaming indicators (SMA, EMA, RSI, Bollinger, MACD, OBV, ATR, Stochastic, WilliamsR, CCI, VWAP) auto-attach to candlestick data. Streaming controls for Avalonia, Uno, MAUI, Blazor, and ASP.NET Core. SVG diff engine for bandwidth optimization. Rx IObservable<T> adapter.

Bidirectional SignalR — server-authoritative interactive charts with mutation events (zoom, pan, reset, legend toggle) and notification events (brush-select, hover). Stacked-record event hierarchy, natural coalescing, per-caller hover responses.

104 colormaps — viridis, plasma, turbo, coolwarm, and 100 more. NumPy-style SIMD numerics (Vec, Mat, Linalg, Fft). Accessibility (ARIA, keyboard, Okabe-Ito palette, high-contrast theme). Matplotlib look-alike themes. DataFrame integration with 16 financial indicators. Broken axes. Publication-quality SVG/PNG/PDF/GIF export.

License

MIT — free for any use, open-source or commercial, with no copyleft conditions.