Panel

Panel 是 BagelQuant 中显式的数据对象。每个输入 panel 都通过 Domain 创建,并继承该研究域的交易日历和资产空间。

角色

Panel 可以表示:

因子、预测和组合权重通常先表示为惰性 Graph,只有在需要输出时才被计算成 Panel

不变量

Panel 要求唯一的一维索引和列名,只包含数值,构造时复制输入数据,通过 Panel.data 访问时返回防御性副本,并从公开 API 角度保持不可变。

Panel 必须匹配 Domain 的交易日历和资产列。对于动态资产池,非活跃单元会被屏蔽。

动态资产池

动态资产池是一个以日期为索引、资产为列的布尔表。缺失行和缺失单元都视为非活跃,成员关系不会自动向前填充。

CategoryPanel

CategoryPanel 用于行业、板块、国家等标签数据。它与 Panel 具有相同的时间乘资产形状,但接受字符串标签,可配合 bagelquant_core.transformer 中的 category 操作使用。