table

R2026b

Create table from tire data

Since R2023b

Syntax

T = table(obj)

T = table(obj, Name=Value)

Description

Add-On Required: This feature requires the Extended Tire Features for Vehicle Dynamics Blockset add-on.

T = table(obj) creates a table, T, from the tireData object specified by obj. Each data channel property becomes a variable in T. Non-data channel property information, such as CoordinateSystem, and object information is lost. The function converts empty channels to NaN arrays.

T = table(obj, Name=Value) creates a table, T, from the tireData object specified by obj with additional options specified by one or more Name=Value arguments.

Examples

Create Table from Tire Data

Convert a tireData object to a MATLAB^® table.

Generate synthetic tire data with a slip angle sweep and lateral force channel populated.

td = tireData.generate("Ramp", direction="alpha", initialValue=-0.15, finalValue=0.15, ...
    Fz=4000, Fy=2500, kappa=0, gamma=0, Vx=16.7, IP=220000);

Convert the tireData object to a table. Each data channel property becomes a variable in the table. Empty channels are converted to NaN arrays.

T = table(td);

Exclude empty channels and scalar properties from the table output. This removes columns that contain only NaN values and keeps only vector channels.

T = table(td,ExcludeEmptyChannels=true, ExcludeScalarProperties=true)

T = 
  segment    measnumb     Fy      Fz       IP       alpha     gamma    kappa    Vx
  _______    ________    ____    ____    ______    _______    _____    _____    ____

     1          1        2500    4000    220000      -0.15      0        0      16.7
     1          2        2500    4000    220000    -0.1497      0        0      16.7
     1          3        2500    4000    220000    -0.1494      0        0      16.7
     ...

Input Arguments

obj — Tire data

tireData object

Tire data, specified as a tireData object.

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: T = table(tireData,ExcludeEmptyChannels=true,ExcludeScalarProperties=false)

ExcludeEmptyChannels — Option to exclude empty channels

false (default) | true

Option to exclude empty channels from the table, specified as false or true.

Data Types: logical

ExcludeScalarProperties — Option to exclude scalar properties

false (default) | true

Option to exclude scalar properties from the table, specified as false or true.

Data Types: logical

Output Arguments

T — Table

table object

Table, returned as a table object.

Version History

Introduced in R2023b

R2025a: Option to include or exclude scalar properties in the table output

Starting in R2025a, specify ExcludeScalarProperties as false or true to include or exclude scalar properties in the table output.