Once the module has been loaded, you can enable the Dual-Potential MSMD Battery Model, set battery model parameters and assign properties to the relevant regions in your battery.
To enable the MSMD battery model: In the tree under the Models branch, right-click MSMD Battery Model and click Edit... in the menu that opens.
Setup → Models → MSMD Battery Model
Edit...
In the MSMD Battery Model dialog box that opens, select the Enable Battery Model check box to activate the model.

The MSMD Battery Model dialog box expands to reveal additional model options and solution controls.
The inputs for the battery model are entered using the following tabs:
contains the general model settings to define problems using the battery model.
is where you specify the parameters to be used for solving the model equations.
allows you to select zones for the active, tab and busbar components.
allows you to define the contact surface and external connectors.
allows you to qukckly check the selected electrochemical submodel behavior using the Echem model in a standalone mode, and also enable a thermal abuse model and specify its parameters.
Note: When setting up the model, you can click the Apply button to save your input values and your choices for your model. To restore the last saved settings for all tabs, click the Reset button.
For additional information, see the following sections:
In the Model Options tab, you can select the electrochemical battery submodel and set various model options, solution controls, and electrical parameters.
The following submodels are available in ANSYS Fluent under the E-Chemistry Models group box:
is an empirical model. This is the simplest and the least expensive model. It also requires the fewest model inputs. The model uses the same NTGK method as that used by the Single-Potential Empirical model. However, in this case, it solves two potential equations continuously instead of one potential equation with a jump condition at the separator over all conductive zones. The model cannot accurately capture the battery's dynamic (inertial) response.
is a semi-empirical model. It has limited capability for predicting the battery dynamic behavior.
is the most comprehensive physics-based battery model. It is computationally expensive, and it requires extensive user input of battery-related fundamental information.
is the user-specified electrochemical submodel. To
be able to use this option in the Fluent MSMD method framework,
you must provide the void user_defined_echem_model() function in the customizable cae_user.c source code file.
For Solution Method for E-Field, if you select:
Solving Transport Equation, two potential equations will be solved during each iteration in the simulation.
Reduced Order Method, the solution will be obtained (faster) using the reduced order method (ROM). You can use this option if the two conditions listed in Reduced Order Solution Method (ROM) are met. See Reduced Order Solution Method (ROM) for details.
Note that, prior to using the ROM, you must first run a simulation with the Solving Transport Equation option for at least three time steps. ANSYS Fluent will use these results as reference potential fields for the ROM method.
Once
you have selected Reduced Order Method, you can
set Number of Sub-Steps/Time Step. Using this
value, you can specify the ratio of the time steps for thermal and
electro-chemistry calculations. For example, if the Number
of Sub-Stepes/Time Step is set to 10, the solver will use one tenth of the CFD time step for the electro-chemistry
calculation.
Important: If internal short circuit occurs in a battery, the Reduced Order Method cannot be used.
For Energy Source Options, you can:
Enable Joule Heat Source in order to include the Joule Heating source in the thermal energy equation Equation 3–1. (enabled by default)
Enable E-Chem Heat Source in order to include the heat source due to electrochemistry in the thermal energy equation Equation 3–1. (enabled by default)
For Solution Controls, you can:
Set Current Under-Relaxation Factor. The volumetric current density used in the two potential equations
are under-relaxed according to this factor. The default value of 0.8 may be sufficient for most cases. The values in
the range of 0.8–1.0 are recommended.
Set Voltage Correction Under-Relaxation Factor. The default value of 1.0 is acceptable for most cases. You should reduce this value only if the convergence difficulty occurs during the solution of the potential equations.
(Equivalent Circuit Model and Newman P2D Model) Select the Cluster Cells check box to enable cell clustering and specify the number of clusters Nx , Ny , and Nz in X, Y, and Z directions respectively. The solver will divide the battery domain into Nx x Ny x Nz clusters and solve submodel equations for each cluster using cluster-average information. The default values for Nx , Ny , and Nz are 1, 1, and 1, respectively. For the initial run, the default settings are recommended.
For Electrical Parameters, you can specify the following operation conditions:
Set the Nominal Cell Capacity (the capacity of the battery cell).
For the Solution Options, if you select:
Specified C-Rate, you can set a value for the following:
Discharge C-Rate (the hourly rate at which a battery is discharged; a positive value means discharging C-rate and a negative value means charging C-rate). In this case, the total current at the cathode tabs is fixed as the product of C-Rate and Nominal Capacity, while the electrical potential is anchored at zero on the anode tabs.
Min. Stop Voltage and Max. Stop Voltage. The simulation will automatically stop once the battery cell voltage reaches the minimum or maximum value. For a battery pack, the battery-average cell voltage is used.
Specified System Current, you can set the following:
System Current (applied at the cathode tabs). A positive value means discharging current and a negative value means charging current.
Min. Stop Voltage and Max. Stop Voltage. (Same as for Specified C-rate.)
Specified System Voltage, you can set a value for the System Voltage (applied to the cathode tab; the anode tab has a voltage of 0 V).
Specified System Power, you can specify the following:
System Power. If you specify the total power output from your battery, Fluent solver will ensure that the product of the system current and voltage equals the system power. A positive value means discharging power output and a negative value means charging power input.
Min. Stop Voltage and Max. Stop Voltage. (Same as for Specified C-rate.)
Specified Resistance, you can specify the external electric resistance in an external short-circuit simulation.
External Resistance. If you specify the external electric resistance in Ohm, the Fluent solver will ensure that the ratio of the system voltage to the system current equals the specified external resistance.
Set in Boundary Conditions, you can set the UDS boundary conditions directly, for example, the voltage value or the current value (specified flux), using the Boundary Conditions task page in ANSYS Fluent for the specific face zone.
Using Profile, you can select Time-Scheduled or Event-Scheduled under Profile Type and provide time-dependent or event-dependent input (respectively) for the C-rate, current, voltage, or power. The time-scheduled and event-scheduled profiles enable you to change the electric load type and electric value in the simulation on the fly.
Once the profile type is selected, you can browse to the ASCII text file with either the .dat or .txt file extension that you generated beforehand.
The inputs for the Time-Scheduled and Event-Scheduled profiles are described below.
The Time-Scheduled profile file must be organized in three columns:
Time
Electric load value
Electric load type
The electric load type is defined by an integer number:
0: C-rate
1: Current
2: Voltage
3: Power
4: External electric resistance
For example, the below time-scheduled profile:
0 15 1 500 15 1 500.1 60 3 1000 60 3 1000.1 -1 0 1500 -1 0
specifies the following battery charging scenario:
The battery is discharged at 15 A for the first 500 seconds.
The battery discharge continues at 60 W for the next 500 seconds.
The battery is charged at a constant 1 C-rate for the last 500 seconds.
For current, power, or C-rate, a positive value means discharging and a negative value means charging.
The unit of the variables in the input file is always SI.
ANSYS Fluent solver uses linear interpolation of your time-scheduled profile data in the problem simulation. If you want to capture a sudden change in the profile accurately, use smaller time gaps to describe the profile.
The Event-Scheduled profile file must be organized in the following five columns:
Electric load type
Just as in the time-scheduled profile, the electric load type is defined by an integer number:
0: C-rate
1: Current
2: Voltage
3: Power
4: External electric resistance
Electric load value
Forwarding condition
The forwarding condition (FC) is defined by an integer number:
1: Time > FC_Value
2: I < FC_Value
(discharging current minimum)
3: I > FC_Value (charging current maximum)
4: V < FC_Value (system voltage minimum)
5: V > FC_Value (system voltage maximum)
6: P < FC_Value (discharging power
minimum)
7: P > FC_Value (charging
power maximum)
Forwarding condition value
Stop flag
The stop flag is an integer value of 0 or 1, where 0 specifies that the run should continue to the next event entry line, and 1 specifies that the run should end.
For example, the below time-scheduled profile:
0 1 4 3.5 0 1 -15 5 4.1 0 2 4.1 3 -1 1
specifies the following scenario:
The battery is discharged at 1 C rate until the voltage reaches 3.5 V.
The battery is charged at constant current 15 A until the voltage reaches 4.1 V.
The battery keeps charging at 4.1 V until the current is greater -1 A. The simulation stops after reaching this point.
For current, power, or C-rate, a positive value means discharging and a negative value means charging.
The unit of the variables in the input file is always SI.
Any time-scheduled profile can be rewritten in an event-scheduled profile format, but not vice-versa. The example shown in the time-scheduled profile can be redefined in an event-scheduled profile format as follows.
1 15 1 500 0 3 60 1 1000 0 0 -1 1 1500 1
Both profile types can be read into ANSYS Fluent. You can choose the most convenient one to use in your specific application.
The Model Parameters tab of the MSMD Battery Model dialog box allows you to specify the submodel-specific parameters to be used for solving the submodel equations. The Model Parameters tab contains only the entry fields for parameters related to the electrochemical submodel you have chosen in the Model Option tab. A detailed description of inputs for each submodel is given in the sections that follow.
For the NTGK Empirical Model, you can specify
polynomial coefficients for ,
, and temperature correction in Equation 3–5.
The polynomial coefficients for the NTGK Model Polarization Parameters are based on battery cell polarization test curves. Obtaining polynomial coefficients (other than the default coefficients) can be dependant on your battery configuration and material properties. The default coefficients are taken from Kim’s paper [9]. If you model a battery having a different design, you must provide a different set of battery parameters.
ANSYS Fluent provides the parameter estimation tool for computing the coefficients of the U and Y polynomial functions from the battery's testing data—constant discharging curves. The tool is available via the text-user-interface (TUI). For details, see Using the Dual-Potential MSMD Battery Model Text User Interface
You can also set values for Initial DoD and Reference Capacity. The default value of 0 for Initial DoD indicates the fully-charged state of the battery cell. Reference Capacity is the capacity of the battery that is used in experiments to obtain the and
model parameters. Nominal and reference capacities may have different values.
For the Equivalent Circuit Model, you can specify the function coefficients for the resistors' resistances (Rs, R1, and R2), capacitors' capacitances (C1 and C2), and the open circuit voltage (Voc) to be used in Equation 3–9.
If you want to specify the ECM model functions in the polynomial form, select Using polynomials and enter parameters for Equation 3–8.
In addition, you can turn on the Using different coefficient for charging and discharging option and specify the coefficients for Charging parameters.
You can also set values for Initial State of Charge and Reference Capacity. The default value of 1 for Initial State of Charge indicates the fully-charged state of the battery cell. Reference Capacity is the capacity of the battery that is used in experiments to obtain the model parameters. Note that nominal and reference capacities may have different values.
The polynomial coefficients for the Equivalent Circuit Model are battery specific and need to be specified before conducting a simulation. The default coefficients are taken from Chen [5]. If you model a battery of different design, you should specify a different set of battery parameters.
ANSYS Fluent provides the parameter estimation tool for computing the polynomial coefficients of all the ECM parameters from the battery's testing data—typically, the HPPC data. The tool is available via the text-user-interface (TUI). For details, see Using the Dual-Potential MSMD Battery Model Text User Interface.
The following parameters are available under Model Parameters for the Newman’s P2D model:
are ,
, and
in Equation 3–21.
is a number of grid points used to discretize the positive electrode, negative electrode, and separator zones.
is used to create a biased mesh. The default value of 1 corresponds to a uniform mesh.
is the particle diameter of the active material.
is the number of grid points used to discretize the sphere of particles.
is used to create a biased mesh for the solid phase. The default value of 1 corresponds to a uniform mesh.
is the maximum concentration of Lithium in the solid phase (used in Equation 3–18).
is the stoichiometry at 0% SOC that is used to compute theoretical capacity and initial lithium concentration in the electrode.
is the stoichiometry at 100% SOC that is used to compute theoretical capacity and initial lithium concentration in the electrode.
is the initial lithium concentration in the electrode.
is the initial lithium concentration in the electrolyte phase.
is the volume fraction of the active material in the
electrode, in Equation 3–19.
is the volume fraction of the filler material in the
electrode, in Equation 3–19.
is the diffusion coefficient of lithium ion in the
electrode at reference temperature =25°C,
in Equation 3–19.
is in Equation 3–19.
is the Bruggeman porosity exponent, in Equation 3–19.
is the electric conductivity, in Equation 3–19.
is the rate constant at reference temperature =25°C,
in Equation 3–19.
is in Equation 3–19.
is the charge transfer coefficient at anode, in Equation 3–18.
is the charge transfer coefficient at cathode, in Equation 3–18.
is the diffusion coefficient of Li+ in the electrolyte
phase, in Equation 3–18.
is the transference number of lithium ion, in Equation 3–19.
You can also set values for Initial State of Charge. The default value of 1 for Initial
State of Charge indicates the fully-charged state of the
battery cell.
Theoretical Capacity is computed from the Newman input parameters automatically and reported in the MSMD Battery Model dialog box.
By default, ANSYS Fluent discretizes the lithium conservation equation and solves it numerically. ANSYS Fluent also offers an option to use the reduced order method to solve the lithium diffusion equation in solid [4]. To use this method, select the Use Analytical Cs check box and enter the value for the Cs Function Order.
Note: Model parameters are battery specific. The default values are taken from Cai & White [4]. To simulate a battery of different design, you should provide a user-specified set of battery parameters.
The following parameters are available under User-Defined E-Chem Model Parameters:
is the number of submodel parameters that need to be saved per computational cell during a simulation.
is the value of the battery initial state of charge.
is the battery capacity (Ah).
The Conductive Zones tab of the MSMD Battery Model dialog box allows you to specify the active, tab, and busbar zones.
In the Conductive Zones tab, select the appropriate zones for the Active Components, Tab Components, and, if you simulate the battery pack with the real battery connections, the Basbar Components. If you simulate the battery pack with the virtual battery connections, do not select any zones under Basbar Components.
Battery cells are modeled as active zones; and battery tabs and busbars are modeled as passive zones. Electrochemical reactions occur only in the active zones. The potential field is solved in both active and passive zones.
The Electric Contacts tab of the MSMD Battery Model dialog box allows you to set the properties of the Contact Surfaces and the External Connectors.
If you want to consider contact resistance, select zones for the Contact Surfaces and set the Contact Resistance for any selected contact surface.
When using real connections, define the system negative and positive tabs under External Connectors.
When using the virtual connection option in a battery pack simulation, select the Use virtual battery connection check box and in the Specify connection file text-entry box that appears, enter the filename containing the virtual connection definition.
The format for the connection definition file is as follows:
mP 1 nS 4 tab_N_1 tab_P_1 tab_N_2 tab_P_2 tab_N_3 tab_P_3 tab_N_4 tab_P_4
where:
The first line specifies the number of parallel batteries in a stage (mP).
The second line specifies the number of stages in series in a pack (nS).
The remaining lines contain pairs of the face names of the negative and positive tabs for each battery. The battery data are listed in the following order: 1P1S ... 1PnS to mP1S ... mPnS.
For the above battery connection file example, the battery solver establishes the 1P4S connection pattern.
The following figure shows the different resulting connection patterns for the different connection data.

Once all conductive zones and the positive and negative tabs have been defined, ANSYS Fluent automatically detects the battery network connection.
After you have defined all the conductive zones or modified zone related data, click Print Battery System Connection Information, and review the battery connection information printed in the ANSYS Fluent console window for any errors. If necessary, re-define the connections in the Conductive Zones and Electric Contacts tabs.
Note: In the default battery solver configuration, the largest battery pack the solver can simulate is 10P50S (50 series stages with 10 parallel connected batteries per stage). However, you can increase this limit to simulate larger battery packs using the following Scheme commands:
(rpsetvar 'battery/max-n-parallel-per-stage m)
(rpsetvar 'battery/max-n-series n)
where m and n are the numbers of maximum parallel and series connections in the battery pack, respectively.
Using the Advanced Option tab of the MSMD Battery Model dialog box, you can:
Check the selected electrochemical model behavior before running the CFD case by performing a quick simulation of the electrochemical model in a standalone mode
Enable the Thermal Abuse Model, select the thermal abuse kinetics model, and define the corresponding model parameters
Prior to running a coupled electrochemical-thermal simulation, you should perform a quick analysis of your electrochemical model by simulating it in a standalone mode. The standalone model calculation uses the operating conditions that you have specified in the Model Option tab (such as electric load type and value) and the echem model parameters that you have defined in the Model Parameters tab. This preliminary analysis will allow you to confirm the electrochemical behavior of the selected submodel and, if necessary, adjust the model settings.
To run the echem model in a standalone mode:
Click Run Echem Model Standalone.

In the Standalone Echem Model dialog box that opens, specify the following parameters:
Report Time Step: The time interval at which the results will be saved and reported
Total Run Time: The total time for running the stand-alone model simulation
Reference Temperature: The temperature level at which you want to simulate your electrochemical model
Initiate the electrochemical model simulation by clicking .
Once the calculation is complete, the Plot Profile Data dialog box opens.

Using the Plot Profile Data dialog box, visualize and analyze the results of the standalone echem model simulation. Different profiles are available for different electrochemical models.
For the NTGK model, a time history profile, called ntgk-time-history-profile, is generated after the calculation is complete. You can draw the X-Y plots of the following variables as a function of time:
soc: the battery state of charge (SOC)
voltage: the battery voltage
current: the battery electric current
power: the battery power output
For the ECM model, a time history profile, called ecm-time-history-profile, will be generated. In addition to the variables available for the NTGK model, you can also draw the X-Y plots of the following variables as a function of time:
v1: in Equation 3–7
v2: in Equation 3–7
For the Newman P2D model, the following two profiles will be generated:
Time history profile p2d-time-history-profile
Spatial field profile called p2d-field-profile
For the p2d-time-history-profile profile, you can plot the time history profile for the following variables:
current (see above)
voltage (see above)
power (see above)
ce_x=0
ce_x=lp
ce_x=lps
ce_x=lpsn
cs_x=0
cs_x=lp
cs_x=lps
cs_x=lpsn
phis_x=0
phis_x=lp
phis_x=lps
phis_x=lpsn
phie_x=0
phie_x=lp
phie_x=lps
phie_x=lpsn
| where | |
| ce is the lithium-ion concentration in electrolyte phase at different locations | |
| x=0 denotes the location of the outside face of the positive electrode | |
| x=lp denotes the interface of the positive electrode and separator | |
| x=lps denotes the interface between the separator and negative-electrode | |
| x=lpsn denotes the outside face of the negative electrode | |
| cs is the lithium concentration at the surface of the active material in electrode at different locations | |
| phis is the electric potential in the electrode solid phase at different locations | |
| phie is the electric potential in the electrolyte liquid phase at different locations |
For the p2d-time-history-profile profile, you can plot the spatial profiles of the following variables at the end of the simulation:
phi_e: the electric potential in electrolyte phase
phi_s: the electric potential in electrode phase
ce: the lithium-ion concentration in electrolyte phase
cs_center: the lithium concentration in the center of the active electrode particles
cs_average: the average lithium concentration in the active electrode particles
cs_surf: the lithium concentration at the surface of the active electrode particles
Note: SI units are always used for all the variables in the X-Y plot.
When you select One-equation kinetics model, you can specify the battery constants ,
,
,
, and
used in Equation 3–24 through Equation 3–25, as well as the initial value for
.
When you select Four-equation kinetics model, you can specify the battery constants ,
,
,
, and
used in Equation 3–26) through Equation 3–30, as well as the initial values for
,
,
, and
.
For both models, you can select Run thermal abuse model only (battery model is turned off) if you want to solve the energy equation (Equation 3–1) alone. Otherwise, the two battery potential equations (Equation 3–2) will also be solved.
The kinetics parameters in thermal abuse models are specific to the battery material. The default settings may not be appropriate for your battery. You must provide parameter data for your own battery.
For the One-Equation thermal abuse model, you can use the ANSYS Fluent parameter estimation tool available through the TUI to compute the kinetics parameters from the battery oven testing data. The entry fields in the MSMD Battery Model dialog box will be automatically populated with fitted results for the kinetics parameters. For details, see Using the Dual-Potential MSMD Battery Model Text User Interface.
For more information, see Thermal Abuse Model.
To define the external short-circuit: In the MSMD Battery Model dialog box, under the Model Options tab, select Specified Resistance and specify a value for External Resistance. See Specifying Battery Model Options for details.
The intensity of the internal short-circuit is determined by
the value of volumetric contact resistance (External and Internal Electric Short-Circuit Treatment. In the ANSYS Fluent battery model,
this value is saved in a predefined user-defined memory allocation,
Short Circuit Resistance. You
can modify the value of this user-defined memory allocation to simulate
the internal short circuit.
By default, the contact resistance is set to a very large number,
so that and
, that is, there is no internal short.
You can simulate an internal short-circuit using either of the following two ways:
Patching: Patch the contact resistance to the short circuit zone. The short circuit zone can be defined using the marking feature available in the Region Adaption dialog box. See Performing Region Adaption in the Fluent User's Guide for more details.
Using UDF: Use DEFINE_ADJUST or DEFINE_ON_DEMAND UDFs to specify the
contact resistance using the UDM macro, C_UDMI(c,t,SHORT_R). The contact resistance could be a function of location and time.
See the Fluent Customization Manual for
details.