TINS.Graphics.Avalonia 2.0.0

TINS-Library

Neuroscience data analysis framework for EEG/electrophysiology research — matrix algebra, signal processing, frequency-domain analysis, and cross-platform visualization.

Packages

dotnet add package TINS.Core
dotnet add package TINS.Graphics
dotnet add package TINS.Graphics.Avalonia

TINS.Graphics.WPF, TINS.Graphics.WinForms, and TINS.Visualization exist in this repo but aren't published yet (all three require a Windows host to build — see .github/workflows/ci.yml).

See API.md for the full API reference, split by package.

Quick plots: Figure.Show

With TINS.Graphics.Avalonia referenced, Figure.Show opens a plot window from an ordinary console program, the way plt.show() does in Python: no app setup, it blocks until the window is closed, and you can call it again afterwards.

using TINS;
using TINS.Graphics;
using TINS.Graphics.Avalonia;
using TINS.Graphics.Impl;     // the Lines/Scatters/... convenience extensions

class Program
{
    static void Main()
    {
        var plt = new Plotter();
        plt.GetAxisRect().Lines(Signals.Sine(40, 1000, 1000));
        Figure.Show(plt, "My signal");     // returns when the window is closed
    }
}

Figure.Plot2D(...) does the same for a heatmap of a Matrix<float> or spectrum result.

Threading rules

On macOS, Avalonia must own the main thread. If you need ShowAsync, or want to call Show from a background thread, wrap your program once; this form works on every platform:

FigureApp.Run(() =>
{
    // your code here, on a background thread
    Figure.Show(plt);
});

Other things to know:

• Don't touch Avalonia UI objects before the first Show, and don't expect to restart the figure context after FigureApp.ShutdownContext(): Avalonia allows one application per process.
• To update a plot that is on screen from another thread, use Graph.SetData/AddData (thread-safe), and wrap any other change (axis ranges, other plottable types) in lock (plotter.SyncRoot) { ... }. On macOS, code that runs while Show blocks must go through the dispatcher or a timer.

See the Platform Controls section of docs/API-Graphics.md for the full reference.

Platform support

TINS.Core no longer bundles any native binaries of its own. Some functionality depends on FFTW and OpenBLAS, provided by a separate NuGet package per platform from tins-lib-native — add whichever RID(s) your project targets alongside TINS.Core:

Everything else — containers, matrix/vector algebra, statistics, non-multitaper signal generation, data I/O — is pure managed code and portable. SingularValueDecomposition/PrincipalComponentAnalysis (via OpenBLAS.SGESVD) and multitaper spectral/coherence analysis (SpikeSpectrumAnalyzer, SpikeFieldCoherenceMT, via a managed DPSS implementation) no longer depend on a dedicated native library — only FFTW/OpenBLAS themselves do. Using an FFTW- or OpenBLAS-backed feature without the matching TINS.Native.<rid> package referenced will throw DllNotFoundException at first call.