Skip to content

A NLEIS toolbox for impedance.py that provides RC level nonlinear equivalent circuit modeling (nECM) and analysis

License

Notifications You must be signed in to change notification settings

yuefan98/nleis.py

 
 

Repository files navigation

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

💻 👀

About

A NLEIS toolbox for impedance.py that provides RC level nonlinear equivalent circuit modeling (nECM) and analysis

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •