eisgenerator
eisgenerator is a shared libary (libeisgenerator.so) and CLI application that allows one to generate EIS spectra with high performance. The target application is genrating test and example datasets for machine lerning applications.
eisgenerator's development and target platform is UNIX, but it should compile on nigh any platform
Compile/Install
Requirements
- git
- c++20 capable compiler (GCC, CLANG)
- cmake 3.20 or later
- optional:
- gnuplot in $PATH
Procedure (UNIX)
In a console do:
- git clone https://git-ce.rwth-aachen.de/carl_philipp.klemm/eisgenerator.git
- cd eisgenerator
- mkdir build
- cd build
- cmake ..
- make
- sudo make install
Cross-compile for windows on UNIX
- Have mingw cross-compile toolchaing installed
- git clone https://git-ce.rwth-aachen.de/carl_philipp.klemm/eisgenerator.git
- cd eisgenerator
- mkdir build
- cd build
- cmake -DCMAKE_TOOLCHAIN_FILE=./crossW64.cmake ..
- make
- sudo make install
Basic usage of CLI application
Generate spectra
eisgenerator_export --model="r{1e3}-r{100}c{1e-6}" --omega=1-1e6 --omegasteps=100
flags:
--model: model string, format is simmular to RHD RelaxIS except that the implicit operator is parallel instead of serial, ie. "rc" is a resistor and condenser in parallel while "r-c" is the same in series and that parameters can be passed by adding {number} after the parameter, if an element requires more than one parameter they are specified by adding several comma seperated values in between the brackets like so: {420, 56}
- Supported Elements
- c: cap
- one parameter: capacitance {C}
- r: resistor
- one parameter: resistance {R}
- l: inductor
- one parameter: inductance {L}
- w: warburg element (infinite), one parameters {A}
- one parameter: Warburg coefficant {A}
- p: constant phase element
- two parameters: {Q, alpha}
- t: finite approximation of a transmition line
- three parameters: capacitance, resistance, approximation order {C, R, n}
- c: cap
--omega: range of freqency values (in rad/s) to sweep
--omegasteps: amount of steps to take in the range specified by --omega
further flags can be found with: eisgenerator_export --help
Plot Spectra
requires gnuplot in $PATH
eisgenerator_plot --model="r{1e3}-r{100}c{1e-6}" --omega=1-1e6 --log --omegasteps=100
Generates Nyquist plot of model specified, allows the usage of the same flags as eisgenerator_export
Python bindings
python bindings can be build seperately from: eisgeneratorpy