ScottPlot中Heatmap的Extent与Rectangle属性对比分析

ScottPlot是一个强大的.NET绘图库，其中Heatmap（热力图）功能常用于可视化二维数据矩阵。在使用过程中，开发者可能会遇到关于热力图定位和尺寸设置的困惑，特别是Extent和Rectangle这两个属性的区别。

问题背景

在ScottPlot中，Heatmap的Extent属性用于定义热力图在坐标空间中的位置和范围。然而，许多开发者发现Extent属性的行为与直觉不符——它实际上定义的是热力图单元格的中心点范围，而非整个热力图的边界范围。

关键差异

通过对比测试可以清晰地看到两者的区别：

1. Extent属性：定义的是单元格中心点的坐标范围

   • 当设置Extent = new(-5, 5, -5, 5)时，热力图的实际显示范围会超出这个边界
   • 这是因为单元格边缘会向外延伸半个单元格的距离

2. Rectangle属性：定义的是热力图的完整边界范围

   • 设置Rectangle = new(-5, 5, -5, 5)时，热力图会精确地填充这个矩形区域
   • 这是大多数开发者期望的行为

实际效果对比

测试代码使用一个3x3的数据矩阵：

double[,] data = {
    { 1, 2, 3 },
    { 4, 5, 6 },
    { 7, 8, 9 },
};

当分别设置Extent和Rectangle为(-5,5,-5,5)时，效果差异明显：

• Extent设置时，热力图会超出-5到5的范围
• Rectangle设置时，热力图严格限制在-5到5的范围内

技术实现原理

这种差异源于热力图的两种不同定位方式：

1. 单元格中心定位：

   • 将数据点视为单元格中心
   • 单元格边缘自动向外扩展
   • 适合需要强调数据点位置的场景

2. 边界定位：

   • 将数据矩阵整体填充到指定矩形
   • 每个单元格占据矩形内的等分区域
   • 适合需要精确控制显示范围的场景

最佳实践建议

1. 如果需要热力图严格填充特定区域，应使用Rectangle属性
2. 如果需要基于数据点中心定位，可以使用Extent属性
3. 在升级到新版ScottPlot时，注意检查相关代码，将Extent替换为Rectangle以获得预期效果

理解这两种定位方式的区别，可以帮助开发者更精确地控制热力图在图表中的位置和尺寸，实现更符合需求的数据可视化效果。