GoesSoftware.SuperSDK.Plot 7.14.3

SuperSDK.Plot

GoesSoftware.SuperSDK.Plot · v1.0.0 · .NET 9 · Avalonia 11

SuperSDK.Plot 是 SuperSDK 生态的绘图与 SPC 分析 UI 组件库，提供四类即插即用图表控件，每个控件同时支持直接 API 调用和 GzMessage 消息驱动两种数据注入方式。

安装

通过 NuGet 包引用：

<PackageReference Include="GoesSoftware.SuperSDK.Plot" Version="1.0.0" />

初始化（必须）

在应用 Program.cs 或启动入口的 SuperApp.Initialize() 配置块中注册 Plot 库的托管 UI：

using SuperSDK.App;
using SuperSDK.Plot.UI.CurveDraw;
using SuperSDK.Plot.UI.HistogramChart;
using SuperSDK.Plot.UI.IndividualChart;
using SuperSDK.Plot.UI.MovingRangeChart;

SuperApp.Initialize(app =>
{
    // 注册需要用到的图表窗口（GzWindow 托管，关闭隐藏而非销毁）
    app.AddManagedUI<GzCurveDrawWindow>();
    app.AddManagedUI<GzHistogramChartSettingsWindow>();
    app.AddManagedUI<GzIndividualChartSettingsWindow>();
    app.AddManagedUI<GzMovingRangeChartSettingsWindow>();
});

只注册需要使用的窗口即可，未使用的可以省略。

文件夹结构

SuperSDK.Plot/
  UI/
    CurveDraw/          曲线绘制（View + Window）
    HistogramChart/     直方图（View + SettingsWindow）
    IndividualChart/    个值图 X-Chart（View + SettingsWindow）
    MovingRangeChart/   移动极差图（View + SettingsWindow）
  Messages/             所有 GzMessage 定义
  Models/               图表设置数据模型

一、CurveDraw — 曲线绘制

1.1 GzCurveDrawView（嵌入式 UserControl）

在 AXAML 中直接嵌入：

xmlns:plot="clr-namespace:SuperSDK.Plot.UI.CurveDraw;assembly=SuperSDK.Plot"

<plot:GzCurveDrawView WindowId="chart1"/>

1.2 GzCurveDrawWindow（独立弹窗）

继承 GzWindow，支持侧边曲线列表（切换可见性 / 删除单条曲线）。

var win = SuperApp.GetManagedUI<GzCurveDrawWindow>();
win.WindowId = "chart1";
win.Show();

// 直接 API
win.AddCurve("温度", color: "#FF5722", lineWidth: 1.5, showMarkers: false);
win.AppendCurveData("温度", yValues: new[] { 25.1, 25.3, 25.0 });
win.HideCurve("温度", hidden: true);
win.DeleteCurve("温度");
win.ClearCurves();

1.3 消息驱动

PlotCurveDataReady — 一次性批量设置多条曲线

MBus.Pub(new PlotCurveDataReady
{
    Title = "实时监控",
    XLabel = "时间(s)",
    YLabel = "温度(℃)",
    Append = false,   // true = 追加模式，false = 清空重绘
    Series = new List<PlotCurveSeries>
    {
        new() { Name = "通道1", YValues = data1, Color = "#FF5722" },
        new() { Name = "通道2", YValues = data2, Color = "#2196F3" },
    }
});

PlotAddCurve — 动态添加单条曲线

MBus.Pub(new PlotAddCurve
{
    Name        = "压力",
    Color       = "#9C27B0",
    LineWidth   = 2.0,
    ShowMarkers = true,
    WindowId    = "chart1"   // 省略则广播到所有实例
});

PlotAppendCurveData — 追加数据点

MBus.Pub(new PlotAppendCurveData
{
    CurveName = "压力",
    YValues   = new[] { 1.02, 1.05, 0.98 },
    WindowId  = "chart1"
});

PlotHideCurve — 显示 / 隐藏

MBus.Pub(new PlotHideCurve { CurveName = "压力", Hidden = true, WindowId = "chart1" });

PlotDeleteCurve — 删除曲线

MBus.Pub(new PlotDeleteCurve("压力") { WindowId = "chart1" });

PlotClearCurves — 清空全部曲线

MBus.Pub(new PlotClearCurves());

二、HistogramChart — 直方图

2.1 GzHistogramChartView（嵌入式 UserControl）

xmlns:plot="clr-namespace:SuperSDK.Plot.UI.HistogramChart;assembly=SuperSDK.Plot"

<plot:GzHistogramChartView x:Name="HistChart" WindowId="hist1"/>

直接 API：

HistChart.SetData(
    title:   "工序A 直方图",
    counts:  new double[] { 2, 8, 15, 20, 18, 12, 5 },
    binEdges: new double[] { 9.5, 10.0, 10.5, 11.0, 11.5, 12.0, 12.5, 13.0 },
    mean:    11.2,
    usl:     12.5,
    lsl:     9.5
);

2.2 消息驱动 — PlotSetHistogramData

MBus.Pub(new PlotSetHistogramData
{
    Title          = "工序A 直方图",
    HistogramCounts = new double[] { 2, 8, 15, 20, 18, 12, 5 },
    BinEdges       = new double[] { 9.5, 10.0, 10.5, 11.0, 11.5, 12.0, 12.5, 13.0 },
    Mean           = 11.2,
    USL            = 12.5,
    LSL            = 9.5,
    WindowId       = "hist1"   // 省略则广播到所有实例
});

三、IndividualChart — 个值图（X-Chart）

3.1 GzIndividualChartView（嵌入式 UserControl）

xmlns:plot="clr-namespace:SuperSDK.Plot.UI.IndividualChart;assembly=SuperSDK.Plot"

<plot:GzIndividualChartView x:Name="XChart" WindowId="xchart1"/>

直接 API：

XChart.SetData(
    title:    "尺寸 X",
    values:   new double[] { 10.1, 10.3, 9.9, 10.2, 10.4 },
    mean:     10.18,
    ucl:      10.62,
    lcl:       9.74,
    usl:      10.8,
    lsl:       9.6,
    itemName: "直径(mm)"
);

3.2 消息驱动 — PlotSetIndividualData

MBus.Pub(new PlotSetIndividualData
{
    Title    = "尺寸 X",
    ItemName = "直径(mm)",
    Values   = new double[] { 10.1, 10.3, 9.9, 10.2, 10.4 },
    Mean     = 10.18,
    UCL      = 10.62,
    LCL      =  9.74,
    USL      = 10.8,
    LSL      =  9.6,
    WindowId = "xchart1"
});

四、MovingRangeChart — 移动极差图（MR-Chart）

4.1 GzMovingRangeChartView（嵌入式 UserControl）

xmlns:plot="clr-namespace:SuperSDK.Plot.UI.MovingRangeChart;assembly=SuperSDK.Plot"

<plot:GzMovingRangeChartView x:Name="MrChart" WindowId="mr1"/>

直接 API：

MrChart.SetData(
    title:        "移动极差",
    movingRanges: new double[] { 0.2, 0.4, 0.3, 0.2, 0.5 },
    mrMean:       0.32,
    mrUCL:        1.05
);

4.2 消息驱动 — PlotSetMovingRangeData

MBus.Pub(new PlotSetMovingRangeData
{
    Title        = "移动极差",
    MovingRanges = new double[] { 0.2, 0.4, 0.3, 0.2, 0.5 },
    MrMean       = 0.32,
    MrUCL        = 1.05,
    WindowId     = "mr1"
});

消息汇总

WindowId 路由规则：消息的 WindowId 为 null 时广播到所有匹配类型的实例；非空时仅路由到 WindowId 相同的控件实例。

多实例示例

同一页面放多个独立的曲线图：

<plot:GzCurveDrawView WindowId="pressure" />
<plot:GzCurveDrawView WindowId="temperature" />

// 只给压力图追加数据
MBus.Pub(new PlotAppendCurveData { CurveName = "P1", YValues = pressureData, WindowId = "pressure" });

// 只给温度图追加数据
MBus.Pub(new PlotAppendCurveData { CurveName = "T1", YValues = tempData,     WindowId = "temperature" });

// 广播幸一两个图同时清空（WindowId 省略时）
MBus.Pub(new PlotClearCurves());

数据模型（Models）

PlotIndividualChartSettings

PlotMovingRangeChartSettings

PlotHistogramChartSettings

PlotCurveDrawSettings（数据库实体）

DatabaseName = "PlotSettings"，TableName = "CurveDrawSettings"，存储在 PlotSettings.db。

数据持久化（可选）

PlotCurveDrawSettings 实现了 IEntity / IDatabaseEntity / ITableEntity 接口，可通过 SuperSDK.Data 持久化曲线图表的用户设置。

注册步骤

在应用启动时（Program.cs 或 SuperApp.Initialize 之后、DbContextFactory.EnsureInitialized() 之前）注册：

using SuperSDK.Data;
using SuperSDK.Plot.Models;

// 注册 CurveDraw 设置实体（如需持久化图表配置则添加此行）
DbContextFactory.RegisterEntity<PlotCurveDrawSettings>();

// 初始化所有已注册实体
DbContextFactory.EnsureInitialized();

读写示例

using SuperSDK.Data;
using SuperSDK.Plot.Models;

// 加载指定 WindowId 的设置（不存在时返回 null）
var saved = EntityStore.FindFirst<PlotCurveDrawSettings>(s => s.WindowId == "chart1");

// 保存 / 更新
if (saved == null)
    EntityStore.Insert(new PlotCurveDrawSettings { WindowId = "chart1", Title = "实时监控" });
else
{
    saved.Title = "实时监控";
    EntityStore.Update(saved);
}

如果应用无需持久化图表配置，可以跳过本节，CurveDraw 控件仍可正常使用（设置仅在内存中有效）。

所有图表控件自动跟随 SuperSDK.UI.ThemeManager 的明暗主题切换，无需额外配置。

依赖