tireModel.import

R2026b

Class: tireModel

Create new tire model object with parameters from external file or MATLAB structure

Since R2023b

Syntax

obj = tireModel.import(parameterSet)

Description

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

obj = tireModel.import(parameterSet) imports a tire model parameter set specified by parameterSet to create a tire model object.

Input Arguments

parameterSet — Tire model parameter set

MATLAB^® structure | array of strings

Tire model parameter set, specified as a MATLAB structure or an array of string paths to a .TIR tire property file or .MAT MATLAB data file. The .MAT file must contain a structure variable defining all parameter values.

Note

Supported tire model types are

• Fiala

• Dugoff

• Magic Formula 5.2

• Magic Formula 6.2

Output Arguments

obj — Tire model

array of tireModel objects

Tire model, returned as an array of tireModel objects.

Examples

Import Tire Model Parameters from Structure

Create a tire model object by importing parameters from a MATLAB structure. This approach is useful when you have tire parameters stored in a workspace variable, such as from a calibration workflow or external data source.

Create a parameter structure by converting a tire model to a structure.

tmSource = tireModel.new("MF62");
params = struct(tmSource);

Import the parameter structure to create a new tireModel object. The imported model contains all parameter values from the source structure. Unlike built-in models, imported models have editable parameters and can be exported to .TIR files.

tm = tireModel.import(params)

tm =
tireModel Type MF62
    Model Name: Magic Formula v6.2
    Plysteer: true
    Turnslip: true
    Source Path: params

    Tire Properties

                Manufacturer:  []
                    TireLine:  []
                TireCategory:  []
                ...

    Model Parameters

                         [MODEL]
                          FITTYP: 62
                        TYRESIDE: RIGHT
                          LONGVL: 16.7
                        ...

Version History

Introduced in R2023b

R2025a: Tire model types supported

Starting in R2025a, the tireModel.import method only supports importing Magic Formula tire model versions 5.2 and 6.2. Other Magic Formula tire model versions are not supported.