2.2.3. Getting Started With the Single-Potential Empirical Battery Model

The battery model is implemented by user-defined functions (UDFs) and scheme routines in ANSYS Fluent. A number of UDFs are used to solve the battery equations. When you loaded the battery add-on module in the previous step (Loading the Single-Potential Empirical Battery Module), UDF and scheme libraries that are required by the battery model were automatically loaded. Before you can begin the process of defining your battery model, however, you will need to perform some additional setup tasks that involve allocating user-defined memory for the UDFs and hooking an adjust UDF to ANSYS Fluent. Follow the procedure below.

Once the module has been loaded, in order to set battery model parameters and assign properties to the relevant regions in your battery, you need to access the battery graphical user interface (the Battery Model dialog box).

To enable the battery model: In the tree under the Models branch, right-click Battery Model and click Edit... in the menu that opens.

 Setup → Models → Battery Model   Edit...

Figure 2.1:  The Battery Model Option in the Tree

The Battery Model Option in the Tree

This opens the Battery Model dialog box.

Once you open the Battery Model dialog box, you can select the Enable Battery Model check box to enable the model so that you can use it in your simulation. Enabling the model expands the dialog box to reveal additional model options and solution controls.

The Model Parameters tab of the Battery Model dialog box allows you to access general model settings when solving a battery problem. Likewise, the Separator tab allows you to set options for the battery separator. Finally, the Electric Field tab allows you to set parameters for the electric field. For additional information, see the following sections:

2.2.3.1. Specifying Single-Potential Empirical Battery Model Parameters

The Model Parameters tab of the Battery Model dialog box allows you to turn on or off various options when solving a battery problem.

Figure 2.2:  The Battery Model Dialog Box (Model Parameters Tab)

The Battery Model Dialog Box (Model Parameters Tab)

In the Model Parameters tab, you can set various model options, solution controls, electrical parameters, as well as activation parameters.

For Model Options, you can:

  • Enable Joule Heat Source in order to include the Joule Heating source in the thermal energy equation (Equation 2–8). (enabled by default)

  • Enable E-Chem Heat Source in order to include the heat source due to electrochemistry in the thermal energy equation (Equation 2–9). (enabled by default)

  • Enable Separator Submodel in order to specify your own values for the Separator Thickness and Resistivity, instead of the Y Coefficients, for modeling the separator. Note that when this option is selected, the inputs for the Y Coefficients are grayed out, and the Separator Property fields are active in the Separator tab.


    Note:  The separator submodel is provided as an alternative method to calculate the separator resistance. When the option is enabled, the separator resistance is computed as R = (separator resistivity)*(separator thickness), where separator resistivity and separator thickness are supplied by you. When the option is disabled (the default), the separator resistance is computed by


For Solution Controls, you can set the Current Under-Relaxation Factor.

For Electrical Parameters, you can set the Nominal Capacity (the capacity of the battery cell). If you select Fixed DoD (for steady state simulation only), then you can specify a Nominal DoD value (depth of discharge). For the Solution Options, if you select:

  • Specified C-Rate, you can set a value for the Discharge C-Rate (the hourly rate at which a battery is discharged). In this case, the total current at the cathode tabs are fixed as the product of C-Rate and Nominal Capacity, while the electrical potential is anchored at zero on the anode tabs.

  • Specified System Current, you can set a value for the total current (applied to the anode tabs). In this case, the electrical potential is set to zero at the anode tabs.

  • 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).

  • 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.


    Note:  When the steady state solver is used, the Fixed DoD option has to be selected. Alternatively, the transient solver can be used to analyze variable DoD problems.


For Activation Parameters, you can specify the U Coefficients for Equation 2–3 and the Y Coefficients for Equation 2–4 (if the Enable Separator Submodel option is disabled).


Note:  The coefficient values for the Activation Parameters are based on battery cell polarization test curves. Obtaining coefficient values (other than the default values) can be dependant on your battery configuration and material properties. For more information about coefficient values, refer to the work performed by Gu [1]. You will likely need to make adjustments (for example, if you are modeling lithium ion batteries) when using your own experimental data.


You can also specify the Temperature Corrections, if needed, though the default values are suitable in most cases. The temperature corrections provide additional accuracy to account for local temperature effects, and correspond to the temperature terms in Equation 2–6 and Equation 2–7.

2.2.3.2. Specifying Separator Parameters

The Separator tab of the Battery Model dialog box allows you to select interfaces as the Anode Separator, the Cathode Separator, as well as the Separator Properties, if appropriate.

Figure 2.3:  The Battery Model Dialog Box (Separator Tab)

The Battery Model Dialog Box (Separator Tab)

In the Separator tab, specify the zones for the Anode Separator and the Cathode Separator. If the Enable Separator Submodel option is selected in the Model Parameters tab, you can specify the Separator Properties such as the Separator Thickness and the Separator Resistivity.

2.2.3.3. Specifying Electric Field Parameters

The Electric Field tab of the Battery Model dialog box allows you to set the properties of the Conductive Regions, Contact Surfaces, and the External Connectors.

Figure 2.4:  The Battery Model Dialog Box (Electric Field Tab)

The Battery Model Dialog Box (Electric Field Tab)

In the Electric Field tab, specify the zones for the Conductive Regions and the Contact Surfaces (as well as the Contact Resistance) for any selected contact surface. In addition, you can specify the anode and cathode tap surfaces for the External Connectors of the battery.


Release 18.2 - © ANSYS, Inc. All rights reserved.