3.2.4. Setting up the Dual-Potential MSMD Battery Model

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

Figure 3.4:  The MSMD Battery Model Option in the Tree

The MSMD Battery Model Option in the Tree

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:

Model Options

contains the general model settings to define problems using the battery model.

Model Parameters

is where you specify the parameters to be used for solving the model equations.

Conductive Zones

allows you to select zones for the active, tab and busbar components.

Electric Contacts

allows you to define the contact surface and external connectors.

Advanced Option

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:

3.2.4.1. Specifying Battery Model Options

In the Model Options tab, you can select the electrochemical battery submodel and set various model options, solution controls, and electrical parameters.

Figure 3.5:  The MSMD Battery Model Dialog Box (Model Options Tab)

The MSMD Battery Model Dialog Box (Model Options Tab)

The following submodels are available in ANSYS Fluent under the E-Chemistry Models group box:

NTGK Empirical Model

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.

Equivalent Circuit Model

is a semi-empirical model. It has limited capability for predicting the battery dynamic behavior.

Newman P2D Model

is the most comprehensive physics-based battery model. It is computationally expensive, and it requires extensive user input of battery-related fundamental information.

User-defined E-Model

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:

        1. Time

        2. Electric load value

        3. 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:

        1. The battery is discharged at 15 A for the first 500 seconds.

        2. The battery discharge continues at 60 W for the next 500 seconds.

        3. The battery is charged at a constant 1 C-rate for the last 500 seconds.


        Note:
        • 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:

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

        2. Electric load value

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

        4. Forwarding condition value

        5. 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:

        1. The battery is discharged at 1 C rate until the voltage reaches 3.5 V.

        2. The battery is charged at constant current 15 A until the voltage reaches 4.1 V.

        3. The battery keeps charging at 4.1 V until the current is greater -1 A. The simulation stops after reaching this point.


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

3.2.4.2. Specifying Battery Model Parameters

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.

3.2.4.2.1. Inputs for the NTGK Empirical Model

Figure 3.6:  Model Parameters Tab—NTGK Model

Model Parameters Tab—NTGK Model

For the NTGK Empirical Model, you can specify polynomial coefficients for , , and temperature correction in Equation 3–5.


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

3.2.4.2.2. Inputs for the Equivalent Circuit Model

Figure 3.7:  Model Parameters Tab—Equivalent Circuit Model

Model Parameters Tab—Equivalent Circuit Model

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.


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


3.2.4.2.3. Inputs for the Newman’s P2D Model

Figure 3.8:  Model Parameters Tab—Newman’s P2D Model

Model Parameters Tab—Newman’s P2D Model

The following parameters are available under Model Parameters for the Newman’s P2D model:

Thickness

are , , and in Equation 3–21.

Number of Grids

is a number of grid points used to discretize the positive electrode, negative electrode, and separator zones.

Grid Size Ratio

is used to create a biased mesh. The default value of 1 corresponds to a uniform mesh.

Particle Diameter

is the particle diameter of the active material.

Number of Grids in Solid

is the number of grid points used to discretize the sphere of particles.

Grid Size Ratio in Solid

is used to create a biased mesh for the solid phase. The default value of 1 corresponds to a uniform mesh.

Max. Solid Li+ Conc

is the maximum concentration of Lithium in the solid phase (used in Equation 3–18).

Stoi. at 0% SOC

is the stoichiometry at 0% SOC that is used to compute theoretical capacity and initial lithium concentration in the electrode.

Stoi. at 100% SOC

is the stoichiometry at 100% SOC that is used to compute theoretical capacity and initial lithium concentration in the electrode.

Init. Solid Li+Conc.

is the initial lithium concentration in the electrode.

Init. Electrolyte Li+Conc.

is the initial lithium concentration in the electrolyte phase.

Volume Fraction

is the volume fraction of the active material in the electrode, in Equation 3–19.

Filler Fraction

is the volume fraction of the filler material in the electrode, in Equation 3–19.

Ref. Diffusivity

is the diffusion coefficient of lithium ion in the electrode at reference temperature =25°C, in Equation 3–19.

Activation Energy E_d

is in Equation 3–19.

Tortuosity

is the Bruggeman porosity exponent, in Equation 3–19.

Conductivity

is the electric conductivity, in Equation 3–19.

Ref. Rate Constant

is the rate constant at reference temperature =25°C, in Equation 3–19.

Activation Energy E_r

is in Equation 3–19.

Trans. Coef. a

is the charge transfer coefficient at anode, in Equation 3–18.

Trans Coef. c

is the charge transfer coefficient at cathode, in Equation 3–18.

Electrolyte Diffusivity

is the diffusion coefficient of Li+ in the electrolyte phase, in Equation 3–18.

t+ Factor

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.


3.2.4.2.4. Input for the User-Defined E-Model

Figure 3.9:  Model Parameters Tab—User-Defined E-Model

Model Parameters Tab—User-Defined E-Model

The following parameters are available under User-Defined E-Chem Model Parameters:

Number of memories per cell

is the number of submodel parameters that need to be saved per computational cell during a simulation.

Initial SOC

is the value of the battery initial state of charge.

Reference Capacity

is the battery capacity (Ah).

3.2.4.3. Specifying Conductive Zones

The Conductive Zones tab of the MSMD Battery Model dialog box allows you to specify the active, tab, and busbar zones.

Figure 3.10:  The MSMD Battery Model Dialog Box (Conductive Zones Tab)

The MSMD Battery Model Dialog Box (Conductive Zones Tab)

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.

3.2.4.4. Specifying Electric Contacts

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.

Figure 3.11:  The MSMD Battery Model Dialog Box (Electric Contacts Tab)

The MSMD Battery Model Dialog Box (Electric Contacts Tab)

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.


3.2.4.5. Specifying Advanced Option

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

Figure 3.12:  The MSMD Battery Model Dialog Box (Advanced Option Tab)

The MSMD Battery Model Dialog Box (Advanced Option Tab)

Running the Standalone Echem Model

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:

  1. Click Run Echem Model Standalone.

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

  3. Initiate the electrochemical model simulation by clicking Draw Profile.

    Once the calculation is complete, the Plot Profile Data dialog box opens.

  4. 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:

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


Using the Thermal Abuse model

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.


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

3.2.4.6. Specifying External and Internal Short-Circuit Resistances

External Short-Circuit

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.

Internal Short-Circuit

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.


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