1eurofilter

中文文档
1.3.0发布于 2026/02/15BSD-3-ClauseTypeScriptCommonJS零依赖近 30 天下载 2388

算法可以过滤出高精度和高响应性的噪音信号.

中文使用文档
文档目录12 节
  1. 安装
  2. 最小示例
  3. 医生
  4. 构造器
  5. 过滤器
  6. 重设
  7. 设置Beta
  8. 抵消
  9. 频率
  10. 设定MinCutoff
  11. 参数
  12. 相关出版物

NPM Version npm downloads

1欧元过滤打字机版本

提供打印符执行 1欧元过滤器。 。 。 .

安装

npm install 1eurofilter

最小示例

import {OneEuroFilter} from '1eurofilter'

let frequency = 120; // Hz
let mincutoff = 1.0; // Hz
let beta = 0.1;      
let dcutoff = 1.0; 

let f = new OneEuroFilter(frequency, mincutoff, beta, dcutoff);

let noisyvalue = 2.1;
let timestamp = 0.0; // in seconds

let filtered = f.filter(noisyvalue, timestamp);

医生

构造器

二. 支助 新建一个欧元过滤器(单位:千美元)freq, (中文(简体) ), mincutoff, (中文(简体) ), beta, (中文(简体) ), dcutoff(中文(简体) )

构造1欧元过滤器.

参数

名称类型默认值说明
freqnumberundefined如果没有时间戳,则估计信号( > 0)的频率.
mincutoffnumber1.0最小切入频率以 Hz ( > 0) 为单位. 更低的值允许去除更焦躁.
betanumber0.0减少延迟的参数( > 0).
dcutoffnumber1.0用来过滤衍生物。 1赫兹默认. 如果您知道自己在做什么, 请更改此参数 .

过滤器

▸ 过滤器(单位:千美元)value, (中文(简体) ), timestamp: number

返回被过滤的值.

参数

名称类型说明
valuenumber要过滤的噪音值
timestampnumber(可选)时间戳以秒计

重设

▸ 重设(单位:千美元) void

重置过滤器的内部状态 .

设置Beta

▸ 设置Beta(单位:千美元)beta: void

设置 beta 参数

参数

名称类型说明
betanumber减少延迟的参数( > 0).

抵消

▸ 抵消(单位:千美元)dcutoff: void

设置 dcutoff 参数

参数

名称类型说明
dcutoffnumber用来过滤衍生物。 1赫兹默认. 如果您知道自己在做什么, 请更改此参数 .

频率

▸ 频率(单位:千美元)freq: void

设定信号的频率

参数

名称类型说明
freqnumber如果没有时间戳,则估计信号( > 0)的频率.

设定MinCutoff

▸ 设定MinCutoff(单位:千美元)mincutoff: void

设置过滤分切出频率

参数

名称类型说明
mincutoffnumber最小切入频率以 Hz ( > 0) 为单位. 更低的值允许去除更焦躁.

参数

▸ 参数(单位:千美元)freq, (中文(简体) ), mincutoff, (中文(简体) ), beta: void

设置 1欧元过滤器的参数.

参数

名称类型说明
freqnumber如果没有时间戳,则估计信号( > 0)的频率.
mincutoffnumber最小切入频率以 Hz ( > 0) 为单位. 更低的值允许去除更焦躁.
betanumber减少延迟的参数( > 0).

DOI

@inproceedings{10.1145/2207676.2208639,
    author = {Casiez, G\'{e}ry and Roussel, Nicolas and Vogel, Daniel},
    title = {1 € Filter: A Simple Speed-Based Low-Pass Filter for Noisy Input in Interactive Systems},
    year = {2012},
    isbn = {9781450310154},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/2207676.2208639},
    doi = {10.1145/2207676.2208639},
    pages = {2527–2530},
    numpages = {4},
    keywords = {noise, jitter, lag, precision, filtering, responsiveness, signal},
    location = {Austin, Texas, USA},
    series = {CHI '12}
}

版本与发布记录

1eurofilter 共发布 10 个版本,首次发布于 2023/08/06;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.3.0latest2026/02/158 个月前
1.2.22024/08/142 年前
1.2.12023/10/083 年前
1.2.02023/10/083 年前
1.1.12023/09/283 年前
1.1.02023/09/283 年前

关于 1eurofilter 的常见问题

1eurofilter 是什么?

算法可以过滤出高精度和高响应性的噪音信号.

如何安装 1eurofilter?

在项目目录运行 npm install 1eurofilter,或使用 pnpm add / yarn add / bun add。

1eurofilter 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

1eurofilter 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

1eurofilter 可以商用吗?

1eurofilter 使用 BSD-3-Clause 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括,不构成法律意见,请以许可原文为准。

1eurofilter 的下载量有多少?

根据 npm 官方下载统计,1eurofilter 在 2026/10/04 – 2026/11/02 这 30 天内被下载 2,388 次,日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

1eurofilter 还在维护吗?

最新版本 1.3.0 发布于 2026/02/15(8 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 1 个;首次发布于 2023/08/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。