---
url: /3d/scatter3d.md
---
# 三维散点图 scatter3d

空间点云看分布。支持两种数据形态：`[x, y, z]` 三元组（三轴全数值）与类目模式
（labels + 标量系列，与柱状图同构）；`colorScale` 可把 Z 值编码到连续色带上，
在三维位置之外再表达一维信息。

## 何时使用

* 样本有两个自变量和一个因变量，要看分布与聚集；
* 想用颜色再编码一个维度（第四维）；
* 聚类、离群点、相关性初探。

## 示例

三元组 + 色带编码 Z 值：

类目模式（labels + 标量系列，散点按系列分层）：

## 配置要点

* `scatter.colorScale`：`true` 用默认色带，或填色带 id；开启后图例区换成连续色标；
* `scatter.dropLines`（默认开）：每个点的落地虚线，帮助定位高度；点数过万建议关闭；
* `scatter.depthScale`（默认开）：远处的点更小，增强透视感；需要等大点时关闭；
* `scatter.size`：点半径（px），悬浮命中区比视觉半径更大，细点也好悬停。

## 相关

* 色带与色标：[主题接入](/3d/theme)
* 曲面形态：[三维曲面图](/3d/surface3d)
* 字段细节：[API 参考](/3d/api)