# 1eurofilter 中文文档

规范地址：https://npmcn.com/package/1eurofilter/

版本：1\.3\.0
npm 元数据更新时间：2026-02-15T10:27:40.558Z
中文译文更新时间：2026-11-06T20:16:35.992Z
软件包许可：BSD-3-Clause

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/1eurofilter
原文对照：https://npmcn.com/package/1eurofilter/?lang=original
项目主页：https://github.com/casiez/OneEuroFilter#readme
源码仓库：https://github.com/casiez/OneEuroFilter

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：38.3 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2023-08-05T19:17:01.725Z
- 最新版本发布：2026-02-15T10:27:40.465Z
- 近 30 天下载量：2388（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 1 个）

## 中文简介

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

## 安装

```sh
npm install 1eurofilter
```

也可以使用：`pnpm add 1eurofilter`、`yarn add 1eurofilter`、`bun add 1eurofilter`

## README

[![NPM Version](https://badge.fury.io/js/1eurofilter.svg?style=flat)](https://npmjs.org/package/1eurofilter) [![npm downloads](https://img.shields.io/npm/dm/1eurofilter.svg?style=flat-square)](https://npm-stat.com/charts.html?package=1eurofilter)

# 1欧元过滤打字机版本

提供打印符执行 [1欧元过滤器](https://gery.casiez.net/1euro/)。 。 。 .

## 安装

`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欧元过滤器.

#### 参数

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

### 过滤器

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

返回被过滤的值.

#### 参数

| 名称 | 类型 | 说明 |
| :-- | :-- | :-- |
| `value` | `number` | 要过滤的噪音值 |
| `timestamp` | `number` | (可选)时间戳以秒计 |

### 重设

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

重置过滤器的内部状态 .

### 设置Beta

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

设置 beta 参数

#### 参数

| 名称 | 类型 | 说明 |
| :-- | :-- | :-- |
| `beta` | `number` | 减少延迟的参数( > 0). |

### 抵消

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

设置 dcutoff 参数

#### 参数

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

### 频率

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

设定信号的频率

#### 参数

| 名称 | 类型 | 说明 |
| :-- | :-- | :-- |
| `freq` | `number` | 如果没有时间戳,则估计信号( > 0)的频率. |

### 设定MinCutoff

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

设置过滤分切出频率

#### 参数

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

### 参数

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

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

#### 参数

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

## 相关出版物

[![DOI](https://img.shields.io/badge/doi-10.1145%2F2207676.2208639-blue)](https://doi.org/10.1145/2207676.2208639)

```
@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 是什么？

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

### 如何安装 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 和提交记录判断。