set

R2026b

Export K and C parameters to Simulink suspension block

Since R2026b

Syntax

set(knc,blkPath)

set(knc,blkPath,Name=Value)

Description

set(knc,blkPath) generates final K and C suspension parameters and exports them to the Simulink block specified by blkPath.

set(knc,blkPath,Name=Value) exports K and C parameters with additional options specified by one or more name-value arguments. Use name-value arguments to specify coordinate system, direction conventions, static alignment values, and symmetry options.

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.

blkPath — Block path

string scalar

Block path to the K and C suspension Simulink block, specified as a string scalar. The block must be an Independent Suspension - K and C block or Twist-Beam Suspension - K and C block.

Data Types: string

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.set(Coordinates="iso", UseSymmetric="average") will generate plots using ISO sign convention and apply left to right symmetry by averaging the data

Coordinate System and Directions

Coordinates — Coordinate system convention

"iso" (default) | "sae"

Coordinate system convention, specified as "iso" or "sae". Default is "iso".

StrPlusDirection — Positive steer direction

"right" | "left"

Positive steer direction, specified as "right" or "left".

XPlusDirection — Positive longitudinal direction

"front" | "rear"

Positive longitudinal direction, specified as "front" or "rear".

YPlusDirection — Positive lateral direction

"right" | "left"

Positive lateral direction, specified as "right" or "left".

ZPlusDirection — Positive vertical direction

"up" | "down"

Positive vertical direction, specified as "up" or "down".

WhlMzDirection — Positive wheel yaw moment direction

"Counter-clockwise" | "Clockwise"

Positive wheel yaw moment direction, specified as "Counter-clockwise" or "Clockwise".

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

Output Options

SetGradient — Option to use gradient values instead of lookup tables

false (default) | true

Option to use gradient values instead of lookup tables, specified as true or false. When true, the block uses linear gradient values instead of multi-point lookup tables. Default is false.

Data Types: logical

SetNrmlWhlFrcOff — Normal wheel force offsets

1-by-4 vector

Normal wheel force offsets, specified as a 1-by-4 vector in the format [FL, FR, RL, RR].

Data Types: double

UseSymmetric — Symmetry option for parameter averaging

"none" | "average" | "left" | "right" | "zero" | N-by-2 string array

Symmetry option for parameter averaging, specified as one of these values:

• "none" — No symmetry applied

• "average" — Average left and right values

• "left" — Use left side values for both sides

• "right" — Use right side values for both sides

• "zero" — Zero out asymmetric terms

Alternatively, specify an N-by-2 string array of [test, style] pairs for per-test symmetry control.

Data Types: string

Examples

Export Parameters to K and C Block

After fitting K and C data, export parameters to an Independent Suspension - K and C block.

knc.set("myModel/Independent Suspension - K and C")

Export Parameters with Coordinate System and Symmetry

Export parameters using ISO coordinates with symmetric averaging of left and right sides.

knc.set("myModel/Independent Suspension - K and C", ...
    Coordinates="iso", UseSymmetric="average")

Export Parameters with Static Alignment Values

Export parameters with explicit static alignment values and gradient mode disabled.

knc.set("myModel/Independent Suspension - K and C", ...
    SetGradient=false, ...
    StatToe=[-0.008, -0.010, 0.005, 0.004], ...
    StatCamber=[0.011, 0.012, -0.024, -0.024], ...
    StatCaster=[0.008, 0.003, -3e-4, 4e-4], ...
    StatLdWhlR=[0.297, 0.296, 0.303, 0.304])

Version History

Introduced in R2026b