本文详解如何基于 Pandas 构建包含多个时间粒度（日级、小时级、分钟级）的多级索引 DataFrame，通过 MultiIndex.from_product 生成全量组合，并与原始数据合并实现零值填充与结构对齐。
本文详解如何基于 pandas 构建包含多个时间粒度（日级、小时级、分钟级）的多级索引 dataframe，通过 `multiindex.from_product` 生成全量组合，并与原始数据合并实现零值填充与结构对齐。
在实际时间序列分析中，常需将稀疏观测数据（如按小时采集的传感器读数）扩展为规则的、覆盖指定时间范围的完整网格结构——尤其当涉及多个嵌套时间粒度（如「组 ID + 日期 + 小时」）时。Pandas 提供了高效且语义清晰的工具链来完成此类任务，核心在于显式构造全量索引组合，而非依赖 resample（后者适用于单时间轴重采样，不适用于多级非对齐时间维度的笛卡尔扩展）。
✅ 正确方法：MultiIndex.from_product 构建全量索引
date_range 是完全合适的输入方式，尤其适合由起止时间+频率定义的规则时间序列（如每日、每小时、每分钟）。若仅有起止时间字符串，可直接传入 pd.date_range(start=..., end=..., freq='D'/'H'/'T')；若需自定义离散点（如非等间隔），则用 pd.DatetimeIndex([...]) 替代。
以下为完整可运行示例，支持任意新增时间层级（如分钟级索引 D）：
import pandas as pd
# 原始数据（注意：B 和 C 列需转为 datetime）
df = pd.DataFrame({
'A': [111, 111, 111, 222, 222, 222],
'B': ['2024-03-22 00:00:00'] * 6,
'C': ['2024-03-22 00:00:00', '2024-03-22 01:00:00', '2024-03-22 02:00:00',
'2024-03-22 03:00:00', '2024-03-22 04:00:00', '2024-03-22 05:00:00'],
'value': [1, 2, 3, 4, 5, 6]
})
df['B'] = pd.to_datetime(df['B'])
df['C'] = pd.to_datetime(df['C'])
# 定义外部时间范围（支持任意粒度）
date_ranges = {
'a': pd.date_range('2024-02-05', '2024-02-06', freq='D'), # 日级：2024-02-05, 2024-02-06
'b': pd.date_range('2024-02-05 22:00', '2024-02-06 23:00', freq='H') # 小时级：共 4 小时 × 2 天 = 8 点
}
# ✅ 关键步骤：生成所有 (A, B_day, C_hour) 的笛卡尔积索引
idx = pd.MultiIndex.from_product(
[df['A'].unique(), date_ranges['a'], date_ranges['b']],
names=['A', 'B', 'C']
)
# 构造零值 DataFrame（自动对齐索引结构）
template_df = pd.DataFrame({'value': 0}, index=idx).reset_index()
# 合并原始数据（保留原值，缺失处补 0）
result = pd.concat([df, template_df], ignore_index=True)
result['value'] = result['value'].fillna(0).astype(int) # 强制整型
# 可选：按多级索引排序以匹配预期输出顺序
result = result.sort_values(['A', 'B', 'C']).reset_index(drop=True)
print(result.head(10))
⚠️ 注意事项与进阶提示
- 索引一致性：确保所有时间列（B, C, ...）均为 datetime64[ns] 类型，否则 from_product 会失败或产生意外结果。
- 内存考量：笛卡尔积规模为 len(A) × len(B_range) × len(C_range)，对于大规模组合（如百万级），建议分块处理或使用 dask。
- 新增维度（如分钟级 D）：只需在 from_product 中追加 date_ranges['c']（如 freq='T'）及对应列名即可，逻辑完全一致。
- 避免 resample 误用：resample() 仅作用于单个 DatetimeIndex 或 PeriodIndex，无法跨多级时间索引进行“联合重采样”。此处本质是索引空间扩展，非时间聚合。
- 缺失值填充策略：示例中统一填 0，你可根据业务替换为 np.nan、前向填充（ffill）或插值（interpolate）。
通过该模式，你可灵活构建任意维度的时间网格（ID × 日 × 小时 × 分钟），为后续机器学习特征工程、时序对齐或可视化奠定坚实基础。
