Skip to main content

A GUI program for analyzing, simulating, and visualizing impedance spectra.

Project description

DearEIS

A GUI program for analyzing, simulating, and visualizing impedance spectra.

tests build PyPI - Python Version GitHub PyPI DOI

Table of contents

About

DearEIS is a Python package that includes a program with a graphical user interface (GUI) for working with impedance spectra. An application programming interface (API) is also included that is primarily for batch processing. The target audience is researchers who use electrochemical impedance spectroscopy (EIS) though the program may also be useful in educational settings.

The GUI program implements features such as:

  • projects that can contain multiple experimental data sets and analysis results
  • reading certain data formats and parsing the experimental data contained within
  • validation of impedance spectra using linear Kramers-Kronig tests or the Z-HIT algorithm
  • estimation of the distribution of relaxation times (DRT)
  • construction of circuits, e.g., by parsing circuit description codes (CDC) or by using the included graphical editor
  • support for user-defined circuit elements
  • complex non-linear least squares fitting of equivalent circuits
  • simulation of the impedance spectra of circuits
  • visualization of impedance spectra and/or various analysis results

See the official documentation for instructions on how to install DearEIS, screenshots and guides, and the API reference.

Those who would prefer to only use an API (or a command-line interface (CLI)) for everything may wish to use pyimpspec instead.

Changelog

See CHANGELOG.md for details.

Contributing

If you wish to contribute to the further development of DearEIS, then there are several options available to you depending on your ability and the amount of time that you can spare.

If you find bugs, wish some feature was added, or find the documentation to be lacking, then please open an issue on GitHub.

If you wish to contribute code, then start by cloning the repository:

git clone https://github.com/vyrjana/DearEIS.git

The development dependencies can be installed from within the repository directory:

pip install -r ./dev-requirements.txt

Create a new branch based on either the main branch or the most recent development branch (e.g., dev-*), and submit your changes as a pull request.

Note that some of the core functionality of DearEIS is based on pyimpspec and thus certain changes (e.g., parsers for data formats) should be contributed to that project instead.

Code contributions should, if it is applicable, also include unit tests, which should be implemented in files placed in the tests folder found in the root of the repository along with any assets required by the tests. It should be possible to run the tests by executing the run_tests.sh script, which uses the test discovery built into the unittest module that is included with Python.

See CONTRIBUTORS for a list of people who have contributed to the DearEIS project.

License

Copyright 2026 DearEIS developers

DearEIS is licensed under the GPLv3 or later.

The licenses of DearEIS' dependencies and/or sources of portions of code are included in the LICENSES folder.

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

deareis-5.1.3.tar.gz (535.8 kB view details)

Uploaded Source

Built Distribution

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

deareis-5.1.3-py3-none-any.whl (668.9 kB view details)

Uploaded Python 3

File details

Details for the file deareis-5.1.3.tar.gz.

File metadata

  • Download URL: deareis-5.1.3.tar.gz
  • Upload date:
  • Size: 535.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for deareis-5.1.3.tar.gz
Algorithm Hash digest
SHA256 6787eb994657ef53354311f73e3899b15238bc0a46f0d837cb53e24fc07242d6
MD5 b3b939e89a4e568f1830a2d49a2eb9d6
BLAKE2b-256 84afbb823aecbf201cc4259684ba4f7a9cb93b4adc05c398d64dcc5b9f3ce542

See more details on using hashes here.

File details

Details for the file deareis-5.1.3-py3-none-any.whl.

File metadata

  • Download URL: deareis-5.1.3-py3-none-any.whl
  • Upload date:
  • Size: 668.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for deareis-5.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b1f0106fbbaa58df631105ae00c3308d4febffa9ca315aadf64b07946bf5ab17
MD5 f9118ce08fc438117ac89fc9ebbf86b5
BLAKE2b-256 b5603f80be93a86acbaa30527e40a676e0336a4ceb1b06af6fa42e42ad2c170f

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