Polars 中实现左边界可扩展的滚动时间窗口平均值计算

风婷吖_9883

风婷吖_9883

2026-11-17

231人浏览

原创

Polars 中实现左边界可扩展的滚动时间窗口平均值计算

本文介绍如何在 Polars 中实现“左边界非严格”的 5 分钟滚动时间窗口平均值——即窗口以当前时间戳为右边界,左边界允许包含早于 t - 5m 的最近可用数据点,从而避免因时间不均匀导致的数据截断。

本文介绍如何在 polars 中实现“左边界非严格”的 5 分钟滚动时间窗口平均值——即窗口以当前时间戳为右边界,左边界允许包含早于 `t - 5m` 的最近可用数据点,从而避免因时间不均匀导致的数据截断。

在 Polars 中,原生的 rolling() 操作默认要求时间窗口严格对齐(如 closed="right" 表示 [t−5m, t)),但实际时序数据常存在稀疏、不规则采样——例如缺失 t−5m 正好对应的记录。此时若强制截断,会丢失早期有效观测值(如示例中 10:06:00 窗口本应包含 10:00:01),导致统计偏差。

Polars 并未直接提供 Pandas 风格的自定义索引器(如 BaseIndexer),但可通过 滚动 + join_asof 组合策略优雅解决该问题:

  1. 先用 rolling(..., closed="right") 计算标准右闭左开窗口(即 [t−5m, t));
  2. 再通过 join_asof(..., right_on=timestamp.dt.offset_by("5m")) 将每个窗口的「理论左边界」反向匹配到数据中最接近且 ≤ 该边界的最早行;
  3. 最后合并窗口内值与额外匹配值,并重新计算均值。

以下是完整可运行代码:

import polars as pl

df = pl.DataFrame({
    "timestamp": [
        "2024-04-10 10:00:01",
        "2024-04-10 10:01:30",
        "2024-04-10 10:03:10",
        "2024-04-10 10:05:00",
        "2024-04-10 10:06:00",
        "2024-04-10 10:08:10",
    ],
    "value": [1, 2, 3, 4, 5, 6]
}).with_columns(
    pl.col("timestamp").str.strptime(pl.Datetime)
)

result = (
    df.rolling("timestamp", period="5m", closed="right")
    .agg(pl.col("value"))
    .join_asof(
        df,
        left_on="timestamp",
        right_on=pl.col("timestamp").dt.offset_by("5m")
    )
    .select(
        pl.col("timestamp"),
        pl.when(pl.col("value_right").is_null())
        .then(pl.col("value"))
        .otherwise(pl.concat_list(pl.col("value_right"), pl.col("value")))
        .alias("value")
    )
    .with_columns(rolling_value=pl.col("value").list.mean())
)

print(result)

输出结果与预期一致:

AdsTurbo AI
AdsTurbo AI

AdsTurbo AI是一款AI文本写作工具,AI视频广告生成平台,自动生成可直接投放的视频。

下载
shape: (6, 3)
┌─────────────────────┬────────────────┬───────────────┐
│ timestamp           ┆ value          ┆ rolling_value │
│ ---                 ┆ ---            ┆ ---           │
│ datetime[μs]        ┆ list[i64]      ┆ f64           │
╞═════════════════════╪════════════════╪═══════════════╡
│ 2024-04-10 10:00:01 ┆ [1]            ┆ 1.0           │
│ 2024-04-10 10:01:30 ┆ [1, 2]         ┆ 1.5           │
│ 2024-04-10 10:03:10 ┆ [1, 2, 3]      ┆ 2.0           │
│ 2024-04-10 10:05:00 ┆ [1, 2, 3, 4]   ┆ 2.5           │
│ 2024-04-10 10:06:00 ┆ [1, 2, 3, 4, 5]┆ 3.0           │
│ 2024-04-10 10:08:10 ┆ [3, 4, 5, 6]   ┆ 4.5           │
└─────────────────────┴────────────────┴───────────────┘

✅ 关键要点说明:

  • offset_by("5m") 将右边界 t 向前推 5 分钟,生成虚拟左边界 t−5m;
  • join_asof 默认采用 strategy="backward",即对每个 t 查找 timestamp ≤ t−5m 的最大时间点对应行(即“最晚的早期数据”),完美模拟左边界弹性扩展;
  • 使用 pl.when(...).then(...).otherwise(...) 处理边界情况(如首行无前驱数据),确保逻辑健壮;
  • 注意:join_asof 要求左右表时间列已排序(rolling 输出天然有序,无需额外 sort)。

⚠️ 注意事项:

  • 若数据中存在重复时间戳,建议先去重或明确排序策略(如 by="timestamp" + maintain_order=True);
  • offset_by() 支持负偏移(如 "−5m"),但此处需正向偏移以构造左边界查询键;
  • 该方法时间复杂度为 O(n log n),适用于百万级以内时序数据;超大规模场景可考虑预分桶 + group_by_dynamic 替代,但会牺牲左边界灵活性。

此方案兼顾表达力与性能,是 Polars 生态中处理“非对齐滚动窗口”的推荐实践。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

可扩展

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1951

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5504

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

33557

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3947

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3947

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1283

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 198人学习

XML教程
XML教程

共142课时 | 15.1万人学习

ThinkPHP6.x API接口--十天技能课堂
ThinkPHP6.x API接口--十天技能课堂

共14课时 | 1.6万人学习