功能
@elata-biosciences/biosignal-session 将生物信号会话(EEG、PPG、rPPG 指标等)录制为一组类型化的数据流,并分块为自包含的 Apache Arrow 文件。录制仅限本地:该包不包含任何网络客户端。
它为可靠性而设计:
- 每个分块都带有 CRC32C 校验和以及幂等的
(session, stream, sequence)标识 - 录制器会重试、施加背压,绝不会静默丢弃数据
- 真实的数据间隙会被记录为显式的不连续,绝不插值
数据模型
角色
一次录制有两端,通过MessagePort 通信:
Elata 目前尚未提供会话录制宿主。现阶段请在你自己的宿主页面中使用该包,或在开发和测试中使用内存宿主。
安装
设备适配器
将你已在使用的 SDK 对象包装为录制数据源:createHeadbandSource(transport):来自eeg-web/eeg-web-ble的HeadbandTransportcreateRppgSource(options):rppg-web会话createPpgSource(options):ppg-web指标
无需硬件即可试用
testing 入口可以使用带种子的合成数据源,针对内存宿主运行完整录制。数小时的虚拟信号可在数秒内完成:读取分块
每个分块都是一个完整的 Arrow IPC 文件,自带结构和标识,因此可以单独解码,无论是在 JavaScript 中,还是在 Python 中使用pyarrow:
完整指南
逐步的录制流程(时钟锚定、握手、打开数据流、输入样本、结束录制)以及宿主需要提供的保证,见录制指南。AI 工具可以读取node_modules/@elata-biosciences/biosignal-session/llms.txt。
要分析录制的数据,请参阅 biosignal-analytics。