Methodology and fairness rules

Battery tests are only useful when the comparison is clear. This page explains how raw CSV logs are converted into public metrics and why early stops are flagged.

CSV ingestion

  • Raw tester CSV files stay private.
  • The Python ingestion tool detects header rows, voltage, current, power, capacity, energy, and temperature columns.
  • Power, capacity, and Wh are calculated when the CSV does not provide them.
  • Malformed rows and missing columns are logged.

Fairness checks

  • Files ending above target cutoff are flagged as early stops.
  • Files that do not reach 3.0V are flagged as incomplete for usable-above-3.0V ranking.
  • Mixed test currents are shown as cross-condition comparisons.
  • Raw total mAh and Wh are not treated as fair rankings when cutoff voltages differ.

Standard chart order

  1. Voltage over Watt-hour
  2. Power over Watt-hour
  3. Temperature over Watt-hour
  4. Current over Watt-hour
  5. Capacity over Watt-hour
  6. Voltage over Time
  7. Power over Time
  8. Temperature over Time
  9. Combined Capacity Page, with Capacity over Time and Capacity over Watt-hour

Data access policy

Public viewing

  • Visitors can view processed charts, rankings, summary metrics, and fairness notes.
  • The public comparison page does not offer CSV downloads.
  • Raw tester CSV files are kept outside the public website folder.

Future access

  • Detailed CSV or curve exports may later be available by paid subscription.
  • Special data requests can be handled manually before a subscription system exists.
  • Published charts remain public, but downloadable source data is not public yet.

Important metric definitions

MetricMeaning
Raw capacity mAhTotal measured capacity to the file ending point.
Raw WhTotal measured energy to the file ending point.
Usable capacity above 3.0VCapacity delivered before the curve first reaches 3.0V. If the file never reaches 3.0V, it is marked incomplete.
Usable Wh above 3.0VEnergy delivered before the curve first reaches 3.0V. This is often the practical high-drain comparison anchor.
LAB Room TempRoom temperature entered during ingestion, used for temperature rise when available.
Early loaded voltageVoltage near the beginning of real load, useful for initial sag comparison.