addVehInfo

R2026b

Add vehicle information to K and C service

Since R2026b

Syntax

addVehInfo(knc,Name=Value)

Description

addVehInfo(knc,Name=Value) adds vehicle information to the K and C service object knc using one or more name-value arguments. You can call this method multiple times to incrementally add vehicle properties.

Input Arguments

knc — K and C service object

vdynsuspension.KnCService object

K and C service object, specified as a vdynsuspension.KnCService handle-class object created using kncSuspension.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: kncSuspension.addVehInfo(Name = "myCar", VIN = 99999) assigns descriptive metadata to the K and C service object, specifying the name of the test vehicle as "myCar" and the VIN as 99999.

Vehicle Identification

Name — Vehicle name or model

string scalar

Vehicle name or model, specified as a string scalar.

Data Types: string

VIN — Vehicle Identification Number

string scalar

Vehicle Identification Number, specified as a string scalar.

Data Types: string

Dimensions

LeftWheelBase — Left wheelbase

scalar

Left wheelbase, specified as a scalar, in mm.

Data Types: double

RightWheelBase — Right wheelbase

scalar

Right wheelbase, specified as a scalar, in mm.

Data Types: double

FrontTrack — Front axle track width

scalar

Front axle track width, specified as a scalar, in mm.

Data Types: double

RearTrack — Rear axle track width

scalar

Rear axle track width, specified as a scalar, in mm.

Data Types: double

Mass and Inertia

Mass — Total vehicle mass

scalar

Total vehicle mass, specified as a scalar, in kg.

Data Types: double

MassDistribution — Vehicle mass distribution

1-by-4 vector

Vehicle mass distribution, specified as a 1-by-4 vector in the format [front, rear, left, right].

Data Types: double

MOI — Moments of inertia

1-by-3 vector

Moments of inertia, specified as a 1-by-3 vector in the format [pitch, yaw, roll], in kg*m^2.

Data Types: double

COG — Center of gravity

1-by-3 vector

Center of gravity, specified as a 1-by-3 vector in the format [x, y, z], in mm.

Data Types: double

Static Alignment

StatToe — Static toe angles

1-by-4 vector

Static toe angles, specified as a 1-by-4 vector in the format [FL, FR, RL, RR].

Data Types: double

StatCamber — Static camber angles

1-by-4 vector

Static camber angles, specified as a 1-by-4 vector in the format [FL, FR, RL, RR].

Data Types: double

StatCaster — Static caster angles

1-by-4 vector

Static caster angles, specified as a 1-by-4 vector in the format [FL, FR, RL, RR].

Data Types: double

StatLdWhlR — Static loaded wheel radius

1-by-4 vector

Static loaded wheel radius, specified as a 1-by-4 vector in the format [FL, FR, RL, RR].

Data Types: double

Examples

Specify Vehicle Information and Alignment Values for K and C Processing

Create a K and C service object and add vehicle information including mass and track widths.

knc = kncSuspension;
knc.addVehInfo(Name="myCar", Mass=1950, FrontTrack=1626, RearTrack=1632)

Add static alignment values in a subsequent call.

knc.addVehInfo(StatToe=[-0.008, -0.010, 0.005, 0.004], ...
    StatCamber=[0.011, 0.012, -0.024, -0.024])

Version History

Introduced in R2026b