batteryComponentLibrary/EquivCircuit/OTCmatrix - MapleSim Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : batteryComponentLibrary/EquivCircuit/OTCmatrix

OTCmatrix

One time-constant matrix-based equivalent-circuit model of a battery

 

Description

Connections

Variables

Basic Parameters

Circuit Parameters

References

Description

The EquivCircuit.OTCmatrix component is an equivalent-circuit model of a generic battery. The open-circuit voltage is interpolated using the state-of-charge (SoC) and the internal temperature from a matrix. The transient response is modeled by an SoC-dependent resistor-capacitor network.

Degradation

The gradual decay, with use, of a cell's capacity and increase of its resistance is modeled by enabling the include degradation effects boolean parameter. Enabling this feature adds a state-of-health (soh) output to the model. This signal is 1 when the cell has no decay and 0 when is completely decayed.

The soh output is given by

soh=1sRs3

where

  

s is thickness of the solid-electrolyte interface (SEI),

  

Rs is radius of the particles of active material in the SEI.

The decay of the capacity is

C=Cmaxsoh

where

  

C is the effective capacity, and

  

Cmax is the specified capacity equal to either the parameter CA or the input Cin.

The additional series resistance added to a cell is

Rsei=sκ

with κ a parameter of the model.

The following equations govern the increase in the thickness of the SEI layer (s).

k=AeexpEaRT

dsdt={kcM1+ksDdiffρseicharging0otherwise

Thermal Effects

Select the thermal model of the battery from the heat model drop-down list.  The available models are: isothermal, external port, and convection.

Isothermal

The isothermal model sets the cell temperature to a constant parameter, Tiso.

External Port

The external port model adds a thermal port to the battery model. The temperature of the heat port is the cell temperature. The parameters mcell and cp become available and are used in the heat equation

mcellcpdTcelldt=PcellQcell

Qflow=ncellQcell

Pcell=icellvcellvoc

where Pcell is the heat generated in each cell, including chemical reactions and ohmic resistive losses, Qcell is the heat flow out of each cell, and Qflow is the heat flow out of the external port.

Convection

The convection model assumes the heat dissipation from each cell is due to uniform convection from the surface to an ambient temperature. The parameters mcell, cp, Acell, h, and Tamb become available, as does an output signal port that gives the cell temperature in Kelvin. The heat equation is the same as the heat equation for the external port, with Qcell given by

Qcell=hAcellTcellTamb

Capacity

The capacity of a cell can either be a fixed value, CA, or be controlled via an input signal, Cin, if the use capacity input box is checked.

State of Charge

A signal output, soc, gives the state-of-charge of the battery, with 0 being fully discharged and 1 being fully charged.

The parameter SOCmin sets the minimum allowable state-of-charge; if the battery is discharged past this level, the simulation is either terminated and an error message is raised, or, if the allow overdischarge parameter is true,  a warning is generated. A similar effect occurs if the battery is fully charged so that the state of charge reaches one; the simulation is terminated unless allow overcharge is true.

The parameter SOC0 assigns the initial state-of charge of the battery.

Connections

Name

Type

Description

Modelica ID

p

Electrical

Positive pin

p

n

Electrical

Negative pin

n

soc

Real output

State of charge [0..1]

soc

Cin

Real input

Sets capacity of cell, in ampere hours; available when use capacity input is true

Cin

Rin

Real input

Sets resistance of cell, in ohms; available when use cell resistance input is true

Rin

Variables

Name

Units

Description

Modelica ID

Tcell

K

Internal temperature of battery

Tcell

i

A

Current into battery

i

v

V

Voltage across battery

v

Basic Parameters

Name

Default

Units

Description

Modelica ID

Ncell

1

 

Number of cells, connected in series

Ncell

CA

1

A·h

Capacity of cell; available when use capacity input is false

C

SOC0

1

 

Initial state-of-charge [0..1]

SOC0

SOCmin

0.02

 

Minimum allowable state-of-charge

SOCmin

Rcell

0.005

Ω

Fixed cell resistance, if use cell resistance input is false

Rcell

allow overcharge

false

 

True allows simulation to continue with 1<SoC

allow_overcharge

allow overdischarge

false

 

True allows simulation to continue with SoC<SoCmin

allow_overdischarge

use capacity input

false

 

True allows enables the Cin input port

useCapacityInput

use cell resistance input

false

 

True allows enables the Rin input port

useResistInput

Circuit Parameters

Name

Default

Units

Description

Modelica ID

Voc

 

 

interpolation matrix for open-circuit voltage

Voc

Rout

 

 

interpolation table for series resistance

Rout

Rtc

 

 

interpolation table for time-constant resistance

Rtc

Ttc

 

 

interpolation table for time-constant duration

Ttc

A 1D interpolation table is a two-column Matrix. The first column is the state-of-charge, sorted, with low value (0) first. The second column is the corresponding parameter value at that state-of-charge.

References

  

[1] Chen, M. and Rincón-Mora, G.A., Accurate electrical battery model capable of predicting runtime and I-V performance, IEEE Transactions of Energy Conversion, Vol. 21, No. 2, 2006.

See Also

Battery Library Overview

Equivalent Circuit Overview