plotMagnitudeAndPhase

R2026b

Plot magnitude and phase for profile at specific index

Since R2026b

collapse all in page

Syntax

chart = plotMagnitudeAndPhase(eisfom)
chart = plotMagnitudeAndPhase(eisfom,profileId)
chart = plotMagnitudeAndPhase(___,Name=Value)

Description

chart = plotMagnitudeAndPhase(eisfom) plots the magnitude and phase of the circuit impedance for the first profile inside the EISModel object, eisfom.

example

chart = plotMagnitudeAndPhase(eisfom,profileId) plots the magnitude and phase of the circuit impedance for the profile at the index specified by profileId inside the EISModel object, eisfom.

chart = plotMagnitudeAndPhase(___,Name=Value) also specifies options using one or more name-value arguments.

Examples

collapse all

Open the DownloadBatteryEISData example and load the required electrochemical impedance spectroscopy (EIS) data. This data has been generated from a battery with a nominal capacity of 30/1000 A*Hr at a temperature of 25 °C. This data consists of a 500-by-3 matrix of doubles. The columns of the matrix refer to the frequency, real impedance, and imaginary impedance values, respectively.

openExample("simscapebattery/DownloadBatteryEISDataExample")
load("generatedEISData.mat")

Fit the EIS data to a fractional-order equivalent circuit model. To fit the data and create an EISModel object, use the fitEISModel function.

eisfom = fitEISModel(eisData);

Plot the magnitude and phase of the circuit impedance for the first profile.

figure = plotMagnitudeAndPhase(eisfom,PlotType="combined");

Magnitude, on top, and phase, on bottom, of the circuit impedance for the first profile of the eisfom object.

Input Arguments

collapse all

Fractional-order equivalent circuit model used to plot the magnitude and phase for the specified tabulated profile, specified as an EISModel object.

Indices of the tabulated profile inside the ImpedanceData and ParameterSummary property tables of the EISModel object, specified as a nonnegative scalar.

Data Types: double

Name-Value Arguments

collapse all

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: plotMagnitudeAndPhase(myEISModel,index,Models=myEisModel2,PlotType="pairwise")

Additional fractional-order equivalent circuit models for which you want to plot the magnitude and phase, specified as a cell array of EISModel objects.

Plot presentation, specified as:

  • "combined" — Plot the magnitude and phase of all fractional-order equivalent circuit models in a single plot.

  • "pairwise" — Plot the magnitude and phase of each fractional-order equivalent circuit model separately.

Output Arguments

collapse all

Magnitude, phase, frequency, and figure handle, returned as a structure.

Version History

Introduced in R2026b

See Also

| | | | |

Topics