convert

R2026b

Class: tireModel

Convert tire model to another tire model type

Since R2025a

expand all in page

Syntax

[newObj,errorStat,optimOutput,H] = convert(obj,modelType)
[newObj,errorStat,optimOutput,H] = convert(obj,modelType,Name=Value)

Description

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

This feature requires the Optimization Toolbox™.

[newObj,errorStat,optimOutput,H] = convert(obj,modelType) converts the tire model specified by obj to another tire model type specified by modelType.

[newObj,errorStat,optimOutput,H] = convert(obj,modelType,Name=Value) converts a tire model to another tire model type with additional options specified by one or more Name=Value arguments.

example

Note

The convert method refits the original tire model to the specified tire model type.

Input Arguments

expand all

Tire model, specified as a tireModel object.

Tire model type, specified as one of these values:

  • "MF62"

  • "MF"

  • "MF52"

  • "Dugoff"

  • "Fiala"

Note

Using the "MF" option is equivalent to specifying ModelType as "MF62".

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: convertedModel = convert(tireModel,"MF52",Solver="fminunc",PlotFit=true)

Solver, specified as one of these values:

  • "fmincon"

  • "fminunc"

  • "fsolve"

  • "lsqnonlin"

Example: Solver="fsolve"

Data Types: string

Optimization options, specified as the output of optimoptions. This table provides a link to the options table for each solver.

SolverLink to Options Table
fminconoptions (Optimization Toolbox)
fminuncoptions (Optimization Toolbox)
fsolveoptions (Optimization Toolbox)
lsqnonlinoptions (Optimization Toolbox)

Example: optimoptions="fmincon"

Option to plot model fit, specified as false or true.

Example: PlotFit=true

Data Types: logical

Output Arguments

expand all

Converted tire model, returned as a tireModel object. If the source model has scale factors other than one, then the scaled tire model behavior is built into the new model.

Each model type has its own fitting behavior based on the parameters it supports. This table describes the differences in fitting behavior when converting from one tire model type to another:

Source Model TypeTarget Model TypeFit Behavior

Any

Magic Formula 6.2

All pressure and turnslip parameters are assigned to zero.

A default pressure of 260,000 kPa is assigned to NOMPRES and INFLPRES.

Dugoff

Fiala

Magic Formula 6.2

Magic Formula 5.2

Fit types for data channels that are not modeled by Dugoff or Fiala are not fit. The target model maintains default behavior for fit types unsupported by the source model.

Magic Formula 6.2

Magic Formula 5.2

The Magic Formula 6.2 tire model is evaluated at the INFLPRES property value for the Magic Formula 5.2 model fit. The Magic Formula 5.2 tire model does not have a fit option for Contact Patch Width.

Any

Dugoff

Fiala

Only valid fitTypes are executed for Dugoff and Fiala.

Error statistics of the model fit, returned as a structure. The structure contains the error algorithm, the initial error before the fit, and the final error after the fit.

Information about the optimization process, returned as a structure. The returned structure fields depend on the selected solver. This table provides a link to the fields returned for each solver.

SolverLink to Structure Fields
fminconoutput (Optimization Toolbox)
fminuncoutput (Optimization Toolbox)
fsolveoutput (Optimization Toolbox)
lsqnonlinoutput (Optimization Toolbox)

Handle to axes, returned as an object handle.

Examples

expand all

This example uses:

Open Live Script

You can convert an MF 5.2 tire model to an MF 6.2 tire model to use in a supported Simulink® tire block.

Note that the MF 5.2 tire model is not supported for these Simulink tire blocks:

Follow these steps when you have an MF 5.2 tire model but want to simulate the tire behavior using a supported Simulink tire block.

Typically, you would import your MF 5.2 tire model parameter set to create a tire model object. For this example, create a new default MF 5.2 tire model object. Next, use the convert method to convert the MF 5.2 tire model to an MF 6.2 tire model. Then, use the set method to export the updated tire model parameter values to the tire block.

Create MF 5.2 Tire Model and Convert to MF 6.2 Tire Model

Create a default MF 5.2 tire model object.

tm52 = tireModel.new("MF52");

Convert the MF 5.2 tire model to an MF 6.2 tire model using the convert method.

tm62 = convert(tm52,"MF62");
Generating synthetic data.
Fitting Fx Pure (1 of 12).
Fitting Fy Pure (2 of 12).
Fitting Mz Pure (3 of 12).
Fitting Fx Combined (4 of 12).
Fitting Fy Combined (5 of 12).
Fitting Mz Combined (6 of 12).
Fitting Mx (7 of 12).
Fitting My (8 of 12).
Fitting RL (9 of 12).
Fitting Re (10 of 12).
Fitting Fx Relaxation Length (11 of 12).
Fitting Fy Relaxation Length (12 of 12).
Fitting complete.

Load Simulink Model and Set Tire Block Parameters

Load the Simulink model containing the supported Combined Slip Wheel 2DOF block.

load_system("tm62_export_to_block.slx");

Export the MF 6.2 tire model parameter values to the tire block.

set(tm62,"tm62_export_to_block/Combined Slip Wheel 2DOF");

Version History

Introduced in R2025a

See Also

| | |