Skip to main content

A Python package for working with impedance data

Project description

GitHub release PyPI - Downloads All Contributors

Build Status Documentation Status

Codacy Badge Coverage Status

impedance.py

impedance.py is a Python module for working with impedance data.

This project started at the 2018 Electrochemical Society (ECS) Hack Week in Seattle and has grown from there.

Using a scikit-learn-like API, we hope to make visualizing, fitting, and analyzing impedance spectra more intuitive and reproducible.

impedance.py is currently under development and new features are rapidly being added. If you have a feature request or find a bug, please feel free to file an issue or, better yet, make the code improvements and submit a pull request! The goal is to build an open-source tool that the entire impedance community can improve and use!

impedance.py currently provides:

  • preprocessing functions for easily loading in impedance data from a wide variety of file types
  • a simple API for fitting, predicting, and plotting impedance
  • validation methods for checking measurement validity
  • equivalent circuit fitting with customizable models
  • convenient Nyquist plots including confidence interval estimation for fit circuits

several features are currently being improved upon:

  • interactive plotting with altair
  • physics-based impedance models for lithium-ion batteries

Installation

Dependencies

impedance.py requires:

  • Python (>=3.5)
  • SciPy (>=1.0)
  • NumPy (>=1.14)
  • Matplotlib (>=3.0)

Several example notebooks are provided in the examples/ directory. Opening these will require Jupyter notebook or Jupyter lab.

User Installation

The easiest way to install impedance.py is from PyPI using pip (see Getting started with impedance.py for instructions).

Examples and Documentation

Several examples can be found in the examples/ directory (the fitting_tutorial.ipynb is a great place to start) and the documentation can be found at impedancepy.readthedocs.io.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Lok-kun Tsui
Lok-kun Tsui

💻 ⚠️ 📖
Brian Gerwe
Brian Gerwe

💻 ⚠️ 📖
Neal
Neal

👀
Matt Murbach
Matt Murbach

📖 👀 ⚠️ 💻
Kenny Huynh
Kenny Huynh

🐛 💻
lawrencerenna
lawrencerenna

🤔
Rowin
Rowin

🐛 💻
Michael Plews
Michael Plews

🤔
Chebuskin
Chebuskin

🐛
environmat
environmat

🐛
Abdullah Sumbal
Abdullah Sumbal

🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

Project details


Download files

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

Source Distribution

impedance-0.5.0.tar.gz (29.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

impedance-0.5.0-py3-none-any.whl (30.6 kB view details)

Uploaded Python 3

File details

Details for the file impedance-0.5.0.tar.gz.

File metadata

  • Download URL: impedance-0.5.0.tar.gz
  • Upload date:
  • Size: 29.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.8

File hashes

Hashes for impedance-0.5.0.tar.gz
Algorithm Hash digest
SHA256 940a391bc94548086e7d4f1a3647b2cddf57c42e3299920ed295938a8d800265
MD5 af32100d4bc194a46eb3aacb8aa07cad
BLAKE2b-256 e9484b5812cc53a13c5a5fa32602c3037bfd92a86f3b914d6ec646d4f37292f2

See more details on using hashes here.

File details

Details for the file impedance-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: impedance-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 30.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.8

File hashes

Hashes for impedance-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bed1976f909f9f4de742a79b6b1870a70bac430d12e5688a41bed90fddb81dff
MD5 d520c5bfc8b2bacb3d812a48edb2e710
BLAKE2b-256 aabeebce91e0edb17e8cdc52f4b27200ffd758ad0c743c462e9a292094eedaf8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page