Skip to content

Latest commit

 

History

History
75 lines (50 loc) · 5.24 KB

README.md

File metadata and controls

75 lines (50 loc) · 5.24 KB

nleis.py

Second-harmonic nonlinear electrochemical impedance spectroscopy (2nd-NLEIS), a special form of nonlinear electrochemical impedance spectroscopy (NLEIS), is emerging as a powerful complementary technique to traditional electrochemical impedance spectroscopy (EIS). It retains the experimental simplicity of EIS while providing additional physical insights. However, its adoption and application have been limited by the lack of open-source, user-friendly software.

nleis.py aims to address this gap by providing a Python toolbox that is designed to work with and extend the capabilities of impedance.py. Key features include:

  • Nonlinear equivalent circuit modeling (nECM)
  • Simultaneous analysis of EIS and 2nd-NLEIS data

This repository contains the most recent version of nleis.py. As of today, nleis.py supports the latest version of impedance.py (v1.7.1).

Installation

The nleis.py is avaliable in a standalone version now. You can install it directly with pip.

pip install nleis

See Getting started with nleis.py for instructions on how to get most of this toolbox.

In the near future, you will be able to access all the funcationality for nleis.py from impedance.py.

Dependencies

nleis.py requires the same dependencies as impedance.py puls the latest version of impedance.py:

  • Python (>=3.8)
  • SciPy (>=1.0)
  • NumPy (>=1.14)
  • Matplotlib (>=3.0)
  • Altair (>=3.0)
  • impedance(>=1.7.1)
  • pandas (>= 2.0.2)

Examples and Documentation

The detailed documentation can be found at nleispy.readthedocs.io.

Contributing to nleis.py

The nleis.py project welcomes all kinds of contributions, including bug fixes, feature requests, code reviews, new features, examples, documentation improvements, and community engagement. For any changes involving the repository, please refer to the detailed guidance in the CONTRIBUTING.md. If you encounter any issues or have suggestions, feel free to submit an issue to let us know.

We are also excited to see contributions that expand the capabilities of nleis.py. Potential future features include:

  • EIS and 2nd-NLEIS data processing from the time domain
  • Data validation for 2nd-NLEIS

Credits


This work adopted and built the nleis.py based on impedance.py (Murbach, M., Gerwe, B., Dawson-Elli, N., & Tsui, L. (2020). impedance.py: A Python package for electrochemical impedance analysis. Journal of Open Source Software, 5. https://doi.org/10.21105/joss.02349)


Contributors 🔋

Yuefan Ji
Yuefan Ji

🎨 💻 📖 ⚠️ 👀
Matt Murbach
Matt Murbach

💻 👀
Dan Schwartz
Dan Schwartz

📖 👀
Jake Anderson
Jake Anderson

💻 👀