Altair mark_area()中Y2参数异常行为问题咨询

问题场景 #

尝试用Altair的mark_area()绘制单调递增的CDF面积图时出现不符合预期的结果，测试代码如下：

import altair as alt
import polars as pl

_data = pl.DataFrame({"outcomes": [16950, 17050, 18750, 18750, 20950]})
(
    alt.Chart(
        _data,
    )
    .transform_quantile("outcomes", step=0.1)
    .mark_area(line=True, opacity=0.5)
    .encode(
        alt.X("value:Q"),
        alt.Y("prob:Q").title("Prob"),
        # alt.Y2(alt.datum(0))
        # y2=alt.datum(0),
    )
)

不同设置下的表现：

• 未设置Y2时，图表形态不符合CDF预期
• 启用alt.Y2(alt.datum(0))时，仅显示CDF曲线，无面积填充
• 仅使用y2=alt.datum(0)时，可正常绘制符合预期的CDF面积图

疑问解答 #

1. 何时Y2默认值不为0？原因是什么？ #

mark_area()的Y2默认值并非固定为0，其默认行为取决于数据和编码类型：

• 当仅指定Y编码时，Altair会将Y2默认设置为数据中的最小Y值，而非固定0。这是因为mark_area()默认用于绘制"区域填充"，比如折线与数据基线（而非坐标轴基线）之间的区域。
• 在该场景中，transform_quantile生成的prob字段最小值虽为0.0，但因数据存在重复的outcomes值，计算后的分位点导致Altair的基线计算逻辑出现偏差，最终使得默认Y2不是0，引发面积形态异常。

2. alt.Y2(...)与y2=...为何表现不同？ #

二者的差异源于Altair编码的层级解析逻辑：

• y2=alt.datum(0)是在encode()方法中直接传递简写参数，会被Altair正确解析为固定基线值，与Y编码的prob字段配合，形成从0到prob的填充区域。
• alt.Y2(alt.datum(0))是显式创建Y2编码对象，但在当前版本（altair==5.5.0）中，当使用datum作为Y2的数据源时，存在解析优先级问题：Y2的datum值未被正确绑定到面积图的基线，反而被当作独立数据集处理，导致无法生成填充区域，仅保留折线部分。
• 你的使用方式本身无错误，这属于Altair在特定编码场景下的解析行为差异，后续版本可能修复该问题。

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