Matplotlib绘制大宽度散点图时出现图形断裂异常的原因排查

问题重现 #

当调用以下代码中的plot(450, 3)时，会出现两个异常：

• 图形边框呈虚线状
• 部分散点超出边框范围
  而调用plot(5,3)、plot(100,3)时显示正常。

原代码：

from matplotlib import pyplot as plt
import numpy as np

def plot(w, h):
    num_samples = int(w * h)
    x = w * np.random.rand(num_samples)
    y = h * np.random.rand(num_samples)
    plt.figure(figsize=(w, h))
    plt.xticks(range(w))
    plt.xlim(0, w)
    plt.ylim(0, h)
    plt.scatter(x, y)
    plt.grid()

原因分析 #

这不是Matplotlib的bug，而是极端不合理的画布尺寸设置导致的渲染和布局异常：

1. 边框虚线问题：figsize=(w,h)的单位是英寸，plot(450,3)相当于创建了一个450英寸（约11.4米）宽的画布。Matplotlib的渲染引擎针对常规尺寸（几到几十英寸）优化，超大尺寸下，线条的连续渲染会因像素密度限制断裂成虚线。
2. 散点越界问题：
   • 450英寸的画布会让坐标轴布局计算的误差被放大，边框的实际位置和xlim/ylim的设置出现偏差。
   • 默认散点标记（marker）有固定大小，在超大画布上，散点的边缘会超出计算出的边框范围。
   • plt.xticks(range(w))生成了451个刻度，过度密集的刻度会进一步干扰布局计算，加剧偏差。

解决方法 #

核心思路是避免使用超大英寸尺寸的画布，改用合理尺寸配合dpi参数控制输出分辨率，同时优化刻度和散点设置：

修改后的代码示例 #

from matplotlib import pyplot as plt
import numpy as np

def plot(w, h):
    num_samples = int(w * h)
    x = w * np.random.rand(num_samples)
    y = h * np.random.rand(num_samples)
    
    # 按目标输出像素和dpi计算合理画布尺寸（单位：英寸）
    target_pixel_width = w
    dpi = 30
    fig_width = target_pixel_width / dpi  # 450像素 / 30dpi = 15英寸
    
    plt.figure(figsize=(fig_width, h), dpi=dpi)
    # 设置间隔刻度，避免过度密集
    plt.xticks(np.arange(0, w + 1, 50))
    plt.xlim(0, w)
    plt.ylim(0, h)
    # 减小散点大小，避免边缘越界
    plt.scatter(x, y, s=1)
    plt.grid()
    
    # 保存时指定dpi，保证输出像素符合预期
    plt.savefig("large_scatter_plot.png", dpi=dpi)
    plt.close()

plot(450, 3)

关键优化点 #

• 用目标像素宽度 / dpi计算画布尺寸，保证画布处于Matplotlib优化的常规尺寸范围内。
• 减少刻度数量，降低布局计算压力。
• 缩小散点标记大小，避免边缘超出坐标轴范围。

内容的提问来源于stack exchange，提问作者estebanuri