Skip to main content

A package for analyzing electrochemical impedance data

Project description

DOI GitHub release

PyPI - Downloads All Contributors

Build Status Documentation Status Coverage Status

impedance.py

impedance.py is a Python package for making electrochemical impedance spectroscopy (EIS) analysis reproducible and easy-to-use.

Aiming to create a consistent, scikit-learn-like API for impedance analysis, impedance.py contains modules for data preprocessing, validation, model fitting, and visualization.

For a little more in-depth discussion of the package background and capabilities, check out our Journal of Open Source Software paper.

If you have a feature request or find a bug, please 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!

Installation

The easiest way to install impedance.py is from PyPI using pip.

pip install impedance

See Getting started with impedance.py for instructions on getting started from scratch.

Dependencies

impedance.py requires:

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

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

Examples and Documentation

Several examples can be found in the docs/source/examples/ directory (the Fitting impedance spectra notebook is a great place to start) and the documentation can be found at impedancepy.readthedocs.io.

Citing impedance.py

DOI

If you use impedance.py in published work, please consider citing https://joss.theoj.org/papers/10.21105/joss.02349 as

@article{Murbach2020,
  doi = {10.21105/joss.02349},
  url = {https://doi.org/10.21105/joss.02349},
  year = {2020},
  publisher = {The Open Journal},
  volume = {5},
  number = {52},
  pages = {2349},
  author = {Matthew D. Murbach and Brian Gerwe and Neal Dawson-Elli and Lok-kun Tsui},
  title = {impedance.py: A Python package for electrochemical impedance analysis},
  journal = {Journal of Open Source Software}
}

Contributors โœจ

This project started at the 2018 Electrochemical Society (ECS) Hack Week in Seattle and has benefited from a community of users and contributors since. 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

๐Ÿ›
nobkat
nobkat

๐Ÿ’ป
Nick
Nick

๐Ÿ› ๐Ÿ’ป
aokomorowski
aokomorowski

๐Ÿ’ป
Peter Attia
Peter Attia

๐Ÿ’ป โš ๏ธ ๐Ÿ“–
sdkang
sdkang

โš ๏ธ ๐Ÿ’ป
lucasfdvx
lucasfdvx

๐Ÿ›
Marcus Karlstad
Marcus Karlstad

๐Ÿ›
Mark Bouman
Mark Bouman

๐Ÿ› ๐Ÿ’ป
oslopanda
oslopanda

๐Ÿ›
pililac
pililac

๐Ÿ›
Kavin Teenakul
Kavin Teenakul

๐Ÿ’ป

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-1.4.3.tar.gz (46.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-1.4.3-py3-none-any.whl (47.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: impedance-1.4.3.tar.gz
  • Upload date:
  • Size: 46.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.1

File hashes

Hashes for impedance-1.4.3.tar.gz
Algorithm Hash digest
SHA256 30ed35923cf34c545b0b46529a48d1b2e2c3344345184250183d5d111c70a0e6
MD5 73dea78912211cd18116be4aea804b7d
BLAKE2b-256 b7953236929042990bb384cc01aafda172db64f27c4a029556880beafb546bc0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: impedance-1.4.3-py3-none-any.whl
  • Upload date:
  • Size: 47.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.1

File hashes

Hashes for impedance-1.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 969b7b793b43e5aa5722595fce8e91e248fde31265c395495884dc588ebdf75f
MD5 e1e9c8f2dfde07384db6a600be8eb795
BLAKE2b-256 9e023e46724a43402878d429848ba814c8552b4e34f3ad5a8a5e77ed388d2196

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