battery-dqdv-plot

name	battery-dqdv-plot
description	Plot dQ/dV (Incremental Capacity Analysis) or dV/dQ (Differential Voltage Analysis) curves for battery cycling data with cycle-mapped colorbar. Supports pkl, csv, parquet, xlsx formats. Use when visualizing battery dQ/dV, ICA, incremental capacity, dV/dQ, DVA, differential voltage, or degradation mechanism analysis.

Battery dQ/dV & dV/dQ Curve Visualization

Overview

绘制电池循环数据的 dQ/dV（增量容量分析 ICA）或 dV/dQ（微分电压分析 DVA）曲线，使用 colorbar 映射循环编号，直观展示峰位偏移和退化机理。

Features

• 支持两种模式：dqdv（ICA）和 dvdq（DVA）
• 支持多种输入格式：pkl、csv、parquet、xlsx
• 充电/放电曲线可选
• Savitzky-Golay 平滑去噪，可调窗口和阶次
• Blues colormap + colorbar 映射循环编号
• 3-sigma 异常循环自动过滤
• 电压范围裁剪（默认 auto: min_v ~ max_v − 0.1）
• 数据 fallback：无 cycle/capacity 列时自动从电流积分计算

Plot Style

• figsize=(4, 2.5)，dpi=300
• Blues colormap，colorbar 无刻度
• 简洁的坐标轴标签
• linewidth=0.3

Workflow

1. 加载数据（pkl / csv / parquet / xlsx，含 fallback）
2. 提取每个循环的电压和容量数据
3. 3-sigma 过滤异常循环
4. 电压范围裁剪
5. Savitzky-Golay 平滑 → 计算 dQ/dV 或 dV/dQ
6. 绘制曲线 + colorbar
7. 保存图片

Data Format Support

与 battery-qv-plot skill 完全相同：

• PKL（推荐）：来自 battery-data-preprocess skill 的标准格式
• CSV / Parquet / XLSX：自动检测列名，缺少 cycle/capacity 列时自动 fallback 到电流积分

Usage

# 默认：充电 dQ/dV
python scripts/plot_dqdv.py \
  --input cell.pkl \
  --output cell_dqdv_charge.png

# 放电 dQ/dV
python scripts/plot_dqdv.py \
  --input cell.pkl \
  --mode discharge

# dV/dQ（DVA 模式）
python scripts/plot_dqdv.py \
  --input cell.pkl \
  --analysis dvdq

# 调整平滑参数
python scripts/plot_dqdv.py \
  --input cell.pkl \
  --window 51 --polyorder 3

# 指定电压范围
python scripts/plot_dqdv.py \
  --input cell.pkl \
  --vrange 3.0,4.0

# 原始数据（无 cycle/capacity 列）
python scripts/plot_dqdv.py \
  --input raw_data.parquet

See reference.md for full CLI parameters. See examples.md for usage examples.