---
url: /v6.2/reference-line.md
---
# 参考线

## 参考线意义

* 处于某一区间的样本分布

![](/images/reference-line-distribution.png)

* 在某个营销活动或特殊日期之后指标的变化趋势

![](/images/reference-line-specific-date.png)

## 参考线适用图表

参考线适用于二维坐标图表，包括：

* 各种柱状图：X 轴，Y 轴
* 分簇柱状图：X 轴，左侧 Y 轴，右侧 Y 轴
* 各种横向柱状图：X 轴，Y 轴
* 折线图：X 轴，左侧 Y 轴，右侧 Y 轴
* 折线柱状图：X 轴，左侧 Y 轴，右侧 Y 轴
* 散点图：X 轴，Y 轴
* 区域图：X 轴，Y 轴
* 瀑布图：X 轴，Y 轴
* 组合图表：所有的 X 轴、Y 轴（暂未支持）

**只有当参考线值落在轴范围内，才会绘制出来。**

![](/images/reference-line-axis.png)

## 参考线值

### 维度轴参考线

* 固定值：可以输入常量
* 表达式：可以输入常量，也可以输入返回值为常量的聚合表达式，在表达式中可以使用字段、指标、参数、用户属性，**但不能使用图内指标**

当维度是日期时，如果选择了“补齐时间点”，那么日期轴就会变为连续轴，如果属于日期轴范围之内，就会显示在轴上，比如维度计算方式是月份，但参考线值设置了单位为天的日期，比如“2012-11-06”，那么该日期会按照比例显示在2012年11月和12月之间。如果没有选择“补齐时间点”，轴变为离散轴，2012-11-06就不会显示在轴上，每月的第一天比如 s2012-11-01会作为月显示在轴上。

![](/images/reference-line-continuous-date.png)

### 度量轴参考线

* 固定值：可以输入变量
* 计算值：图内指标的平均值/最大值/最小值/百分位数
* 表达式：可以输入常量，也可以输入返回值为常量的聚合表达式，在表达式中可以使用字段、指标、参数、用户属性，**但不能使用图内指标**

## 颜色

参考线可以设置颜色和不透明度。

## 参考线与过滤器的关系

* 如果参考线类型是“计算值”，参考值是前端根据后端返回的图表数据进行计算的，这时候，参考线的上下文是图表数据，所有的过滤器都会应用于图表数据，从而影响参考线值

* 如果参考线类型是“表达式”，参考值是后端根据数据集明细上下文进行计算的，这时候，参考线的上下文是数据集明细数据：
  * 图表中的字段/指标过滤器会应用到参考线上
  * 仪表盘过滤器会应用到参考线上
  * 图内指标过滤器**不会**应用到参考线上

## 数值格式

参考线的值可以设置展示格式，展示格式弹窗根据轴的类型来弹出：

* 如果轴是数字类型，那么弹窗是数字格式弹窗
* 如果轴是日期类型，那么弹窗是日期格式弹窗
* 如果轴是文本类型，参考线没有展示格式菜单

![](/images/reference-line-display-format.png)