Battery Single Particle

Battery model with single-particle approach

Since R2024a

• 

Libraries:
Simscape / Battery / Cells

Description

The Battery Single Particle block models a battery using a single-particle approach. This implementation considers the ohmic and mass transport overpotentials both in the liquid electrolyte phase and in the solid electrode phase. Additionally, it considers the reaction kinetics and the current collector resistance.

The battery comprises three sections: two electrodes, the anode and cathode, and a porous separator between the electrodes. In this block, the anode refers to the negative electrode during discharge and the cathode refers to the positive electrode during discharge. The block models the ohmic overpotentials of the electrodes and electrolyte, as well as the concentration across the cell cross section from the anode current collector to the cathode current collector, in a one-dimensional framework.

This figure illustrates a representative concentration in the electrolyte during the discharge. The model comprises the anode (x=[0 … L^-]), the separator (x=[L^- … L^-+L^sep]) and the cathode (x=[L^-+L^sep… L^-+L^sep+L⁺]).

The block calculates the concentration in the electrodes in representative spherical particle across the radial dimension r. This figure shows the concentration gradient in the representative particles during a continuous discharge of the battery:

Species Conservation in Solid Phase

Note

The superscripts in these equations refer to the respective electrodes. A + superscript refers to the cathode. A - superscript refers to the anode. A sep superscript refers to the separator. A ± superscript means that the equation applies to both anode and cathode. For example, c⁺_s is the solid-phase concentration of the cathode and c^-_s is the solid-phase concentration of the anode.

In solid phase, the single-particle approach models the positive and negative electrodes as a single representative spherical particle.

This equation describes the concentration c of the cation in the negative or positive electrode by using Fick's law. The block uses the radial coordinates only to calculate the concentration in the electrodes. The diffusion in the spherical particle drives the mass transfer,

$$\frac{\partial c_s^{\pm }}{\partial t}\left(r,t\right)=\frac{\partial }{\partial r}\left[D_s^{\pm }\frac{\partial c_s^{\pm }}{\partial r}\left(r,t\right)\right],$$

where:

• c_s is the solid-phase concentration.

• D_s is the diffusion coefficient in solid phase.

• r is the radius.

• t is the time.

At the center of the particle, the concentration gradient is equal to 0:

$$D_s^{\pm }\frac{\partial c_s^{\pm }}{\partial r}\left(0,t\right)=0.$$

This equation calculates the ion concentration gradient at the surface of the particle:

$$D_s^{\pm }\frac{\partial c_s^{\pm }}{\partial r}\left(R_s^{\pm },t\right)=\mp \frac{J_s^{\pm }}{a_s^{\pm }F}.$$

In this equation,

• J is the molar flux:

  $$J^{\pm }(t)=\frac{I(t)}{A{L}^{\pm }},$$

  where:

  • I is the current applied to the cell.

  • A is the total area of the current collector.

  • L is the length of the respective electrode.

• a is the active surface area per electrode unit volume:

  $$a^{\pm }=\frac{3{\epsilon }^{\pm }}{R^{\pm }},$$

  where:

  • ε is the active material fraction of the electrode.

  • R is the total radius of the active particle.

• F is the Faraday's constant.

To solve the differential equation, the Battery Single Particle block discretizes the particle with the radius R into n shells. Each shell has a radial distance equal to $$\delta r=\frac{R}{(n-1)}$$ from the adjacent spheres.

For the ith sphere, this equation calculates the rate of change of concentration, δc/δt:

$${\dot{c}}_{s_i}=\frac{D_s}{\delta r^2}\left\{\left(\frac{i-1}{i}\right)c_{s_{i-1}}-2c_{s_i}+\left(\frac{i+1}{i}\right)c_{s_{i+1}}\right\}.$$

For the innermost shell in the particle, the block implements this boundary condition:

$${\dot{c}}_1=\frac{2D_s}{\delta r^2}\left\{c_{s_2}-c_{s_1}\right\}.$$

To implement the boundary condition at the surface of the particle, the block adds an additional "ghost" node around the surface. The concentration of this ghost node is not calculated as it does not physically exist. The addition of this ghost node allows the block to calculate the boundary condition between the outermost shell in the particle and the additional non-existent shell around it by using the Neumann boundary condition. This equation describes the discretized result at the surface of the particle:

$${\dot{c}}_{s_{end}}=\frac{2D_s}{\delta r^2}\left\{c_{s_{end-1}}-c_{s_{end}}\right\}-2\frac{n}{n-1}\frac{J}{FA\delta r}.$$

Mass Transport Overpotential in Solid Phase

The open-circuit potential depends on the concentration. To calculate the mass transport overpotential at the electrodes, the Battery Single Particle block subtracts the open-circuit potential of the average relative concentration in the particle from the open-circuit potential of the average relative concentration at the surface,

$${\eta }^{\pm }{}_{\text{diffusion},s}={\text{ocp}}^{\pm }\left(c_{s,\text{surface},\text{relative}}^{\pm }\right)-{\text{ocp}}^{\pm }\left({\overline{c}}_{s,\text{relative}}^{\pm }\right),$$

where:

• η_diffusion,s is the solid-phase mass transport overpotential.

• ocp(c_s,_{surface,relative}) is the open-circuit potential for the concentration at the surface of the particle.

• ocp(c_srelative) is the open-circuit potential for the average concentration of the particle.

The block uses the same equation to calculate the mass transport overpotential in solid phase for both the anode and the cathode.

Ohmic Overpotential in Solid Phase

To calculate the ohmic overpotential in the solid phase, the Battery Single Particle block linearly approximates the current across the electrodes. The block also approximates the current at the current collector to a value equal to the electric current applied to the cell. The current at the interface between the current separator and the electrode is zero. This equation defines the ohmic overpotential in the solid phase,

$${\eta }^{\pm }{}_{ohmic,s}=\frac{I_{batt}}{2A}\ast \frac{L^{\pm }}{{\kappa }^{\pm }},$$

where:

• η_ohmic,s is the solid-phase ohmic overpotential.

• I_batt/A is the cell cross section.

• L is the length of the respective electrode and depends on the thickness of the anode or cathode.

• κ is the conductivity. The conductivity depends on the temperature of the cell. κ is equal to the Anode conductivity parameter when the block calculates the ohmic overpotential of the anode and is equal to the Cathode conductivity parameter when the block calculates the ohmic overpotential of the cathode.

The block uses the same equation to calculate the ohmic overpotential in solid phase for both the anode and the cathode.

Species Conservation in Liquid Phase

This equation describes the concentration in the electrolyte at both electrodes and at the separator. To calculate the concentration across the separator, the model considers the diffusive flow induced by concentration gradient:

$$\frac{\partial c_{\epsilon }^{\pm }}{\partial t}\left(x,t\right)=\frac{\partial }{\partial x}\left[D_{\epsilon }\frac{\partial c_{\epsilon }^{\pm }}{\partial x}\left(x,t\right)\right],$$

where:

• c_ε is the concentration in the electrolyte.

• D_ε is the diffusion coefficient in liquid phase.

• x is the location in the thickness of the battery, from the anode current collector to the cathode current collector.

• t is the time.

At the positive and negative electrodes, the block considers both the diffusive flow and the cation flux from the solid electrode into the electrolyte:

$${\in }_{\epsilon }^{\pm }\frac{\partial c_{\epsilon }^{\pm }}{\partial t}\left(x,t\right)=\frac{\partial }{\partial x}\left[D_{\epsilon }^{eff}\frac{\partial c_{\epsilon }^{\pm }}{\partial x}\left(x,t\right)\pm \frac{\left(1-t_{+}^0\right)J}{F}\right],$$

where:

• ∈ is the volume fraction of the electrolyte.

• D^eff_ε is the diffusion coefficient in liquid phase that considers the porosity of the material. The diffusivity of the liquid electrolyte depends on the properties of the surrounded solid electrode material. The electrode comprises multiple components, such as the active material and the filler, which form a characteristic porous material.

• J is the molar flux.

• t⁺ is the transference number of the cation.

• F is the Faraday's constant.

As the electrolyte is a continuous fluid, the cation concentration at the border between the negative and positive electrode and the separator must be equal. For the concentration in the electrolyte at the anode-separator and cathode-separator interfaces, the block must define the boundary conditions between the three sections of the battery. The block represents both electrodes and the separator as cuboids.

This block considers the electrolyte as a continuous medium across the electrodes and the separator. As the concentrations on both sides of the interface must be equal, a continuity boundary condition exists for the interface between the electrodes and the separator.

This equation describes the continuity boundary condition for the concentration at the interface between the anode and the separator,

$$c_{\epsilon }^{-}\left(L^{-},t\right)=c_{\epsilon }^{sep}\left(L^{-},t\right),$$

where:

• $$c_{\epsilon }^{-}\left(L^{-},t\right)$$ is the concentration in the anode at the border between the anode and the separator.

• $$c_{\epsilon }^{sep}\left(L^{-},t\right)$$ is the concentration in the separator at the border between the anode and the separator.

This equation describes the continuity boundary condition for the concentration at the interface between separator and cathode,

$$c_{\epsilon }^{sep}\left(L^{-}+L^{sep},t\right)=c_{\epsilon }^{+}\left(L^{-}+L^{sep},t\right),$$

where:

• $$c_{\epsilon }^{sep}\left(L^{-}+L^{sep},t\right)$$ is the concentration in the separator at the border between the separator and the cathode.

• $$c_{\epsilon }^{+}\left(L^{-}+L^{sep},t\right)$$ is the concentration in the cathode at the border between the separator and the cathode.

The block also applies a flux boundary condition to the interfaces between the electrodes and the separator. There, the flux at both sides of the interface must be equal,

$$\begin{array}{l}{D}_{eff}^{-}\frac{\partial c_{\epsilon }^{-}}{\partial x}\left(L^{-},t\right)=D_{eff}^{sep}\frac{\partial c_{\epsilon }^{sep}}{\partial x}\left(L^{-},t\right)\\ D_{eff}^{+}\frac{\partial c_{\epsilon }^{+}}{\partial x}\left(L^{-}+L^{sep},t\right)=D_{eff}^{sep}\frac{\partial c_{\epsilon }^{sep}}{\partial x}\left(L^{-}+L^{sep},t\right)\end{array}$$

where:

• $$D_{eff}^{-}$$ is the diffusion coefficient of the anode.

• $$D_{eff}^{+}$$ is the diffusion coefficient of the cathode.

• $$D_{eff}^{sep}$$ is the diffusion coefficient of the separator.

• $$\frac{\partial c_{\epsilon }^{-}}{\partial x}\left(L^{-},t\right)$$ is the concentration gradient of the anode at the border between the anode and the separator.

• $$\frac{\partial c_{\epsilon }^{sep}}{\partial x}\left(L^{-},t\right)$$ is the concentration gradient of the separator at the border between the anode and the separator.

• $$\frac{\partial c_{\epsilon }^{+}}{\partial x}\left(L^{-}+L^{sep},t\right)$$ is the concentration gradient of the cathode at the border between the cathode and the separator.

• $$\frac{\partial c_{\epsilon }^{sep}}{\partial x}\left(L^{-}+L^{sep},t\right)$$ is the concentration gradient of the separator at the border between the cathode and the separator.

This equation specifies the concentration at the boundaries between the electrodes and the current collectors. The flux is proportional to the flux at the current collector, which is equal to zero since the model does not store any ions there. Hence the resulting flux at the interface is zero,

$$\frac{\partial c_{\epsilon }^{-}}{\partial x}\left(0,t\right)=\frac{\partial c_{\epsilon }^{+}}{\partial x}\left(L^{-}+L^{sep}+L^{+},t\right)=0,$$

where:

• $$\frac{\partial c_{\epsilon }^{-}}{\partial x}\left(0,t\right)$$ is the concentration gradient in the anode at the border between the anode and the leftmost current collector.

• $$\frac{\partial c_{\epsilon }^{+}}{\partial x}\left(L^{-}+L^{sep}+L^{+},t\right)$$ is the concentration gradient in the cathode at the border between the cathode and the rightmost current collector.

Similar to the solid phase, to solve the differential equation, the block divides the electrolyte into n sections of equal size. This equation expresses the concentration in the ith section with a distance δx between sections, and it is valid for all [1,M_s-1] sections:

$$\frac{\partial c_{\epsilon }}{\partial t}\left(x,t\right)=D_{\epsilon ,eff}^{\pm }\frac{c_{i+1}+c_{i-1}-2c_i}{\partial x^2}+\frac{\left(1-t_{+}^0\right)J}{F}.$$

The block discretizes the separator using this equation:

$$\frac{\partial c_{\epsilon }}{\partial t}\left(x,t\right)=D_{\epsilon ,eff}^{sep}\frac{c{}_{i+1}+c_{i-1}-2c_i}{\delta x^2}.$$

To calculate the concentrations at the interfaces between the electrodes and the separator, the block applies all the boundary conditions. For example, for the interface between the anode and the separator, the block applies this equation:

$$c_{\epsilon ,i=1}^{sep}=\frac{{\epsilon }_{\epsilon }^{-}}{{\epsilon }_{\epsilon }^{sep}}\frac{c_{\epsilon ,i=0}-c_{\epsilon ,i=-1}^{sep}}{\partial x}\partial x-c_{\epsilon ,i=0}.$$

Mass Transport Overpotential in Liquid Phase

Using the concentrations at the interfaces between the current Collector and the anode and at the interfaces between the cathode and the current collector, the block calculates the mass transport overpotential in the electrolyte using this equation,

$${\eta }_{diffusion,\epsilon }=\frac{2RT}{F}\left(1-t_{\epsilon }^0\right)\ln \frac{c_{\epsilon }\left(L^{-}+L^{sep}+L^{+},t\right)}{c_{\epsilon }\left(0,t\right)},$$

where:

• R is the universal gas constant.

• T is the temperature.

• F is the Faraday's constant.

Ohmic Overpotential in Liquid Phase

To calculate the ohmic overpotential in the liquid phase, the block linearly approximates the ionic current in each section of the battery. For the electrodes, the ionic current at the interface to the current collector is zero. At the interface to the separator, the ionic current is equal to the electric current of the battery I_batt. Across the separator, the block approximates the ionic current as constant and equal to the electric current applied to the battery. Considering these approximations, the block calculates the ohmic overpotential using this equation,

$${\eta }_{ohmic,\epsilon }=-\frac{I_{batt}}{2A}\ast \left(\frac{L^{+}}{{\kappa }_{eff}{}^{+}}+2\frac{L^{sep}}{{\kappa }_{eff}{}^{sep}}+\frac{L^{-}}{{\kappa }_{eff}{}^{-}}\right),$$

where κ_eff is the effective conductivity that the block calculates by using the Bruggeman coefficient. For more information about effective parameters, see the Effective Electrolyte Properties section.

Charge Transfer Overpotential

To model the charge transfer overpotential, this block uses the Butler-Volmer equation. The Butler-Volmer equation describes the relationship between the current density, j, and the overpotential, η, which is the difference between the actual electrode potential and the thermodynamic equilibrium potential. Under the assumption of equal charge transfer coefficient, α, the Butler-Volmer equation is

$$J^{\pm }\left(t\right)=j_{0,k}\left(t\right)\left[\exp \left(\frac{\alpha n_{\epsilon }F}{RT}{\eta }^{\pm }\left(t\right)\right)-\exp \left(-\frac{\left(1-\alpha \right)n_{\epsilon }F}{RT}{\eta }^{\pm }\left(t\right)\right)\right],$$

where:

• α is the charge transfer coefficient for the oxidation and reduction.

• j₀ is the exchange current density.

Solving the equation for the electrode overpotential results in these equations:

$$\begin{array}{l}{\eta }_{\text{kinetic,s}}=\frac{RT}{\alpha F}\ln \left({\xi }^{\pm }+\sqrt{{\left({\xi }^{\pm }\right)}^2+1}\right)\\ {\xi }^{\pm }=\frac{j^{\pm }}{2a^{\pm }{i}_0^{\pm }}\end{array}$$

i^±₀ is the exchange current density in the anode and in the cathode and is equal to

$$i_0^{\pm }=k^{\pm }{\left[{\overline{c}}_{\epsilon }^{\pm }\left(c_{s,\max }^{\pm }-c_{s,surf}^{\pm }\right)c_{s,surf}^{\pm }\right]}^{\alpha },$$

where:

• k is the charge transfer rate constant and is equal to the value of the Charge transfer rate constant for Anode parameter for the anode and to the value of the Charge transfer rate constant for Cathode parameter for the cathode.

• $${\overline{c}}_{\epsilon }^{\pm }$$ is the average electrolyte concentration.

• c_s,max is the maximum electrode concentration.

• c_s,surf is the electrode surface concentration.

To calculate the kinetic overpotential of the complete cell, the block subtracts the kinetic overpotential at the anode from the kinetic overpotential at the cathode:

$${\eta }_{\text{kinetic,s}}={\eta }^{+}{}_{\text{kinetic,s}}-{\eta }^{-}{}_{\text{kinetic,s}}.$$

Current Collector Resistance

This block models the current collector resistance as a single resistance. You can set the current collector resistance by specifying the Current collector resistance parameter.

Cell Voltage

To model the cell voltage, this block considers the potentials at the surfaces of each electrode, the overpotentials, and the voltage loss due to the current collector resistance and uses this equation,

$$V\left(t\right)={\text{ocp}}^{+}(c_{\text{surface,relative}}^{+})-{\text{ocp}}^{-}(c_{\text{surface,relative}}^{-})+{\eta }_{\text{diffusion},\epsilon }+{\eta }_{ohmic,\epsilon }+{\eta }_{\text{kinetic},s}+{\eta }_{ohmic}^{-}+{\eta }_{ohmic}^{+}+I_{\text{batt}}{R}_{\text{CurrentCollector}},$$

where:

• ocp⁺(c⁺_{surface,relative}) is the open-circuit potential for the concentration at the surface of the cathode particle.

• ocp^-(c^-_{surface,relative}) is the open-circuit potential for the concentration at the surface of the anode particle.

• η_diffusion,ε is the mass transport overpotential in the electrolyte.

• η_ohmic,ε is the ohmic overpotential in the electrolyte.

• η_kinetic,s is the charge transfer overpotential in the electrodes.

• η^-_ohmic is the ohmic overpotential in the anode.

• η⁺_ohmic is the ohmic overpotential in the cathode.

• I_batt is the battery current.

• R_{CurrentCollector} is the resistance of the current collector.

You can parameterize the open-circuit potential as table data with the relative concentration as the breakpoints by specifying the Anode open-circuit potential, Cathode open-circuit potential, and Normalized stoichiometry breakpoints parameters.

To calculate the relative concentration, the block considers the maximum concentration and the maximum and minimum stoichiometry of each electrode. The Anode maximum ion concentration and the Cathode maximum ion concentration parameters represent the theoretically possible maximum concentration of each electrode. To obtain the achievable maximum and minimum concentrations, the block multiplies the values of these two parameters with the value of the Anode maximum stoichiometry, Anode minimum stoichiometry, Cathode maximum stoichiometry, and Cathode minimum stoichiometry parameters, respectively. Then, the block calculates the relative concentration by using this equation,

$$c_{\text{s,relative}}=\frac{\frac{c_s}{c_{s,\max }}-{{\rm N}}_{\min }}{{{\rm N}}_{\max }-{{\rm N}}_{\min }},$$

where:

• c_s,_max is the maximum concentration.

• N_max is the maximum stoichiometry.

• N_min is the minimum stoichiometry.

Effective Electrolyte Properties

These block parameters depend on the microstructure of the porous electrodes:

• Diffusion coefficient of electrolyte — Diffusion coefficient of electrolyte that influences the mass transport in the electrolyte.

• Electrolyte conductivity — Conductivity of the electrolyte.

To model this dependency, this block uses the Bruggeman correlation,

$${\text{Parameter}}_{\text{effective}}={\text{Parameter}}_{\text{block}}\ast {\phi }_{\epsilon }{}^{\alpha },$$

where:

• φ_ε is the volume fraction of the electrolyte and is equal to the value of the Volume fraction of electrolyte in anode, Volume fraction of electrolyte in separator, and Volume fraction of electrolyte in cathode parameters, accordingly.

• α is the Bruggeman exponent and is equal to the value of the Anode Bruggeman exponent, Separator Bruggeman exponent, and Cathode Bruggeman exponent parameters, accordingly.

Thermal

Certain block parameters depend on the temperature of the cell. The block considers the temperature constant across the cell. These are the temperature-dependent parameters:

• Diffusion coefficient of anode active material and Diffusion coefficient of cathode active material— Diffusion coefficients of electrodes that influence the mass transport in the electrodes.

• Diffusion coefficient of electrolyte — Diffusion coefficient of electrolyte that influences the mass transport in the electrolyte.

• Electrolyte conductivity — Conductivity of the electrolyte.

• Anode conductivity and Cathode conductivity — Conductivity of the electrodes.

• Charge transfer rate constant for Anode and Charge transfer rate constant for Cathode — Charge transfer rate constants of the electrodes.

To calculate the temperature-adjusted values of these parameters, the block uses the Arrhenius equation,

$${\text{Parameter}}_{\text{T-adjusted}}={\text{Parameter}}_{\text{block}}\ast e^{\frac{E_a}{R}\left(\frac{1}{T_{ref}}-\frac{1}{T}\right)},$$

where:

• Parameter_block is the value of the temperature-dependent parameters as you specify them inside the block.

• E_a is the activation energy and is equal to the value of the activation energy parameters in the Thermal settings of the Property Inspector.

• T_ref is the value of the Arrhenius reference temperature parameter.

• T is the battery temperature.

Heat Generation

This block models the battery as a lumped thermal mass. The single particle model calculates the irreversible heat generation that the overpotentials cause in the battery by using this equation:

$$Q=I_{batt}\left({\eta }_{\text{diffusion},\epsilon }+{\eta }_{ohmic,\epsilon }+{\eta }_{ohmic,s}^{-}+{\eta }_{ohmic,s}^{+}+I_{\text{batt}}{R}_{\text{CurrentCollector}}+{\eta }_{\text{kinetic},s}+{\eta }^{+}{}_{\text{diffusion}}+{\eta }^{-}{}_{\text{diffusion}}\right).$$

Public Variables (Visible with Probe Block)

The Battery Single Particle block comprises these public variables that you can probe using the Probe block. The units are the default values.

• anodeModel.averageStoichiometry — Average stoichiometry in the anode.

• anodeModel.massTransportOverpotential — Mass transport overpotential, in volt.

• anodeModel.normalizedAverageStoichiometry — Average stoichiometry normalized to the minimum and maximum values.

• anodeModel.normalizedSurfaceStoichiometry — Surface stoichiometry normalized to the minimum and maximum values.

• anodeModel.ohmicOverpotential — Ohmic overpotential of the anode, in volt.

• anodeModel.shellConcentration — Concentration of the modeled shells, in mol/m^3. The number of shells is equal to the value of the Anode Shell Count parameter.

• anodeModel.shellStoichiometry — Stoichiometry of the modeled shells. The number of shells is equal to the Anode Shell Count parameter.

• anodeModel.surfaceConcentration — Concentration at the surface of the particle, in mol/m^3.

• anodeModel.surfacePotential — Potential at the surface of the particle, in volt.

• anodeModel.temperatureAdjustedConductivity — Conductivity adjusted to the battery temperature, in S/m.

• anodeModel.temperatureAdjustedDiffusionCoefficient — Diffusion coefficient adjusted to the battery temperature, in m^2/s.

• averageElectrolyteConcentration — Average concentration in the particle, in mol/m^3.

• batteryCurrent — Total current measured through the battery terminals, in ampere.

• batteryTemperature — Battery average temperature that the block uses for the table look-up of resistances and open-circuit voltage. If you set the Thermal model parameter to Constant temperature, then the batteryTemperature variable is equal to the specified temperature value. If you set the Thermal model parameter to Lumped thermal mass, then the batteryTemperature variable is a differential state that varies during the simulation.

• batteryVoltage — Battery terminal voltage, or the voltage difference between the positive and the negative terminals, in volt.

• cathodeModel.averageStoichiometry — Average stoichiometry in the cathode.

• cathodeModel.massTransportOverpotential — Mass transport overpotential, in volt.

• cathodeModel.normalizedAverageStoichiometry — Average stoichiometry normalized to the minimum and maximum values.

• cathodeModel.normalizedSurfaceStoichiometry — Surface stoichiometry normalized to the minimum and maximum values.

• cathodeModel.ohmicOverpotential — Ohmic overpotential of the cathode, in volt.

• cathodeModel.shellConcentration — Concentration of the modeled shells, in mol/m^3. The number of shells is equal to the value of the Anode Shell Count parameter.

• cathodeModel.shellStoichiometry — Stoichiometry of the modeled shells. The number of shells is equal to the Anode Shell Count parameter.

• cathodeModel.surfaceConcentration — Concentration at the surface of the particle, in mol/m^3.

• cathodeModel.surfacePotential — Potential at the surface of the particle, in volt.

• cathodeModel.temperatureAdjustedConductivity — Conductivity adjusted to the battery temperature, in S/m.

• cathodeModel.temperatureAdjustedDiffusionCoefficient — Diffusion coefficient adjusted to the battery temperature, in m^2/s.

• electrolyteModel.averageConcentration — Average concentration in the electrolyte across the whole cell, in mol/m^3.

• electrolyteModel.averageConcentrationAnode — Average concentration in the electrolyte inside the anode, in mol/m^3.

• electrolyteModel.averageConcentrationCathode — Average concentration in the electrolyte inside the cathode, in mol/m^3.

• electrolyteModel.averageConcentrationSeparator — Average concentration in the electrolyte inside the separator, in mol/m^3.

• electrolyteModel.concentrationAnode — Concentration of the modeled layers of the electrolyte in the anode, in mol/m^3. The number of elements is equal to the Electrolyte layer count of anode parameter.

• electrolyteModel.concentrationCathode — Concentration of the modeled layers of the electrolyte in the cathode, in mol/m^3. The number of elements is equal to the Electrolyte layer count of cathode parameter.

• electrolyteModel.concentrationSeparator — Concentration of the modeled layers of the electrolyte in the separator, in mol/m^3. The number of elements is equal to the Electrolyte layer count of electrolyte parameter.

• electrolyteModel.currentDensityAnode — Current density in the anode, in A/m^3.

• electrolyteModel.currentDensityCathode — Current density in the cathode, in A/m^3.

• electrolyteModel.diffusionCoefficientAnode — Temperature-adjusted effective diffusion coefficient of the electrolyte in the anode, in m^s/s.

• electrolyteModel.diffusionCoefficientCathode — Temperature-adjusted effective diffusion coefficient of the electrolyte in the cathode, in m^s/s.

• electrolyteModel.diffusionCoefficientSeparator — Temperature-adjusted effective diffusion coefficient of the electrolyte in the separator, in m^s/s.

• electrolyteModel.conductivityAnode — Temperature-adjusted effective conductivity of the electrolyte in the anode, in S/m.

• electrolyteModel.conductivityCathode — Temperature-adjusted effective conductivity of the electrolyte in the cathode, in S/m.

• electrolyteModel.effectiveConductivitySeparator — Temperature-adjusted effective conductivity of the electrolyte in the separator, in S/m.

• electrolyteModel.massTransportOverpotential — Mass transport overpotential of the electrolyte, in volt.

• electrolyteModel.ohmicOverpotential — Ohmic overpotential of the electrolyte, in volt.

• electrolyteModel.temperatureAdjustedConductivity — Temperature-adjusted conductivity of the electrolyte, in S/m.

• electrolyteModel.temperatureAdjustedDiffusionCoefficient — Temperature adjusted diffusion coefficient of the electrolyte, in m^s/s.

• heatGenerationRate — Total battery heat generation rate, in watt. The block calculates the heat generation rate by adding up all resistive losses, reversible heating contribution, and the exothermic reaction heat if you enabled an exothermic fault.

• power_dissipated — Resistive heat generation rate or dissipated power, in watt.

• reactionKineticsModel.chargeTransferOverpotential — Charge transfer overpotential of the battery, in volt.

• reactionKineticsModel.exchangeCurrentDensityAnode — Exchange current density in the anode, in C/(m^2*s).

• reactionKineticsModel.exchangeCurrentDensityCathode — Exchange current density in the cathode, in C/(m^2*s).

• reactionKineticsModel.temperatureAdjustedChargeTransferRateAnode — Temperature-adjusted charge transfer rate constant for the anode, in m^(5/2)/(mol^(1/2) * s).

• reactionKineticsModel.temperatureAdjustedChargeTransferRateCathode — Temperature-adjusted charge transfer rate constant for the cathode, in m^(5/2)/(mol^(1/2) * s).

• stateOfCharge — Battery state of charge obtained from coulomb counting.

• thermalModel.batteryTemperature — Temperature of the battery, in K.

• thermalModel.cellTemperature — Temperature of the cell, as an output.

• thermalModel.heatDissipationRate — Heat dissipation rate of the battery, in watt.

• thermalModel.heatGeneration — Heat that the battery generates, in watt.

• thermalModel.thermalMass — Thermal mass of the battery, in J/K.

Ports

Conserving

+ — Positive terminal

electrical

Electrical conserving port associated with the battery positive terminal.

- — Negative terminal

electrical

Electrical conserving port associated with the battery negative terminal.

H — Battery thermal mass

thermal

Thermal conserving port associated with the battery thermal mass.

Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink^® Toolstrip, on the Simulation tab, in the Prepare gallery, select Property Inspector.

Main

Extrapolation method for all tables — Method of extrapolation for tables

Nearest (default) | Linear | Error

Extrapolation method for all the table-based parameters:

• Linear — Estimate values beyond the data by creating a tangent line at the end of the known data and extending it beyond that limit.

• Nearest — Extrapolate a value at a query point that is the value at the nearest sample grid point.

• Error — Return an error if the value goes beyond the known data. If you select this option, the block does not use extrapolation.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

Parameter:	ExtrapolationMethod
Values:	"nearest" (default) | "linear" | "error"

Geometry

Anode thickness — Thickness of anode

3.4E-5 m (default) | positive scalar

Thickness of the anode.

Electrolyte layer count of anode — Electrolyte layer count of anode

10 (default) | scalar greater than 3

Electrolyte layer count of the anode.

Separator thickness — Thickness of separator

2.5E-5m (default) | positive scalar

Thickness of the separator.

Electrolyte layer count of separator — Electrolyte layer count of separator

5 (default) | scalar greater than 3

Electrolyte layer count of the separator.

Cathode thickness — Thickness of cathode

8E-5m (default) | positive scalar

Thickness of the cathode.

Electrolyte layer count of cathode — Electrolyte layer count of cathode

10 (default) | scalar greater than 3

Electrolyte layer count of the cathode.

Electrode plate area — Area of electrode plate

1.8E-1m^2 (default) | positive scalar

Area of the electrode plate.

Anode particle radius — Particle radius of anode

5E-6m (default) | positive scalar

Particle radius of the anode.

Anode shell count — Number of shells for anode

10 (default) | positive scalar greater than 3

Number of shells for the anode.

Cathode particle radius — Particle radius of cathode

5E-8m (default) | positive scalar

Particle radius of the cathode.

Cathode shell count — Number of shells for cathode

10 (default) | positive scalar greater than 3

Number of shells for the cathode.

Electrodes properties

Volume fraction of anode active material — Volume fraction of active material in anode

0.58 (default) | scalar in the range (0,1)

Volume fraction of the active material in the anode.

Volume fraction of cathode active material — Volume fraction of active material in cathode

0.374 (default) | scalar in the range (0,1)

Volume fraction of the active material in the cathode.

Anode open-circuit potential — Open-circuit potential of anode

[.484; .335; .253; .209; .2; .181; .165; .151; .139; .131; .128; .125; .124; .124; .123; .122; .119; .117; .111; .108; .101; .098; .095; .093; .092; .088; .088; .088; .088; .087; .087; .087; .085; .082; .079; .071; .064; .049; .026] V (default) | vector of positive elements

Open-circuit potential of the anode. The size of this parameter must be equal to the size of the Normalized stoichiometry breakpoints parameter.

Cathode open-circuit potential — Open-circuit potential of cathode

[3.81; 3.608; 3.512; 3.478; 3.459; 3.453; 3.453; 3.452; 3.452; 3.452; 3.451; 3.451; 3.451; 3.45; 3.45; 3.45; 3.449; 3.449; 3.449; 3.448; 3.448; 3.448; 3.447; 3.447; 3.447; 3.446; 3.446; 3.446; 3.445; 3.445; 3.445; 3.444; 3.444; 3.444; 3.442; 3.44; 3.412; 3.304; 2.968] V (default) | vector of positive elements

Open-circuit potential of the cathode. The size of this parameter must be equal to the size of the Normalized stoichiometry breakpoints parameter.

Normalized stoichiometry breakpoints — Stoichiometry breakpoints for open-circuit potential of electrode

linspace(0.025, 0.975, 39) (default) | vector of elements in the range [0,1]

Stoichiometry breakpoints for the open-circuit potential of the electrode. The size of this parameter must be equal to the size of the Anode open-circuit potential and Cathode open-circuit potential parameters.

Anode maximum ion concentration — Maximum ion concentration in anode

30555 mol/m^3 (default) | positive scalar

Maximum ion concentration in the anode.

Anode maximum stoichiometry — Maximum stoichiometry in anode

0.811 (default) | positive scalar

Maximum stoichiometry in the anode. The value of this parameter must be greater than the value of the Anode minimum stoichiometry parameter.

Anode minimum stoichiometry — Minimum stoichiometry in anode

0.0132 (default) | positive scalar

Minimum stoichiometry in the anode. The value of this parameter must be less than the value of the Anode maximum stoichiometry parameter.

Cathode maximum ion concentration — Maximum ion concentration in cathode

22806 mol/m^3 (default) | positive scalar

Maximum ion concentration in the cathode.

Cathode maximum stoichiometry — Maximum stoichiometry in cathode

0.74 (default) | positive scalar

Maximum stoichiometry in the cathode. The value of this parameter must be greater than the value of the Cathode minimum stoichiometry parameter.

Cathode minimum stoichiometry — Minimum stoichiometry in cathode

0.035 (default) | positive scalar

Minimum stoichiometry in the cathode. The value of this parameter must be less than the value of the Cathode maximum stoichiometry parameter.

Diffusion coefficient of anode active material — Diffusion coefficient of active material in anode

3E-15 m^2/s (default) | positive scalar

Diffusion coefficient of the active material in the anode.

Diffusion coefficient of cathode active material — Diffusion coefficient of active material in cathode

5.9E-20 m^2/s (default) | positive scalar

Diffusion coefficient of the active material in the cathode.

Anode conductivity — Conductivity of anode

100 S/m (default) | positive scalar

Conductivity of the anode.

Cathode conductivity — Conductivity of cathode

0.5 S/m (default) | positive scalar

Conductivity of the cathode.

Current collector resistance — Resistance of current collector

0 Ohm (default) | nonnegative scalar

Resistance of the current collector.

Electrolyte properties

Volume fraction of electrolyte in anode — Fraction of volume of electrolyte in anode

0.3874 (default) | scalar in the range (0,1)

Fraction of the volume of the electrolyte in the anode.

Volume fraction of electrolyte in separator — Fraction of volume of electrolyte in separator

0.45 (default) | scalar in the range (0,1)

Fraction of the volume of the electrolyte in the separator.

Volume fraction of electrolyte in cathode — Fraction of volume of electrolyte in cathode

0.5725 (default) | scalar in the range (0,1)

Fraction of the volume of the electrolyte in the cathode.

Electrolyte conductivity — Conductivity of electrolyte

0.29 S/m (default) | positive scalar

Conductivity of the electrolyte.

Anode Bruggeman exponent — Bruggeman exponent of anode

1.5 (default) | scalar greater than or equal to 1

Bruggeman exponent of the anode.

Separator Bruggeman exponent — Bruggeman exponent of separator

1.5 (default) | scalar greater than or equal to 1

Bruggeman exponent of the separator.

Cathode Bruggeman exponent — Bruggeman exponent of cathode

1.5 (default) | scalar greater than or equal to 1

Bruggeman exponent of the cathode.

Transference number — Fraction of total electric current that ion carries in electrolyte

0.363 (default) | scalar in the range [0,1]

Fraction of the total electric current that an ion carries in an electrolyte.

Diffusion coefficient of electrolyte — Diffusion coefficient of electrolyte

2E-10 m^2/s (default) | positive scalar

Diffusion coefficient of the electrolyte that the block uses inside the Fick's Law equation.

Reaction kinetics

Charge transfer rate constant for Anode — Rate constant of charge transfer for anode

8.8E-11 m^(5/2)/(mol^(1/2)*s) (default) | positive scalar

Rate constant of the charge transfer for the anode. The block uses this value in the Butler-Volmer equation to model the electrochemical kinetics at the electrode-electrolyte interface in a single particle model.

Charge transfer rate constant for Cathode — Rate constant of charge transfer for cathode

2.8E-13 m^(5/2)/(mol^(1/2)*s) (default) | positive scalar

Rate constant of the charge transfer for the cathode. The block uses this value in the Butler-Volmer equation to model the electrochemical kinetics at the electrode-electrolyte interface in a single particle model.

Thermal

Battery thermal mass — Thermal mass of battery associated with thermal port

77 J/K (default) | positive scalar

Thermal mass of the battery associated with the thermal port H. This parameter represents the energy required to raise the temperature of the thermal port by one kelvin.

Arrhenius reference temperature — Arrhenius reference temperature

298.15 K (default) | positive scalar

Arrhenius reference temperature.

Activation energy for diffusion in anode active material — Activation energy for diffusion inside active material of anode

39000 J/mol (default) | positive scalar

Activation energy for the diffusion inside the active material of the anode.

Activation energy for diffusion in cathode active material — Activation energy for diffusion inside active material of cathode

35000 J/mol (default) | positive scalar

Activation energy for the diffusion inside the active material of the cathode.

Activation energy for diffusion in electrolyte — Activation energy for diffusion inside electrolyte

26600 J/mol (default) | positive scalar

Activation energy for the diffusion inside the electrolyte.

Activation energy for conduction in anode — Activation energy for conduction inside anode

3000 J/mol (default) | positive scalar

Activation energy for the conduction inside the anode.

Activation energy for conduction in cathode — Activation energy for conduction inside cathode

3000 J/mol (default) | positive scalar

Activation energy for the conduction inside the cathode.

Activation energy for conduction in electrolyte — Activation energy for conduction inside electrolyte

11000 J/mol (default) | positive scalar

Activation energy for the conduction inside the electrolyte.

Activation energy for charge transfer in Anode — Activation energy for charge transfer inside anode

13000 J/mol (default) | positive scalar

Activation energy for the charge transfer inside the anode.

Activation energy for charge transfer in Cathode — Activation energy for charge transfer inside cathode

20000 J/mol (default) | positive scalar

Activation energy for the charge transfer inside the cathode.

References

[1] Prada, E., et al. "Simplified Electrochemical and Thermal Model of LiFePO_4--Graphite Li-Ion Batteries for Fast Charge Applications". Journal of The Electrochemical Society, vol. 159, no. 9, 2012, pp. A1508–19. DOI.org (Crossref), https://doi.org/10.1149/2.064209jes.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2024a