setVariable3Values

Update values of all elements in Breakpoint3Name column of EISTest object

Since R2025a

collapse all in page

Syntax

setVariable3Values(batteryEISTest,newValues)

Description

setVariable3Values(batteryEISTest,newValues) assigns the value of the newValues argument to all the present elements in the breakpoint3Name column of the EISTest object batteryEISTest.

example

Examples

collapse all

This example shows how to update the values of all elements in the Breakpoint3Name column of the TestSummary property of an EISTest object.

Open the DownloadBatteryEISData example and load the required 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")

Store the EIS data inside an EISTest object by using the eisTest function. You can use this object to automatically extract and analyze individual impedance profiles from EIS frequency-based data.

eisExp = eisTest(eisData);

Analyze the TestSummary property of the eisExp object. This property contains a summary of the EIS test that shows all the identified profiles and related data, returned as a table.

eisExp.TestSummary
ans =

  5×7 table

    ProfileID    ImpedanceData    Breakpoint1    Breakpoint2    Breakpoint3    ProfileStartIndex    ProfileEndIndex
    _________    _____________    ___________    ___________    ___________    _________________    _______________

        1        {87×3 double}         1             25              1                  1                 100      
        2        {87×3 double}         2             25              1                101                 200      
        3        {87×3 double}         3             25              1                201                 300      
        4        {87×3 double}         4             25              1                301                 400      
        5        {87×3 double}         5             25              1                401                 500

For this example, generate a vector of five random numbers. This vector contains the values you want to replace for all profiles under the Breakpoint3 column. The number of elements in this vector must match the number of profiles in the test data.

updatedValues = rand(1,5);
updatedValues =

    0.4387    0.3816    0.7655    0.7952    0.1869

Update the values of all elements in the Breakpoint3 column of the TestSummary property by using the setVariable3Values function.

setVariable3Values(eisExp,updatedValues)

View the effects of the function by using the TestSummary property again. The function successfully updates the values of all elements inside the Breakpoint3 column.

eisExp.TestSummary
ans =

  5×7 table

    ProfileID    ImpedanceData    Breakpoint1    Breakpoint2    Breakpoint3    ProfileStartIndex    ProfileEndIndex
    _________    _____________    ___________    ___________    ___________    _________________    _______________

        1        {87×3 double}         1             25           0.43874               1                 100      
        2        {87×3 double}         2             25           0.38156             101                 200      
        3        {87×3 double}         3             25           0.76552             201                 300      
        4        {87×3 double}         4             25            0.7952             301                 400      
        5        {87×3 double}         5             25           0.18687             401                 500

Input Arguments

collapse all

Electrochemical impedance spectroscopy (EIS) test object that contains the breakpoint values to update, specified as an EISTest object.

Values to assign to the elements in the Breakpoint2Name column of the TestSummary property of the EISTest object, specified as a scalar or vector. The size of this argument must match the number of profiles in the EISTest object.

Data Types: double

Version History

Introduced in R2025a

See Also

| | |