convert

Convert array of numeric values into different unit

Since R2021b

Syntax

V2 = convert(V1,unit)

V2 = convert(V1,unit,conversiontype)

Description

V2 = convert(V1,unit) converts an array of numeric values contained in the simscape.Value object, V1, into the specified unit, unit, by applying the appropriate scaling factor to the numeric values of V1 and binding the new unit, unit, to V2. unit must be commensurate with the unit of V1.

V2 = convert(V1,unit,conversiontype) lets you select whether to apply affine or linear conversion to thermal units. Affine conversion is the default.

Examples

Convert Array of Values into a Different Unit

Create a simscape.Value object, in meters per second squared:

V1 = simscape.Value([10 20 30], 'm/s^2')

V1 = 

    10    20    30

    (m/s^2)

Convert the array into millimeters per second squared:

 V2 = convert(V1, 'mm/s^2')

V2 = 

       10000       20000       30000

    (mm/s^2)

Perform Affine or Linear Conversion for Thermal Units

Create a simscape.Value object in degrees Celsius:

T = simscape.Value(10, 'degC')

T = 

    10 (degC)

Convert the object into Kelvin by performing affine conversion:

 T_affine = convert(T, 'K', 'affine')

T_affine =

    283.1500 (K)

Convert the object into Kelvin by performing linear conversion:

 T_linear = convert(T, 'K', 'linear')

T_linear =

    10 (K)

Input Arguments

V1 — Array of numeric values with unit

simscape.Value object

Array of numeric values with unit, specified as a simscape.Value object.

Example: 10 (m/s^2)

unit — Physical unit expression

character vector | nonmissing string scalar | scalar simscape.Unit object

Physical unit expression, specified as a character vector, nonmissing string scalar, or a scalar simscape.Unit object. The expression can consist of valid physical unit names, numbers, math operators, such as +, -, *, /, and ^, and parentheses to specify the order of operations. unit must be commensurate with the unit of V1.

Example: 'mm/s^2'

Data Types: char | string

conversiontype — Conversion type for thermal units

'affine' (default) | 'linear'

Thermal units often require an affine conversion, that is, a conversion that performs both multiplication and addition. For more information, see About Affine Units. When you extract values from a simscape.Value object that has affine units, you can specify the type of conversion:

• 'affine' — Perform unit conversion that uses both multiplication and addition.

• 'linear' — Perform unit conversion by applying just the linear term.

Data Types: char | string

Output Arguments

V2 — Array of numeric values with unit

simscape.Value object

Array of numeric values with unit, returned as a simscape.Value object.

Example: 10000 (mm/s^2)

Version History

Introduced in R2021b

R2024a: Compact display of simscape.Value and simscape.Unit objects

When you place simscape.Value and simscape.Unit objects in table, cell, and structure arrays, the Command Window displays their values and units explicitly if they fit into the available width of the Command Window. For row vectors greater than maximum width, empty vectors, and for single line display of matrices and row vectors, you can still see only the object member dimensions and type.

In previous releases, the value and unit in a simscape.Value object were separated by a colon. Now, the unit is shown in parentheses after the value.