概述

binX 是一个针对 X 通道数据进行分箱处理的重要函数。它主要用于将连续型数据按照指定的规则划分为离散的区间或分组，使数据更易于分析，并适用于特定的可视化场景（例如：热力图、条形图、网格图等）。

与 bin 类似，binX 专门用于 X 轴方向的数据分箱，而 bin 通常处理二维（X 和 Y）或单维度的数据。binX 可以独立应用，只对 X 通道的数据进行分箱，而无需处理其他维度的数据。

使用场景

• 将连续的 X 通道数据划分为多个离散区间：根据数据范围，通过指定分箱规则，生成离散的区间（如 [0-10), [10-20) 等）。
• 转换原始数据格式：通过分箱的处理，生成新的字段（如指定输出字段名），用于表示数据所属区间。
• 便于统计数据分布：分箱后的数据可直接用于可视化处理（如统计每个区间内的频率或值）。
• 单独处理 X 通道数据维度：当 Y 通道无需分箱时，binX 可以仅对 X 通道数据进行分箱，灵活调整数据处理逻辑。

希望对 Y 通道进行分箱，使用 binX + transpose 坐标系。

{
  "autoFit": true
}

配置项

thresholdsX

binX 是一种专门用于对 X 轴方向上的连续型数据进行分箱（离散化）的变换操作。通过配置 thresholdsX，可以明确指定 X 轴方向上的分箱边界，从而实现对数据的精细化控制。

{
  "transform": [
    {
      "color": "count"
    }
  ]
}

channel

理论上，channel 可以设置为所有的通道值，具体可以参考 encode 文档。所有的枚举值如下：

type Channel =
  | 'x'
  | 'y'
  | 'z'
  | 'x1'
  | 'y1'
  | 'series'
  | 'color'
  | 'opacity'
  | 'shape'
  | 'size'
  | 'key'
  | 'groupKey'
  | 'position'
  | 'series'
  | 'enterType'
  | 'enterEasing'
  | 'enterDuration'
  | 'enterDelay'
  | 'updateType'
  | 'updateEasing'
  | 'updateDuration'
  | 'updateDelay'
  | 'exitType'
  | 'exitEasing'
  | 'exitDuration'
  | 'exitDelay'
  | `position${number}`;

示例

使用 bin + opacity 渲染出颜色分类直方图

{
  "autoFit": true,
  "transform": [],
  "style": {
    "inset": 0.5
  }
}

泊松分布