BATTERY_PACK

Specifies a battery pack and its parameters.

Type

AcuSolve Command

Syntax

BATTERY_PACK("name"){parameters...}

Parameters

number_of_parallel_modules (int) ≥1 [=1]
Number of battery modules connected in parallel.
number_of_serial_modules (int) ≥1 [=1]
Number of battery modules connected in series.
electrical_input_type (enumerated) [=current]
Type of global electrical input to battery pack.
current
Electric current input. Requires current_type.
c_rate
C-rate input. Requires c_rate_type.
voltage
Voltage input. Requires voltage_type = constant.
power
Power input. Requires power_type = constant.
standard_charging_profile or scp
Pre-defined charging profile.
current_type (enumerated) [=constant]
Type of electrical current input.
constant or const

Constant electrical current. Requires current.

piecewise_linear or linear
Piecewise linear curve fit electrical current profile. Requires curve_fit_values and curve_fit_variable.
cubic_spline or spline
Cubic spline curve fit electrical current profile. Requires curve_fit_values and curve_fit_variable.
current (real) [=0]
Constant value of electrical current. When current_type is constant. Notice you have a positive current for discharging and negative current for charging.
current_curve_fit_values (array) [={0,0}]
A two-column array of independent-variable/isotropic electrical current data values. The independent variable is time. Used with piecewise_linear and cubic_spline types.
current_curve_fit_variable (enumerated) [=time]
Independent variable of the curve fit for isotropic electrical current. Used with piecewise_linear and cubic_spline types.
time
time
c_rate_type (enumerated) [=none]
Type of c-rate input.
none
No c-rate type specified.
constant or const
Constant c-rate value. Requires c_rate.
piecewise_linear or linear
Piecewise linear curve fit c-rate profile. Requires curve_fit_values and curve_fit_variable.
cubic_spline or spline
Cubic spline curve fit c-rate profile. Requires curve_fit_values and curve_fit_variable.
c_rate (real) [=0]
Constant value of c-rate. When c_rate_type is constant.
c_rate_curve_fit_values (array) [={0,0}]
A two-column array of independent-variable/isotropic c-rate data values. The independent variable is time. Used with piecewise_linear and cubic_spline types.
c_rate_curve_fit_variable (enumerated) [=time]
Independent variable of the curve fit for isotropic c-rate. Used with piecewise_linear and cubic_spline types.
time
time
voltage_type (enumerated) [=constant]
Type of voltage input.
constant or const
Constant voltage value. Requires voltage.
voltage (real) [=0]
Constant value of module input voltage. When voltage_type = constant.
power_type (enumerated) [=constant]
Type of power input.
constant or const
Constant power value. Requires power.
piecewise_linear or linear
Piecewise linear curve fit power profile. Requires curve_fit_values and curve_fit_variable.
cubic_spline or spline
Cubic spline curve fit power profile. Requires curve_fit_values and curve_fit_variable.
power (real) [=0]
Constant value of module input power. When power_type = constant. Input can be positive or negative.
power_curve_fit_values (array) [={0,0}]
A two-column array of independent-variable/isotropic power data values. The independent variable is time. Used with piecewise_linear and cubic_spline types.
power_curve_fit_variable (enumerated) [=time]
Independent variable of the curve fit for power. Used with piecewise_linear and cubic_spline types.
time
time
standard_charging_profile_type (enumerated) [=none]
Type of power input.
none
No charging profile used.
constant_current_constant_voltage or cccv
Current constant voltage charging profile. Requires a module input current or c_rate to be specified.
constant_power_constant_voltage or cpcv
Constant power constant voltage standard charging profile. Requires module power to be specified.
cut_off_current_percent (real) [=0.01]
Current at which the battery is considered fully charged when using charge profiles.
thermal_runaway_model (string) [=no default]
User-given name of the THERMAL_RUNAWAY_MODEL used with this battery pack.
cell_current_calculation (enumerated) [=none]
How current is calculated in parallel connected battery cells.
none
Current in parallel cells is determined from the current calculated in the busbar connected to the battery cell. The current is determined during the electric potential solve.
constant
Current is calculated assuming the current is uniform across parallel cells.