DearEIS

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

Table of contents

• Getting started
  • Installing
  • Running
  • Settings and keybindings
• Features
  • Projects
  • Data sets
  • Data validation
  • Circuit fitting and simulation
  • Visualization
  • Scripting
• Changelog
• Contributors
• License

Getting started

Installing

The latest version of DearEIS requires Python 3.7 or newer (64-bit) and the most straightforward way to install DearEIS is by using pip. Make sure that pip is installed first and then type the following command into a terminal of your choice (e.g. PowerShell in Windows).

pip install deareis

Newer versions of DearEIS can be installed at a later date by appending the -U option to the command:

pip install deareis -U

Supported platforms:

• Linux
  • Primary development and testing platform.
• Windows
  • Tested on Windows 10 (x86-64).

The package may also work on other platforms (e.g. MacOS) depending on whether or not those platforms are supported by DearEIS' dependencies.

Running

Once installed, DearEIS can be started e.g. from a terminal or the Windows start menu by searching for the command deareis.

There is also a deareis-debug command that prints additional information to the terminal and can be useful when troubleshooting issues.

Settings and keybindings

DearEIS has several user-configurable settings. It is possible to configure the default values of the settings on the Kramers-Kronig, fitting, and simulation tabs as well as some aspects of the plots (e.g. colors and markers). Several keybindings, which are user-configurable, are supported for more keyboard-based navigation although a mouse or trackpad is required in some circumstances.

Features

Below is a brief overview of the main features of DearEIS. Check out the wiki for screenshots. See the included tooltips and instructions in the program for more information.

Projects

DearEIS has a project-based workflow and multiple projects can be open at the same time. Each project has a user-definable label and a section for keeping notes. Multiple projects can also be merged to form a single project.

Data sets

The experimentally obtained impedance spectra are referred to as "data sets". Each project can contain multiple data sets. Multiple noisy data sets can be averaged to produce a single data set. Individual data points can be masked to exclude outliers or to focus on a part of the spectrum. Corrections can be made by subtracting either a constant complex value, the impedance of an equivalent circuit, or another spectrum.

Data validation

Data sets can be validated by checking if they are Kramers-Kronig transformable. See pyimpspec for more details regarding the implementation of the tests.

Circuit fitting and simulation

Equivalent circuits can be constructed either by means of inputting a circuit description code (CDC) or by using the graphical, node-based circuit editor. More information about the CDC syntax can be found in the program. The circuits can be fitted to the experimental data to obtain values for the element parameters. Initial values as well as upper and lower limits can be defined for each element parameter. Element parameters can also be fixed at a constant value. The impedance spectra produced by the circuits can also be simulated in a wide frequency range. Various aspects of the circuits and the fitting results can be copied to the clipboard in different formats. For example, a table of fitted element parameters can be obtained in the form of a Markdown or LaTeX table. The mathematical expression for a circuit's impedance as a function of the applied frequency can also be obtained as e.g. a SymPy expression.

Visualization

Data sets and their corresponding results (Kramers-Kronig test or equivalent circuit fit) are visualized using simple Nyquist plots, Bode plots, and residual plots. More complex plots containing multiple data sets, Kramers-Kronig test results, equivalent circuit fitting results, and/or simulation results can also be created. These complex plots can be used to overlay and compare results more easily. However, they can also be used to create plots that can be turned into publication-ready figures with the help of a Python script (see the Scripting section for more details).

Scripting

DearEIS projects can also be used in Python scripts for the purposes of batch processing results. This capability could be used to:

• generate project files from large numbers of measurements in an automated fashion
• export the processed data to another format
• generate tables that can be included in a document written in e.g. LaTeX or Markdown
• plot publication-ready figures using e.g. matplotlib

See the Jupyter notebook for some examples. Documentation about the API can be found on the wiki.

Changelog

See CHANGELOG.md for details.

Contributors

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

License

Copyright 2022 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.