Skip to main content
@elata-biosciences/biosignal-session 尚未发布到 npm。以下 API 基于 SDK 仓库中的源码,在首次发布前可能会有变化。

功能

@elata-biosciences/biosignal-session 将生物信号会话(EEG、PPG、rPPG 指标等)录制为一组类型化的数据流,并分块为自包含的 Apache Arrow 文件。录制仅限本地:该包不包含任何网络客户端。 它为可靠性而设计:
  • 每个分块都带有 CRC32C 校验和以及幂等的 (session, stream, sequence) 标识
  • 录制器会重试、施加背压,绝不会静默丢弃数据
  • 真实的数据间隙会被记录为显式的不连续,绝不插值

数据模型

时间以会话为基准、以整数微秒表示,在会话开始时锚定一次。

角色

一次录制有两端,通过 MessagePort 通信:
Elata 目前尚未提供会话录制宿主。现阶段请在你自己的宿主页面中使用该包,或在开发和测试中使用内存宿主。

安装


设备适配器

将你已在使用的 SDK 对象包装为录制数据源:
  • createHeadbandSource(transport):来自 eeg-web / eeg-web-ble 的 HeadbandTransport
  • createRppgSource(options):rppg-web 会话
  • createPpgSource(options):ppg-web 指标

无需硬件即可试用

testing 入口可以使用带种子的合成数据源,针对内存宿主运行完整录制。数小时的虚拟信号可在数秒内完成:

读取分块

每个分块都是一个完整的 Arrow IPC 文件,自带结构和标识,因此可以单独解码,无论是在 JavaScript 中,还是在 Python 中使用 pyarrow:

完整指南

逐步的录制流程(时钟锚定、握手、打开数据流、输入样本、结束录制)以及宿主需要提供的保证,见录制指南。AI 工具可以读取 node_modules/@elata-biosciences/biosignal-session/llms.txt。 要分析录制的数据,请参阅 biosignal-analytics。