如何在MATLAB中为同一图形添加多个图例？

Question

在MATLAB绘图时，如何为同一图形中的不同数据组或图形元素添加多个独立图例？默认情况下，`legend()` 函数仅创建一个图例对象，难以对多组曲线（如来自不同坐标轴或子图区域）进行分组标注。常见问题包括：多个 `legend` 命令覆盖前一个图例、图例项混淆不清、或无法精确定位多个图例位置。尤其是在叠加绘制来自不同数据源的曲线（如双y轴绘图或使用 `hold on` 的复合图形）时，用户常希望分别标注每组曲线。如何利用句柄控制、透明背景设置及定位技巧，在不相互干扰的前提下实现多个图例共存？这是提升图表可读性的关键挑战。

Answer 1

一、MATLAB中实现多图例共存的深度解析

1. 问题背景与核心挑战

在MATLAB绘图过程中，legend() 函数默认行为是创建单一图例对象，并替换已存在的图例。当用户使用 hold on 叠加多组数据或构建双y轴图形（如 yyaxis 或 plotyy）时，频繁调用 legend() 将导致前一个图例被覆盖，造成信息丢失。

更复杂的情况出现在子图（subplot）共享坐标轴或需要对不同数据源进行语义分组标注时。例如：一组表示温度变化的曲线和另一组表示压力波动的曲线在同一图中绘制，理想情况下应分别标注为“温度系列”和“压力系列”，而非混在一起。

2. 基础机制：理解图例的句柄控制

在MATLAB中，每个图形元素都有其对应的句柄（Handle），图例也不例外。通过显式获取和操作图例句柄，可以避免自动覆盖问题。

% 示例：基础句柄控制
x = 0:0.1:2*pi;
y1 = sin(x); y2 = cos(x); y3 = tan(x);

h1 = plot(x, y1, 'r-', 'DisplayName', 'sin(x)');
hold on;
h2 = plot(x, y2, 'b--', 'DisplayName', 'cos(x)');
h3 = plot(x, y3, 'g:', 'DisplayName', 'tan(x)');

% 创建第一个图例（仅包含前两个曲线）
leg1 = legend([h1, h2], 'Location', 'northeast');
leg1.Box = 'off';
leg1.BackgroundColor = [1 1 1 0.7]; % 半透明背景

% 创建第二个图例（单独标注tan函数）
leg2 = legend(h3, 'Location', 'southeast');
leg2.Box = 'on';
leg2.EdgeColor = 'g';
leg2.BackgroundColor = 'none'; % 透明背景
    

上述代码展示了如何通过指定句柄数组来限制图例项范围，并独立设置样式属性。

3. 高级技巧：利用父子关系与UI容器分离图例

MATLAB允许将图例作为独立的uipanel或axes子对象进行管理。这在处理多个逻辑分组时尤为有效。

• 使用 hgtransform 容器隔离图例作用域
• 借助 uistack 控制图层顺序
• 通过 Position 属性手动精确定位图例位置

方法	适用场景	是否支持透明背景	是否可重定位	是否支持句柄过滤
单次legend调用	简单曲线组	否	受限	否
多次legend + 句柄指定	双y轴/复合图	是	是	是
uipanel嵌套图例	仪表板式布局	是	高度灵活	是
自定义annotation对象	出版级图表	是	极灵活	需编程实现
subplot分区图例	多区域可视化	是	固定	部分
yyaxis + 分离legend	双变量对比	是	是	是
patch+text模拟图例	完全定制化	是	任意	全控
LegendGroup类扩展	大型项目封装	是	是	是
App Designer动态图例	交互式应用	是	动态调整	是
Export Graphics优化输出	论文发表	是	保持原样	依赖前端

4. 实战案例：双y轴图中的独立图例管理

考虑如下典型工程场景：左侧y轴显示电机转速（rpm），右侧y轴显示电流（A），两者时间同步但量纲不同。

figure;
[ax, h1, h2] = plotyy(1:10, rand(1,10)*3000, 1:10, rand(1,10)*50, ...
    @(x,y)plot(x,y,'ro-'), @(x,y)plot(x,y,'bs-'));

% 设置左侧图例
leg_left = legend(ax(1), h1, 'Motor Speed', 'Location', 'NorthOutside');
leg_left.FontSize = 10;
leg_left.BackgroundColor = [1 1 1 0.8];

% 设置右侧图例
leg_right = legend(ax(2), h2, 'Current', 'Location', 'SouthOutside');
leg_right.FontSize = 10;
leg_right.Color = [1 1 1 0];
leg_right.Box = 'off';

% 调整图例位置避免重叠
pos_left = leg_left.Position;
pos_right = leg_right.Position;
pos_right(1) = pos_left(1) + pos_left(3) + 0.02; % 水平偏移
leg_right.Position = pos_right;
    

5. 流程图：多图例生成决策路径

graph TD
            A[开始绘图] --> B{是否有多组语义分离的数据?}
            B -- 是 --> C[确定每组数据的图形句柄]
            B -- 否 --> D[使用单一legend即可]
            C --> E{是否使用双y轴?}
            E -- 是 --> F[使用plotyy或yyaxis获取双轴句柄]
            E -- 否 --> G[使用hold on叠加曲线]
            F --> H[分别为左右轴创建独立legend]
            G --> I[按句柄分组调用legend]
            H --> J[设置图例位置与背景透明度]
            I --> J
            J --> K[使用uistack或Position微调布局]
            K --> L[输出高质量图像]

6. 性能与可维护性考量

对于长期维护的工程项目，建议将多图例逻辑封装成函数或类方法。以下为推荐的设计模式：

function addIndependentLegend(handles, labels, location, bgColor)
% ADDINDEPENDENTLEGEND 添加一个不干扰其他图例的独立图例
    lg = legend(handles, labels, 'Location', location);
    lg.BackgroundColor = bgColor;
    lg.Interpreter = 'latex';
    uistack(lg, 'top'); % 确保图例可见
end
    

该模式提升了代码复用性和一致性，尤其适用于自动化报告生成系统。