eardoi/compressionkit-ppg-2x-npu
Model Introduction
Files & versions
Pull Requests
Discussion
Analysis

compressionkit-ppg-2x(昇腾 NPU 适配)

Ambiq 生物信号压缩编解码器 compressionkit-ppg-2x 的解码端, 将 RVQ 量化 latent 上采样重建为 PPG(光电脉搏波)原始波形。 本项目完成其在**华为昇腾 NPU(Ascend 910B)**上的推理适配与验证。

模型规格

项目说明
网络RVQ 解码器(Conv2D + SeparableConv + LayerNorm)
参数量8.2K
输入RVQ latent [N, 16, T, 1]
输出解码波形 [N, 1, T, up](up=2,2x 压缩)
原始权重decoder.keras(Keras 格式)

权重转换

原始 HF 权重为 Keras .keras(zip 内含 model.weights.h5), 已转换为 PyTorch safetensors(decoder.safetensors,随仓提供):

# 转换脚本逻辑
# keras Conv2D kernel (kh,kw,in,out) -> torch (out,in,kh,kw)
# keras SeparableConv2D depthwise/pointwise -> torch Conv2d(groups=in) + Conv2d(1x1)
# keras LayerNorm gamma/beta -> torch LayerNorm weight/bias

环境准备

pip install -r requirements.txt -i https://repo.huaweicloud.com/repository/pypi/simple/

推理

cd /workspace/Ambiq_compressionkit-ppg-2x
/usr/local/python3.11.14/bin/python3 inference.py \
    --model_path . --weights decoder.safetensors --variant ppg-2x --device npu:0

参数

参数说明默认值
--model_path模型目录必填
--weightssafetensors 权重路径必填
--variant模型变体(ppg-2x/ppg-4x/ecg-2x)ppg-2x
--device推理设备(npu:0 / cpu)npu:0
--output结果保存 JSONinference_result.json

验证结果(Ascend 910B, npu:0)

输入:RVQ latent (1, 16, 128, 1)

[Model Agent] NPU 设备就绪: Ascend910_9382
[Model Agent] 模型加载完成: ppg-2x (8209 params) -> npu:0
[Model Agent] 输出 waveform shape: (1, 1, 128, 2)
[Model Agent] 输出范围: -5.0234 .. 0.8808
[Model Agent] 推理时延: 11.74 ms/iter

compressionkit-ppg-2x 解码器在 NPU 上完成波形重建(输出 (1,1,128,2)), NPU 推理链路完整跑通。

适配说明

  • Keras → PyTorch:从 .keras zip 的 model.weights.h5 读取权重, 转换为 torch Conv2d / SeparableConv2d / LayerNorm 布局。
  • 网络为纯卷积结构,无 CUDA 依赖,model.to('npu:0') + torch.no_grad() 推理。
  • 设备解析自动检测 NPU,失败回退 CPU。
  • 模型权重不推送到仓库:*.safetensors 已加入 .gitignore。

目录结构

.
├── README.md          # 模型卡片(本文件)
├── inference.py       # NPU 推理脚本
├── requirements.txt   # 依赖清单
└── assets/            # 适配过程截图素材

引用

  • 模型:https://huggingface.co/Ambiq/compressionkit-ppg-2x-v1.0
  • 适配参考:https://ai.gitcode.com/K-ON111111/compressionkit-ppg-2x