applyCellDataFromPart

Apply data from selected parameterization to Cell object

Since R2023a

collapse all in page

Syntax

applyCellDataFromPart(batteryCell)

Description

applyCellDataFromPart(batteryCell) updates the Geometry, Mass, Capacity, and Energy properties of the Cell object batteryCell. The applied data depends on the parameterization you specified in the ParameterizationManufacturer and ParameterizationPartNumber properties of the Cell object.

The value that the applyCellDataFromPart function applies to the Capacity property of the Cell object also depends on the value you specify for the ForwardCapacityParameter property of the Cell object. (since R2026a)

If you set the ForwardCapacityParameter property to "None" and you specify the ParameterizationManufacturer and ParameterizationPartNumber properties, the applyCellDataFromPart function updates the Capacity property value to the value of the metadata of the part number you specified. The metadata uses the nominal capacity specified in the data sheet.

If you set the ForwardCapacityParameter property to the name of the capacity parameter that you want to forward and you specify the ParameterizationManufacturer and ParameterizationPartNumber properties, then the applyCellDataFromPart function updates the Capacity property value to the value of the selected capacity parameter name in the datasheet of the part number you specified. The software derives this data from optimization and more closely reflects the actual cell behavior.

example

Examples

collapse all

Create a Cell object.

import simscape.battery.builder.*
battCell = Cell(Geometry = CylindricalGeometry);

Choose the parameterization. Set the ParameterizationManufacturer and ParameterizationPartNumber properties.

battCell.ParameterizationManufacturer = "A123";
battCell.ParameterizationPartNumber = "ALM12V7";

Apply the parameterization data by using the applyCellDataFromPart function.

battCell.applyCellDataFromPart;

Input Arguments

collapse all

Cell to update with the data from the selected parameterization, specified as a Cell object.

Version History

Introduced in R2023a

See Also

Apps

Objects

Topics