Skip to main content

Extract and manipulate data from battery cell testers.

Project description

cellpy Documentation Status

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.


The documentation for cellpy is hosted on Read the docs.

Installation and dependencies

The easiest way to install cellpy is to install with conda or pip.

With conda:

conda install cellpy --channel conda-forge

Or if you prefer installing using pip:

pip install cellpy

Have a look at the documentation for more detailed installation procedures, especially with respect to “difficult” dependencies when installing with pip.


cellpy is free software made available under the MIT License.


  • Load test-data and store in hdf5 format.

  • Filter out the steps of interest.

  • Process and plot the data.

  • And more…


0.4.2 (2022)

  • Changed definition of Coulombic Difference (negative of previous)

  • Updated loaders with hooks and additional base class TxtLoader with configuration mechanism

  • Support for Maccor txt files

  • Supports only python 3.8 and up

  • Optional parameters through batch and pages

  • Several bug fixes and minor improvements / adjustments

  • Restrict use of instrument label to only one option

0.4.1 (2021)

  • Updated documentations

  • CLI improvements

  • New argument for get_cap: max_cycle

  • Reverting from using Documents to user home for location of prm file in windows.

  • Easyplot by Amund

  • Arbin sql reader by Muhammad

0.4.0 (2020)

  • Reading arbin .res files with auxiliary data should now work.

  • Many bugs have been removed - many new introduced.

  • Now on conda-forge (can be installed using conda).

0.4.0 a2 (2020)

  • Reading PEC files now updated and should work

0.4.0 a1 (2020)

  • New column names (lowercase and underscore)

  • New batch concatenating and plotting routines

0.3.3 (2020)

  • Switching from git-flow to github-flow

  • New cli options for running batches

  • cli option for creating template notebooks

  • Using ruamel.yaml instead of pyyaml

  • Using python-box > 4

  • Several bug-fixes

0.3.2 (2019)

  • Starting fixing documentation

  • TODO: create conda package

  • TODO: extensive tests

0.3.1 (2019)

  • Refactoring - renaming from dfsummary to summary

  • Refactoring - renaming from step_table to steps

  • Refactoring - renaming from dfdata to raw

  • Refactoring - renaming cellpy.cell to cellpy.get

  • Updated save and load cellpy files allowing for new naming

  • Implemented cellpy new and cellpy serve cli functionality

0.3.0 (2019)

  • New batch-feature

  • Improved make-steps and make-summary functionality

  • Improved cmd-line interface for setup

  • More helper functions and tools

  • Experimental support for other instruments

  • invoke tasks for developers

0.2.1 (2018)

  • Allow for using mdbtools also on win

  • Slightly faster find_files using cache and fnmatch

  • Bug fix: error in sorting files when using pathlib fixed

0.2.0 (2018-10-17)

  • Improved creation of step tables (much faster)

  • Default compression on cellpy (hdf5) files

  • Bug fixes

0.1.22 (2018-07-17)

  • Parameters can be set by dot-notation (python-box).

  • The parameter Instruments.cell_configuration is removed.

  • Options for getting voltage curves in different formats.

  • Fixed python 3.6 issues with Read the Docs.

  • Can now also be used on posix (the user must install mdb_tools first).

  • Improved logging allowing for custom log-directory.

0.1.21 (2018-06-09)

  • No legacy python.

0.1.0 (2016-09-26)

  • First release on PyPI.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cellpy-0.4.2.post5.tar.gz (2.6 MB view hashes)

Uploaded source

Built Distribution

cellpy-0.4.2.post5-py3-none-any.whl (1.8 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page