binscatter

分 bin 散点图

全页折叠

语法

binscatter(x,y)

binscatter(x,y,N)

binscatter(___,Name,Value)

binscatter(ax,___)

h = binscatter(___)

说明

binscatter(x,y) 显示向量 x 和 y 的分 bin 散点图。分 bin 散点图将数据空间分成多个矩形 bin，并用不同颜色显示每个 bin 中的数据点数。放大绘图时，bin 的尺寸会自动调整，以显示更清晰的分辨率。

示例

binscatter(x,y,N) 指定要使用的 bin 数。N 可以是标量或二元素向量 [Nx Ny]。如果 N 是标量，则 Nx 和 Ny 都设置为标量值。每个维度中的最大 bin 数为 250。

示例

binscatter(___,Name,Value) 使用一个或多个名称-值对组参量指定属性值。例如，您可以将 'ShowEmptyBins' 指定为 'on'，以便对无数据点的区域进行着色。有关属性的完整列表，请参阅 Binscatter 属性。可将此选项与上述语法中的任何输入参量组合一起使用。

binscatter(ax,___) 将图形绘制到 ax 指定的坐标区中，而不是当前坐标区 (gca) 中。ax 输入可以位于上述语法中的任何输入参量组合之前。

h = binscatter(___) 返回 Binscatter 对象。使用此对象可检查和调整分 bin 散点图的属性。

示例

全部折叠

向量的分 bin 散点图

打开实时脚本

在 x 和 y 维上生成随机数，并创建分 bin 散点图。binscatter 函数会自动选择合适的 bin 数量，以便涵盖数据中的值范围。

x = randn(1e6,1);
y = 2*x + randn(1e6,1);
binscatter(x,y)

Figure contains an axes object. The axes object contains an object of type binscatter.

指定 bin 数

打开实时脚本

绘制包含 10,000 个随机数的分 bin 散点图，这些随机数划分到 x 维的 30 个 bin 和 y 维的 10 个 bin 中。

rng default % for reproducibility
x = randn(1e4,1);
y = randn(1e4,1);
h = binscatter(x,y,[30 10]);

Figure contains an axes object. The axes object contains an object of type binscatter.

求 bin 计数。结果是一个矩阵，其左上方的元素对应于绘图中左下方的 bin 计数。x 维上的 bin 对应于矩阵行，y 维上的 bin 对应于矩阵列。

counts = h.Values;

更改分 bin 散点图的颜色图

打开实时脚本

创建一些随机数据点的分 bin 散点图。

x = randn(1e5,1);
y = randn(1e5,1);
binscatter(x,y)

Figure contains an axes object. The axes object contains an object of type binscatter.

默认颜色图范围从浅色（小值）到深色（大值）。改用以深色表示小值的颜色图更容易发现离群值。

可以使用 colormap 函数更改绘图中的颜色。使用 gca 传入当前坐标区句柄。

colormap(gca,'parula')

Figure contains an axes object. The axes object contains an object of type binscatter.

调整分 bin 散点图的属性

打开实时脚本

生成 1000 个随机数并创建分 bin 散点图。返回 Binscatter 对象以调整绘图的属性，而不用重新创建整个绘图。

x = randn(1000,1);
y = randn(1000,1);
h = binscatter(x,y)

Figure contains an axes object. The axes object contains an object of type binscatter.

h = 
  Binscatter with properties:

      NumBins: [11 11]
    XBinEdges: [-3.2764 -2.6485 -2.0206 -1.3927 -0.7648 -0.1369 0.4910 1.1189 1.7468 2.3747 3.0026 3.6305]
    YBinEdges: [-3.1155 -2.5034 -1.8914 -1.2794 -0.6674 -0.0553 0.5567 1.1687 1.7808 2.3928 3.0048 3.6168]
       Values: [11×11 double]
      XLimits: [-3.2764 3.6305]
      YLimits: [-3.1155 3.6168]
    FaceAlpha: 1

  Show all properties

准确指定每个方向要使用的 bin 数量。

h.NumBins = [20 30];

Figure contains an axes object. The axes object contains an object of type binscatter.

开启绘图中空 bin 的显示。

h.ShowEmptyBins = 'on';

Figure contains an axes object. The axes object contains an object of type binscatter.

使用 XLimits 和 YLimits 属性指定坐标区的范围。然后使用向量限制 x 方向的 bin 范围。

xlim(gca,h.XLimits); 
ylim(gca,h.YLimits); 
h.XLimits = [-1 1];

Figure contains an axes object. The axes object contains an object of type binscatter.

输入参数

全部折叠

`x`, `y` — 输入向量
向量

输入向量，指定为具有相同长度的实数向量。

`N` — bin 数量
标量 | 二元素向量

bin 数量，指定为标量或二元素向量 [Nx Ny]。

如果 N 是一个二元素向量 [Nx Ny]，则 binscatter 在 x 维度上划分 Nx 个 bin，在 y 维度上划分 Ny 个 bin。
如果 N 是标量，则 Nx 和 Ny 都设置为标量值。

未放大坐标区时，binscatter 在初始绘图上沿 x 和 y 维度分别划分 Nx 和 Ny 个 bin。（当 XLimMode 和 YLimMode 属性都设置为 'auto' 时，不会放大坐标区。）缩放时，binscatter 将调整 bin 的数量，以保持一个合适的 bin 大小，使绘图的可见部分大约划分为 Nx×Ny 个 bin。

每个维度中的最大 bin 数为 250。默认 bin 数量是根据数据大小和标准差计算得出的，不超过 100。

示例: [10 20]

`ax` — 目标坐标区
`gca` (默认) | `Axes` 对象

目标坐标区，指定为 Axes 对象。如果您不指定坐标区，则 binscatter 使用当前坐标区 (gca)。

名称-值参数

全部折叠

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: binscatter(x,y,'ShowEmptyBins','on') 会开启绘图中空 bin 的显示。

此处所列的属性只是一部分。有关完整列表，请参阅 Binscatter 属性。

`XLimits` — x 维度的数据范围
向量

x 维度的数据范围，指定为二元素向量 [Xmin Xmax]。

binscatter 仅显示落在指定数据范围 $X_{\min} \leq X \leq X_{\max}$ （含边界值）内的数据点。

示例: [0 10]

`YLimits` — y 维度的数据范围
向量

y 维度的数据范围，指定为二元素向量 [Ymin Ymax]。

binscatter 仅显示落在指定数据范围 $Y_{\min} \leq Y \leq Y_{\max}$ （含边界值）内的数据点。

示例: [0 10]

`ShowEmptyBins` — 开启或关闭空 bin 的显示
`'off'` (默认) | on/off 逻辑值

开启或关闭空 bin 的显示，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

如果指定 'on' 或 true，将为绘图中落在 bin 范围内但无数据点的图块着色。

输出参量

全部折叠

`h` — `Binscatter` 对象
`Binscatter` 对象

Binscatter 对象。使用此对象可检查和调整绘图的属性。有关属性的完整列表，请参阅 Binscatter 属性。

提示

当几个 bin 控制整个绘图时，将坐标区的 ColorScale 属性更改为 'log' 可以产生更好的 bin 着色。
```
ax = gca;
ax.ColorScale = 'log';
```

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

binscatter 函数支持 tall 数组，但存在以下使用说明和限制：

处理 tall 数组时，binscatter 函数将以迭代方式逐步绘图，一边读取数据，一边添加到绘图中。在更新过程中，进度指示条显示已绘制数据的比例。在绘图完成之前，支持在更新过程中进行缩放和平移。要停止更新过程，请按进度指示条中的暂停按钮。

有关详细信息，请参阅tall 数组。

版本历史记录

在 R2017b 中推出

全部展开

R2025a: UI 坐标区中的绘图使用 `sky` 颜色图

当使用 UIAxes 对象创建一个分 bin 散点图时，绘图颜色来自 sky 颜色图。以前，绘图颜色来自 parula 颜色图。

另请参阅

histogram | histogram2 | histcounts2 | histcounts | scatter

主题

Visualization of Tall Arrays

binscatter

语法

说明

示例

向量的分 bin 散点图

指定 bin 数

更改分 bin 散点图的颜色图

调整分 bin 散点图的属性

输入参数

x, y — 输入向量 向量

N — bin 数量 标量 | 二元素向量

ax — 目标坐标区 gca (默认) | Axes 对象

名称-值参数

XLimits — x 维度的数据范围 向量

YLimits — y 维度的数据范围 向量

ShowEmptyBins — 开启或关闭空 bin 的显示 'off' (默认) | on/off 逻辑值

输出参量

h — Binscatter 对象 Binscatter 对象

提示

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

版本历史记录

R2025a: UI 坐标区中的绘图使用 sky 颜色图

另请参阅

主题

`x`, `y` — 输入向量
向量

`N` — bin 数量
标量 | 二元素向量

`ax` — 目标坐标区
`gca` (默认) | `Axes` 对象

`XLimits` — x 维度的数据范围
向量

`YLimits` — y 维度的数据范围
向量

`ShowEmptyBins` — 开启或关闭空 bin 的显示
`'off'` (默认) | on/off 逻辑值

`h` — `Binscatter` 对象
`Binscatter` 对象

tall 数组
对行数太多而无法放入内存的数组进行计算。

R2025a: UI 坐标区中的绘图使用 `sky` 颜色图