addTestInfo

R2026b

Add or update test metadata for imported measurement

Since R2026b

expand all in page

Syntax

addTestInfo(knc,measurementName,Name=Value)

Description

addTestInfo(knc,measurementName,Name=Value) adds or updates test metadata for the imported measurement identified by measurementName. Use this method to assign test type, axle, track, and test condition information to a previously imported measurement.

example

Input Arguments

expand all

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

Name of the imported measurement to assign metadata to, specified as a string scalar. The name must match an existing measurement in the K and C service object.

Data Types: string

Name-Value Arguments

expand all

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.addTestInfo(TestType = "Bounce") assigns descriptive metadata to the K and C service object identifying the data as being from a vertical motion test.

Test description, specified as a string scalar.

Data Types: string

Test timestamp, specified as a string scalar in yyyy-mm-dd format.

Data Types: string

K and C test type, specified as one of these values:

  • "bounce" — Vertical wheel travel test

  • "roll" — Roll angle test

  • "steering" — Steering sweep test

  • "lateral compliance opposed" — Opposed lateral force test

  • "lateral compliance parallel" — Parallel lateral force test

  • "longitudinal compliance" — Longitudinal force test

  • "aligning torque opposed" — Opposed aligning torque test

Test axle specification, specified as "front axle", "rear axle", or "front and rear axle".

Test track specification, specified as "left track", "right track", or "left and right track".

Front anti-roll bar connected status, specified as true or false.

Rear anti-roll bar connected status, specified as true or false.

Engine off status, specified as true (engine off) or false (engine on).

Roll axle fixation status, specified as true (fixed) or false (independent).

Brake applied status, specified as true (brake applied) or false (brake not applied).

Examples

expand all

Create a K and C service, import a data file, and then assign test metadata to the imported measurement.

knc = kncSuspension;
knc.import("bounceTest.mat");
knc.addTestInfo("bounceTest", TestType="bounce", ...
    TestAxle="front and rear axle", ...
    FrontAntiRollBar=true, RearAntiRollBar=true)

Version History

Introduced in R2026b

See Also

Topics