ScottPlot 在听力测试图绘制中的应用与实践

2025-06-05 18:46:50作者：滑思眉Philip

引言

ScottPlot 是一个功能强大的.NET数据可视化库，在医疗健康领域有着广泛的应用。本文将详细介绍如何使用ScottPlot绘制专业的听力测试图（audiogram），这是耳科诊断中常用的图表类型。我们将通过一个完整的实现案例，展示如何配置特殊的坐标轴、添加自定义标记以及处理医疗图表中的特殊需求。

听力测试图的特点

听力测试图是一种特殊的二维图表，具有以下典型特征：

X轴表示声音频率（Hz），采用对数刻度
Y轴表示听力阈值（dB），采用线性刻度
X轴通常位于图表顶部
需要精确控制刻度标签的位置和显示内容
需要添加辅助网格线和参考线

实现步骤

1. 基础图表配置

首先创建一个基本的ScottPlot图表，并设置坐标轴的基本属性：

ScottPlot.Plot myPlot = new();
myPlot.Axes.SetLimitsY(130, -10);  // Y轴范围从-10到130
myPlot.Axes.SetLimitsX(0.125, 12); // X轴范围从0.125到12
myPlot.Title("Frequency (kHz)");
myPlot.YLabel("Intensity (dB)");

2. 对数坐标轴处理

由于频率轴需要显示对数刻度，我们需要进行特殊处理：

// 原始频率数据（Hz）
double[] frequencies = { 125, 250, 500, 1000, 1500, 2000, 4000, 8000, 12000 };

// 转换为log2尺度
double[] logFrequencies = frequencies.Select(Math.Log2).ToArray();

// 添加数据
var sig = myPlot.Add.SignalXY(logFrequencies, leftEarData);

3. 自定义刻度标签

为了实现医疗标准的刻度显示，我们需要自定义刻度生成器：

ScottPlot.TickGenerators.NumericAutomatic tickGen = new();
tickGen.LabelFormatter = LogTickLabelFormatter;
myPlot.Axes.Top.TickGenerator = tickGen;

static string LogTickLabelFormatter(double y)
{
    switch (Math.Pow(2, y))
    {
        case 128: return "0.125";
        case 256: return "0.25";
        case 512: return "0.5";
        case 1024: return "1";
        case 2048: return "2";
        case 4096: return "4";
        case 8192: return "8";
        case 12000: return "12";
        default: return "";
    }
}

4. 坐标轴位置调整

将X轴移动到图表顶部：

sig.Axes.XAxis = myPlot.Axes.Top;
myPlot.Grid.XAxis = myPlot.Axes.Top;
myPlot.Axes.Bottom.RemoveTickGenerator();

5. 添加参考线和标记

添加听力测试图中常见的参考线和标记区域：

// 添加0dB参考线
var line = myPlot.Add.Line(0.125, 0, 12, 0);
line.LineWidth = 1;
line.LineColor = Colors.Black;

// 添加标记区域（注意坐标转换）
var rectangle = myPlot.Add.Rectangle(
    xMin: Math.Log2(500), 
    xMax: Math.Log2(4000),
    yMin: 30,
    yMax: 130
);
rectangle.FillStyle.Color = Colors.Transparent;
rectangle.LineStyle.Color = Colors.Black;