tireData Properties

Properties for tireData object

Since R2023b

tireData properties contain information that describe tire dynamics. Use dot notation to refer to a particular object and property.

tData = tireData(filepath);
coordSystem = tData.CoordinateSystem;

Note

Nonempty properties specified as a column vector must all be the same length.

Read-Only Properties

CoordinateSystem — Coordinate system

Read-only: "ISO" (default) | "SAE" | "H"

This property is read-only.

Coordinate system, specified as "ISO", "SAE", or "H". For more information, see Tire and Wheel Coordinate Systems.

Note

Use the coordinateTransform function to transform tire data channels to a specified coordinate system.

Filename — Data file name

Read-only: string

This property is read-only.

Data file name, specified as a string.

Filepath — Data file path

Read-only: string

This property is read-only.

Data file path, specified as a string.

Elapsed Time and Segment

et — Elapsed time

column vector

Elapsed time, specified as a column vector with nonnegative values, in s.

Data Types: double

seget — Segment elapsed time

column vector

Segment elapsed time, specified as a column vector with nonnegative values, in s.

Data Types: double

segment — Test segment number

column vector

Test segment number, specified as a column vector.

Data Types: double

measnumb — Measurement number

column vector

Measurement number, specified as a column vector.

Data Types: double

Forces, Moments, and Pressure Information

Fx — Longitudinal force

column vector

Longitudinal force, specified as a column vector, in N.

Data Types: double

Fy — Lateral force

column vector

Lateral force, specified as a column vector, in N.

Data Types: double

Fz — Normal force

column vector

Normal force, specified as a column vector, in N.

Data Types: double

Mx — Overturning moment

column vector

Overturning moment, specified as a column vector, in Nm.

Data Types: double

My — Rolling moment

column vector

Rolling moment, specified as a column vector, in Nm.

Data Types: double

Mz — Self-aligning moment

column vector

Self-aligning moment, specified as a column vector, in Nm.

Data Types: double

Tw — Wheel torque

column vector

Wheel torque, specified as a column vector, in Nm.

Data Types: double

IP — Inflation pressure

column vector

Inflation pressure, specified as a column vector with nonnegative values, in kPa.

Data Types: double

Slip Information

alpha — Slip angle

column vector

Slip angle, specified as a column vector, in rad.

Data Types: double

gamma — Inclination angle

column vector

Inclination angle, specified as a column vector, in rad.

Data Types: double

kappa — Longitudinal slip

column vector

Longitudinal slip, specified as a column vector, dimensionless.

Data Types: double

phi — Total tire spin

column vector

Total tire spin, specified as a column vector, in 1/m.

Data Types: double

phit — Turn slip

column vector

Turn slip, specified as a column vector, in 1/m.

Data Types: double

Velocity Information

Vx — Longitudinal velocity

column vector

Longitudinal velocity, specified as a column vector, in m/s.

Data Types: double

Vy — Lateral velocity

column vector

Lateral velocity, specified as a column vector, in m/s.

Data Types: double

V — Total velocity

column vector

Total velocity, specified as a column vector, in m/s.

Data Types: double

omega — Wheel spin velocity

column vector

Wheel spin velocity, specified as a column vector, in rad/s.

Data Types: double

psidot — Turn slip velocity

column vector

Turn slip velocity, specified as a column vector, in rad/s.

Data Types: double

Length Information

RL — Loaded radius

column vector

Loaded radius, specified as a column vector, in m.

Data Types: double

Re — Effective radius

column vector

Effective radius, specified as a column vector, in m.

Data Types: double

Rdyn — Dynamic rolling radius

column vector

Dynamic rolling radius, specified as a column vector, in m.

Data Types: double

rhoz — Radial deflection

column vector

Radial deflection, specified as a column vector, in m.

Data Types: double

dist — Travel distance

column vector

Travel distance, specified as a column vector, in m.

Data Types: double

sig_x — Longitudinal relaxation length

column vector

Longitudinal relaxation length, specified as a column vector, in m.

Data Types: double

sig_y — Lateral relaxation length

column vector

Lateral relaxation length, specified as a column vector, in m.

Data Types: double

patch_a — Half the contact patch length

column vector

Half the contact patch length, specified as a column vector, in m.

Data Types: double

patch_b — Half the contact patch width

column vector

Half the contact patch width, specified as a column vector, in m.

Data Types: double

Temperature Information

Ta — Ambient temperature

column vector

Ambient temperature, specified as a column vector, in degC.

Data Types: double

Tsurface — Test surface temperature

column vector

Test surface temperature, specified as a column vector, in degC.

Data Types: double

TtreadI — Tread surface temperature (inside shoulder)

column vector

Tread surface temperature (inside shoulder), specified as a column vector, in degC.

Data Types: double

TtreadC — Tread surface temperature (center rib)

column vector

Tread surface temperature (center rib), specified as a column vector, in degC.

Data Types: double

TtreadO — Tread surface temperature (outside shoulder)

column vector

Tread surface temperature (outside shoulder), specified as a column vector, in degC.

Data Types: double

Tsidewall — Sidewall surface temperature

column vector

Sidewall surface temperature, specified as a column vector, in degC.

Data Types: double

Tinnerliner — Innerliner surface temperature

column vector

Innerliner surface temperature, specified as a column vector, in degC.

Data Types: double

Tcavity — Tire cavity air temperature

column vector

Tire cavity air temperature, specified as a column vector, in degC.

Data Types: double

Other

UserData — User data channel to store user-defined data

column vector

User data channel to store user-defined data, specified as a column vector.

Data Types: double

label — Non-numeric data

column vector

Non-numeric data, specified as a column vector. You can process data from tireData objects by using this property to specify the criteria argument in the split and crop functions.

Example: label=["Warmup", "Warmup", "Warmup", "Slip angle sweep", "Slip angle sweep",...]

Data Types: string

Tire Information

Manufacturer — Tire manufacturer

string scalar

Tire manufacturer, specified as a string scalar.

Data Types: string

TireLine — Tire line

string scalar

Tire line, specified as a string scalar.

Data Types: string

TireCategory — Tire category

string scalar

Tire category, specified as a string scalar.

Data Types: string

ConstructionNumber — Tire construction number

string scalar

Tire construction number, specified as a string scalar.

Data Types: string

SerialNumber — Tire serial number

nonnegative scalar

Tire serial number, specified as a nonnegative scalar, unitless.

Data Types: double

TireSize — Tire size

string scalar

Tire size, specified as a string scalar.

Example: TireSize="275/65R18"

Data Types: string

SectionWidth — Section width

nonnegative scalar

Section width, specified as a nonnegative scalar, in mm.

Example: SectionWidth=275

Data Types: double

AspectRatio — Aspect ratio

nonnegative scalar

Aspect ratio, specified as a nonnegative scalar, in percent.

Example: AspectRatio=65

Data Types: double

RimDiameter — Rim diameter

nonnegative scalar

Rim diameter, specified as a nonnegative scalar, in inches.

Example: RimDiameter=18

Data Types: double

OverallDiameter — Overall diameter

nonnegative scalar

Overall diameter, specified as a nonnegative scalar, in m.

Example: OverallDiameter=0.815

Data Types: double

LoadIndex — Load index

nonnegative scalar

Load index, specified as a nonnegative scalar, unitless.

Example: LoadIndex=116

Data Types: double

SpeedSymbol — Speed symbol

string scalar

Speed symbol, specified as a string scalar.

Data Types: string

StampedMaxLoad — Stamped max load

nonnegative scalar

Stamped max load, specified as a nonnegative scalar, in kg.

Example: StampedMaxLoad=1250

Data Types: double

DOTcode — DOT tire identification number

string scalar

DOT tire identification number, specified as a string scalar.

Data Types: string

Tire Mass and Inertia

Mass — Tire mass

nonnegative scalar

Tire mass, specified as a nonnegative scalar, in kg.

Data Types: double

Ix — Tire rotational inertia about x-axis

nonnegative scalar

Tire rotational inertia about the x-axis, specified as a nonnegative scalar, in kg*m^2.

Data Types: double

Iy — Tire rotational inertia about y-axis

nonnegative scalar

Tire rotational inertia about the y-axis, specified as a nonnegative scalar, in kg*m^2

Data Types: double

Iz — Tire rotational inertia about z-axis

nonnegative scalar

Tire rotational inertia about the z-axis, specified as a nonnegative scalar, in kg*m^2.

Data Types: double

Tire Test Information

TestDate — Test data and time

datetime scalar

Test data and time, specified as a datetime scalar.

TestFacility — Test facility

string scalar

Test facility, specified as a string scalar.

Data Types: string

TestMachine — Test machine

string scalar

Test machine, specified as string scalar.

Data Types: string

TestRequest — Test request identifier

string scalar

Test request identifier, specified as a string scalar.

Data Types: string

TestMethod — Test method

string scalar

Test method, specified as a string scalar.

Data Types: string

RimWidth — Test rim width

nonnegative scalar

Test rim width, specified as a nonnegative scalar, in inches.

Data Types: double

RimType — Test rim type

string scalar

Test rim type, specified as a string scalar.

Data Types: string

NominalFz — Nominal test load

nonnegative scalar

Nominal test load, specified as a nonnegative scalar, in N.

Data Types: double

NominalIP — Nominal inflation pressure

nonnegative scalar

Nominal inflation pressure, specified as a nonnegative scalar, in Pa.

Data Types: double

NominalAlpha — Nominal slip angle

scalar

Nominal slip angle, specified as a scalar, in rad.

Data Types: double

NominalGamma — Nominal inclination angle

scalar

Nominal inclination angle, specified as a scalar, in rad.

Data Types: double

NominalKappa — Nominal longitudinal slip

scalar

Nominal longitudinal slip, specified as a scalar, unitless.

Data Types: double

PressureRegulation — Inflation pressure regulation method

string scalar

Inflation pressure regulation method, specified as a string scalar.

Data Types: string

Surface — Test surface description

string scalar

Test surface description, specified as a string scalar.

Data Types: string

SurfaceCondition — Test surface condition description

string scalar

Test surface condition description, specified as a string scalar.

Data Types: string

SurfaceCurvature — Test surface curvature

scalar

Test surface curvature, specified as a scalar, in 1/m.

Data Types: double

TireWheelAssembly — Tire and wheel assembly notes

string scalar

Tire and wheel assembly notes, specified as a string scalar.

Data Types: string

RunNumber — Run number

scalar

Run number, specified as a scalar.

Data Types: double

SweepNumber — Sweep number

scalar

Sweep number, specified as a scalar.

Data Types: double

Comments — Comments about test

string vector

Comments about test, specified as a string vector.

Data Types: string

Version History

Introduced in R2023b

R2025a: New tireData object properties

Starting in R2025a, these new properties can be set:

• Label

• RimType

• RunNumber

• SweepNumber

• TireCategory