Cycler

Represents a battery cycler protocol used in the breathe design process for dynamic analysis. Has methods to generate different battery cycler protocols in the correct format.

__init__

__init__(selected_unit, cell_capacity)

Initialize a Cycler object with the selected unit and cell capacity. The default protocol is set to CC_CHG.

Parameters:

Name	Type	Description	Default
selected_unit	str	The unit of current (A or C) used in the cycler.	required
cell_capacity	float	The capacity of the battery cell in Ah.	required

cc_chg

cc_chg(I_chg, V_max)

Create a Constant Current Charge cycler protocol.

Parameters:

Name	Type	Description	Default
I_chg	float	The charging current in [A || C]. Required.	required
V_max	float	The maximum charging voltage in V. Required.	required

Returns:

Type	Description
dict	representing the CC-CHG cycling protocol.

cc_dch

cc_dch(I_dch, V_min)

Create a Constant Current Discharge cycler protocol.

Parameters:

Name	Type	Description	Default
I_dch	float	The discharging current in [A || C]. Required.	required
V_min	float	The minimum discharging voltage in V. Required.	required

Returns:

Type	Description
dict	representing the CC-DCH cycling protocol.

cccv

cccv(I_chg, I_dch, I_cut, V_max, V_min, t_restC, t_restD)

Create a Constant Current Constant Voltage (CCCV) cycler protocol.

Parameters:

Name	Type	Description	Default
I_chg	float	The charging current in [A || C]. Required.	required
I_dch	float	The discharging current in [A || C]. Required.	required
I_cut	float	The cut-off current in [A || C]. Required.	required
V_max	float	The maximum charging voltage in V. Required.	required
V_min	float	The minimum discharging voltage in V. Required.	required
t_restC	float	The rest time (in seconds) after charging. Required.	required
t_restD	float	The rest time (in seconds) after discharging. Required.	required

Returns:

Type	Description
dict	representing the CCCV cycling protocol.

dcir

dcir(I_dch, t_dur, t_rest_before, t_rest_after, v_min, v_max)

Create a Direct Current Internal Resistance (DCIR) cycler protocol.

Parameters:

Name	Type	Description	Default
I_dch	float	The discharging current in [A || C]. Required.	required
t_dur	float	The duration of the discharge in seconds. Required.	required
t_rest_before	float	The rest time before the discharge in seconds. Required.	required
t_rest_after	float	The rest time after the discharge in seconds. Required.	required
v_min	float	The minimum voltage in V. Required.	required
v_max	float	The maximum voltage in V. Required.	required

Returns:

Type	Description
dict	representing the DCIR cycling protocol.

rate_cap

rate_cap(I_chg, I_dch, I_cut, V_max, V_min, t_restC)

Create a Rate Capacity cycler protocol.

Parameters:

Name	Type	Description	Default
I_chg	float	The charging current in [A || C]. Required.	required
I_dch	float	The discharging current in [A || C]. Required.	required
I_cut	float	The cut-off current in [A || C]. Required.	required
V_max	float	The maximum charging voltage in V. Required.	required
V_min	float	The minimum discharging voltage in V. Required.	required
t_restC	float	The rest time (in seconds) after charging. Required.	required

Returns:

Type	Description
dict	representing the RateCap cycling protocol.