kncSuspension

R2026b

Create kinematics and compliance (K and C) suspension data processing service

Since R2026b

expand all in page

    Description

    Use the kncSuspension object to create and configure a K and C suspension data processing service. The service provides methods for: importing test data, fitting parameters, visualizing results, and exporting to Simulink® blocks.

    Creation

    Syntax

    knc = kncSuspension
    knc = kncSuspension(Name=Value)

    Description

    knc = kncSuspension creates a vdynsuspension.KnCService handle-class object, knc, with default settings for kncsuspension data processing.

    example

    knc = kncSuspension(Name=Value) uses options specified by one or more name-value arguments to configure the K and C service with a description, custom data file importer mapping, or a previously exported parameter set for reuse.

    example

    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(Description = "K and C Baseline Test") assigns descriptive metadata to the K and C service object identifying the test session or vehicle configuration.

    K and C test session description, specified as a string scalar. Use this argument to assign descriptive metadata to the K and C service object identifying the test session or vehicle configuration.

    Data Types: string

    Custom mapping for imported data files and required data entries, specified as a vdynsuspension.import.UserImporter object. Use this argument to define custom channel name mappings and file layout specifications for .tab or .txt files that do not conform to standard Anthony Best Dynamics (ABD), MTS Systems Corporation (MTS), or Morse Measurements, LLC (Morse) formats.

    Previously exported K and C parameter set for reuse, specified as a vdynsuspension.KnCResults.KnCBlkParam object. Use this argument to initialize the service with parameters generated from a prior session using the export method, enabling reuse without re-importing and re-fitting data.

    Object Functions

    MethodDescription

    addVehInfo

    Add vehicle information to K and C service

    addTestInfo

    Add test metadata for imported measurement

    import

    Import K and C test data from files

    UserImporter

    Define custom data-channel mappings for K and C file import

    fit

    Perform curve fitting on K and C data and generate suspension parameters

    plot

    Plot K and C test data with fitted curves

    set

    Export K and C parameters to Simulink suspension block

    export

    Export K and C analysis results for reuse

    Examples

    collapse all

    Create a K and C service object with default settings.

    knc = kncSuspension

    Create a K and C service object and assign a description for the test session.

    knc = kncSuspension(Description="myCar K and C Data")

    Create a custom importer for a nonstandard .tab file format, and then create a K and C service using that importer.

    myImporter = vdynsuspension.import.UserImporter;
knc = kncSuspension(CustomMapping=myImporter)

    Create a K and C service initialized with parameters exported from a previous session.

    knc = kncSuspension(KnCParameters=savedParams)

    Import K and C test data, fit parameters, and export to a Simulink block.

    Create the K and C service and add vehicle information.

    knc = kncSuspension(Description="myCar K and C Data");
knc.addVehInfo(Name="myCar", Mass=1950, FrontTrack=1626, RearTrack=1632)

    Import K and C test data files for bounce and roll tests.

    knc.import(bounceFile, TestType="bounce", FrontAntiRollBar=true, RearAntiRollBar=true);
knc.import(rollFile, TestType="roll", FrontAntiRollBar=true, RearAntiRollBar=true)

    Fit the data to generate suspension parameters.

    knc.fit([1,0], [1,1], "Independent front and rear", "AWD")

    Visualize the fitted results and export to a Simulink block.

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

    Version History

    Introduced in R2026b

    See Also

    Topics