Skip to content

Performance Tips

Guidance for running BatteryProc efficiently, especially with large datasets or batch processing.

Large Batch Runs

When processing hundreds or thousands of files:

  • Hardware: Fast SSD and modern multi-core CPU significantly improve file I/O and data processing speed.
  • Split workloads: For very large datasets, split files into subdirectories and process each separately.
  • Disable optional features: If you don't need dQ/dV plots or SVG files, omit --derivative and --svg to reduce computation and I/O.
  • CSV-only mode: Use --csv-only instead of --csv when you only need numeric data (skips all plot rendering).
  • Quiet mode: Use --quiet --no-progress in automated pipelines to reduce console I/O overhead.

Early Skip Logic

By default, BatteryProc skips files that appear incomplete:

  • Files with very few data rows in the record sheet.
  • Files still on the very first step of the first cycle.

This avoids wasting time generating plots for cells with no meaningful data. Override with --force-process if you need to analyze such files (e.g., debugging a test setup).

Avoiding Mass Prompts in Scripts

When running in non-interactive scripts, the mass prompt can cause hangs. To avoid this:

  • Provide mass upfront: Use --mass-g 0.523 to skip the prompt entirely.
  • Ensure correct data entry: The best long-term fix is to enter the correct mass in the testing software before the test begins.
  • Batch scripting: When processing many files with the same active material mass, pass --mass-g once and it applies to all files.

See Also