- a library for assisting in analysing batteries and cells¶

cellpy reads data from battery cycling instruments, turns it into one consistent format, and gives you the derived quantities — capacities, coulombic efficiencies, incremental capacity — without you writing the bookkeeping.

import cellpy

c = cellpy.get("my_cell.res", instrument="arbin_res", mass=0.85)
c.data.summary[c.schema.summary.charge_capacity]

Where to start¶

• New here? Install it, point it at a file, and see what comes back — Getting started.
• Have data to load? Worked examples, from a single file to a whole batch — Tutorials.
• Want to understand the shapes? What a cell object holds and how the frames relate — Concepts.
• Looking for a signature? Generated from the docstrings — API reference.

Coming from cellpy 1.x¶

Version 2 changed the frames, the column names and the file format. Nothing you know is wasted, but some of it is spelled differently now — the migration guide covers what changed and what to do about it.

Support your own instrument¶

If cellpy does not read your instrument's files yet, you can add a loader from your own package without patching cellpy: see writing an instrument loader plugin.

History¶

This Python Package was developed to help the researchers at IFE, Norway, in their cumbersome task of interpreting and handling data from cycling tests of batteries and cells.

License¶

cellpy is free software under the MIT License.