Construct_Full_Cell_OCV

Construct full-cell OCV characteristics from PBM parameters.

This function constructs the full-cell open-circuit voltage (OCV) characteristics including mean, charge, discharge, and hysteresis components based on % parameters of the Physics-based Battery Model (PBM) stored in a BMJN_<bmjn>.json file. The function accounts for battery aging effects through loss of lithium inventory (LLI) and loss of active material (LAM) parameters.

Syntax

fullCellOCV = Construct_Full_Cell_OCV(bmjn)
fullCellOCV = Construct_Full_Cell_OCV(bmjn, 'lli', lli, 'lamne', lamne, 'lampe', lampe)

Input Arguments

Name	Type	Description
`bmjn`	`double`	Breathe Simulate JSON Number - unique identifier for the battery model parameter set stored in BMJN_<bmjn>.json file

Optional Name-Value Arguments

Name	Type	Range	Description
`lli`	`double`	[0, 0.3]	Loss of lithium inventory
`lamne`	`double`	[0, 0.3]	Loss of active material at negative electrode
`lampe`	`double`	[0, 0.3]	Loss of active material at positive electrode

Output Arguments

Name	Type	Description
`fullCellOCV`	`table`	Table containing full-cell OCV characteristics

Fields of `fullCellOCV`

Field	Type	Units	Description
`refSoC`	`double`	[-]	Reference state-of-charge values [0, 1]
`meanOCV`	`double`	[V]	Mean open-circuit voltage
`refOCVDischarge`	`double`	[V]	Discharge open-circuit voltage
`refOCVCharge`	`double`	[V]	Charge open-circuit voltage
`refOCVHysteresis`	`double`	[V]	Hysteresis voltage

Examples

Basic Usage

% Basic usage with default parameters (no aging)
bmjn = 1000;
ocvData = Construct_Full_Cell_OCV(bmjn);

With Aging Parameters

% With aging parameters
ocvDataAged = Construct_Full_Cell_OCV(bmjn, 'lli', 0.05, 'lamne', 0.02, 'lampe', 0.01);

Compare Fresh vs Aged Battery OCVs

% Compare fresh vs aged battery OCVs
figure;
plot(ocvData.refSoC, ocvData.meanOCV, 'k-', 'LineWidth', 2, 'DisplayName', 'Fresh Battery');
hold on;
plot(ocvDataAged.refSoC, ocvDataAged.meanOCV, 'r--', 'LineWidth', 2, 'DisplayName', 'Aged Battery');
xlabel('State of Charge'); ylabel('Voltage [V]');
legend('Location', 'best'); grid on;
title('OCV Comparison: Fresh vs Aged Battery');