eisParameterEstimator

Open interface to manually tune parameters of fractional-order equivalent circuit model

Since R2025a

Syntax

eisParameterEstimator(Name=Value)

Description

The eisParameterEstimator function opens an interface that you can use to manually tune the parameter values of a fractional-order equivalent circuit model. You can also graphically verify the accuracy of the fit against the measured data.

eisParameterEstimator(Name=Value) opens an interface to tune the parameter values of a fractional-order equivalent circuit model with the options you specify using the name-value arguments. If you do not specify a fractional-order model using the FractionalOrderModel name-value argument, the function allows you to tune a default EISModel with this circuit topology: "R0+L1+(R1,CPE1)+(R2,CPE2)+CPE3".

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: eisParameterEstimator(MeasuredData=[frequency,realZ,imagZ],FractionalOrderModel=eisfom);

MeasuredData — Measured data

[] (default) | n-by-3 matrix

Measured data, specified as a n-by-3 matrix. The first column refers to the frequency, the second and third columns refer to the real and imaginary impedance respectively.

FractionalOrderModel — Fractional-order equivalent circuit model

EISModel object (default)

Fractional-order equivalent circuit model, specified as an EISModel object.

ParameterValues — Parameter values used for frequency-based simulation

[] (default) | vector of nonnegative elements

Initial parameter values of the electrical circuit elements of the fractional-order model, specified as a vector of nonnegative elements.

Data Types: double

LowerParameterBounds — Lower parameter bounds of fractional-order equivalent circuit parameters

[] (default) | vector of nonnegative elements

Lower parameter bounds of the fractional-order equivalent circuit parameters used in the optimization, specified as a vector of nonnegative elements.

Data Types: double

UpperParameterBounds — Upper parameter bounds of fractional-order equivalent circuit parameters

[] (default) | vector of nonnegative elements

Upper parameter bounds of the fractional-order equivalent circuit parameters used in the optimization, specified as a vector of nonnegative elements.

Data Types: double

ValidFrequencyRange — Lower and upper cut-off frequency values

[1e-6,1e6] (default) | vector of two positive elements

Lower and upper cut-off values used to filter the frequency-based impedance data, specified as a vector of two positive elements.

Data Types: double

IgnoreInductiveBehavior — Option to remove all high-frequency data points that display inductive behavior

true or 1 (default) | false or 0

Option to remove all high-frequency data points that display inductive behavior, specified as "false", "true", or as numeric or logical 1 (true) or 0 (false).

Data Types: logical

IgnoreIndices — Indices to remove from frequency-based impedance data

[] (default) | positive scalar | vector of positive elements

Indices to remove from the frequency-based impedance data, specified as a scalar or vector.

Data Types: double

ImaginaryImpedanceSign — Sign convention for imaginary impedance

"standard" (default) | "reversed"

Sign convention for the imaginary impedance relative to the high-frequency inductive behavior, specified as "standard" or "reversed". The default convention treats the high-frequency inductive behavior as positive.

Data Types: string | char

Version History

Introduced in R2025a