Contenido principal

Tire Manager

Import, edit, plot, and fit tire data

Since R2026a

Description

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

The Tire Manager app lets you import, edit, plot, and fit tire data. You can also use the app to convert between tire model types and export tire models to supported Simulink® and Simscape™ wheel blocks to use in simulations.

This app uses the tireData and tireModel functions and methods. For more information, see Get Started with the Extended Tire Features for Vehicle Dynamics Blockset.

Tire manager app

Open the Tire Manager App

  • MATLAB® Toolstrip: On the Apps tab, under Automotive, click the Tire Manager icon.

  • MATLAB Command Window: Enter tireManager.

Parameters

expand all

Workspace

Click New Tire Add new tire icon. to create a new tire object. A new tire object contains an empty tire data object and an empty tire model folder.

Empty tire object in the workspace tree of the Tire Manager app.

Click Import Import tire data or tire model icon. to import tire data or tire models.

These options are available for importing tire data.

Tire Data Import OptionDescription

Import Data

Import tire data from files icon.

Import tire data from files. These file types are supported:

  • Tyre Data Exchange Format (TYDEX) v1.3 files

  • Calspan® DAT data files

Import Data from Workspace

Import tire data from workspace icon.

Import tire data from the MATLAB workspace. The workspace variable must be a tireData object.

Import Data from Folder

Import tire data from folder icon.

Import tire data from a folder. Optionally, select Include Subfolders to import data from all tire data files within the selected folder and its subfolders. These file types are supported:

  • Tyre Data Exchange Format (TYDEX) v1.3 files

  • Calspan DAT data files

All files are imported, even if both file types are present in the folder or its subfolders.

Tip

If the Tire Manager app does not support your tire data file type for direct import, first import the file to the workspace using the tireData.import function. Then, import the tire data from the workspace into the app.

These options are available for importing tire models.

Tire Model Import OptionDescription

Import TIR file

Import tire data from files icon.

Import tire model from a TIR file.

Import Model from Workspace

Import tire data from workspace icon.

Import tire model from the MATLAB workspace. The workspace variable must be a tireModel object.

Get Model from Block

Get model from block icon.

Import a tire model from a Simulink or Simscape block.

Click Duplicate Duplicate icon to duplicate a tire, data, or model object, depending on which node is selected in the Workspace tree.

Click Delete Delete icon to delete a tire, data, or model object, depending on which node is selected in the Workspace tree.

Tools

Click Edit Data Edit data icon to select one of these functions to edit tire data that is selected in the Workspace tree.

Tip

Select Keep Original to keep an original copy of the data set that you are editing.

OptionDescription

Crop

Crop icon

Remove data from a tire data set. The crop criteria are based on the x-axis. You can crop tire data sets interactively using the plot preview, or by entering values in the Crop Range (start) and Crop Range (end) edit boxes. The crop is applied to all the tire data sets that are selected in the Workspace tree.

Split

Split icon

Split a single tire data set into multiple tire data sets. You can split a tire data set interactively using the plot preview, or by specifying the data criteria for splitting. You can split only one data set at a time. The split is applied to the selected data in the Workspace tree.

Filter

Filter icon

Apply a filter to a tire data channel. Define the filter design method and the parameter values to filter a data set under Edit Data Settings. You can include all selected data or select a specific data set to preview in the plot. The filter is applied to all tire data sets that are selected in the Workspace tree.

These filter methods are available.

Filter MethodParameters

Moving Mean

Window length

Transfer Function Coefficients

Filter coefficients a and b

Low-pass Cutoff Frequency

Cutoff frequency

Optionally, sampling frequency when elapsed time is missing, or to ignore elapsed time data

Note

The Signal Processing Toolbox™ is required for the Transfer Function Coefficients and Low-pass Cutoff Frequency filter methods.

Mean

Mean icon

Assign the mean or median value of a tire data channel in a tire data set. You can include all selected data or select a specific data set to preview in the plot. The mean or median is applied to all tire data sets that are selected in the Workspace tree.

Downsample

Downsample icon

Decrease the sample rate of a tire data set by an integer factor. Specify values for Downsample Factor and Sample Offset.

Tip

If you need to make edits that the Tire Manager app does not support, export the data to the workspace, make your edits, and then import the data to the app again.

Click Convert Convert icon to convert between tire model types. The convert function is applied to the tire model selected in the Workspace tree.

These tire model types are supported:

  • Magic Formula 6.2

  • Magic Formula 5.2

  • Dugoff

  • Fiala

Model

Click New Fit to fit one of these tire model types to tire measurement data:

  • Fit New MF6.2 Model

  • Fit New MF5.2 Model

  • Fit New Dugoff Model

  • Fit New Fiala Model

  • Fit Selected Model

If tire data has already been imported for the tire object, you can choose to have the Tire Manager app automatically attach the existing data to the appropriate fit steps in the fit scheduler. See Settings.

Note

The fit function requires Optimization Toolbox™.

Publish

Click Export Import tire data or tire model icon. to export tire data or tire models. The item exported depends on which object is selected in the tree.

You can use these options to export tire data.

Tire Data Export OptionDescription

Export TYDEX File(s)

Export tire data to file icon.

Export tire data to TYDEX v1.3 data files.

Export CSV File(s)

Export tire data to file icon.

Export tire data to comma-separated value (CSV) files.

Export To Workspace

Export tire data to workspace icon.

Export tire data to the MATLAB workspace. The data is exported as a tireData object.

Tip

To customize the export of tire data, first export the tire data to the workspace. Then, use the export function to complete the process.

You can use these options to export tire models.

Tire Model Export OptionDescription

Export TIR file

Export tire data from workspace icon.

Export a tire model to a TIR file.

Export Model from Workspace

Export tire data from workspace icon.

Export a tire model to the MATLAB workspace. The tire model is exported as a tireModel object.

Click Set to Block Set to block icon to export a tire model selected in the Workspace tree to a Simulink or Simscape block.

Options

Click Settings Settings icon to specify these settings. Settings are saved with the session file.

TypeSettingDescription

Files

Import Options

Import Options setting

This setting determines whether to overwrite the tire data properties of the tire data object in the Workspace tree when importing new tire data from a TYDEX file or tire models form a TIR file, especially if the new data has different properties than those already imported. Select one of these options:

  • Always

  • Ask

  • Never

Filepaths

Filepaths setting

  • Session Filepath — Automatically updates after a session is saved for the first time

  • Tire Data Filepath — Automatically updates with the location of the imported data file

  • TIR Filepath — Automatically updates with the location of the imported tire model file

  • Simulink Blockpath — Automatically updates with the location of the block most recently used for getting or setting tire model parameters.

Model Fitting

Fit Scheduler Settings

Fit scheduler settings

Setting to specify whether tire data is attached to fit steps. Select one of these options:

  • Always

  • Ask

  • Never

Note

You can modify the data configured for each fit step from the settings of the selected fit step.

Default Optimization Settings

Default Optimization Settings

Option to select Optimization Solver and modify the default settings. Select one of these optimization solvers:

  • fmincon — For more information on solver options, see options (Optimization Toolbox).

  • fminunc — For more information on solver options, see options (Optimization Toolbox).

  • fsolve — For more information on solver options, see options (Optimization Toolbox).

  • lsqnonlin — For more information on solver options, see options (Optimization Toolbox).

Workspace

Tire Data Sorting

Tire Data Sorting settings

Option to Include Property Prefix in Workspace tree and to select Show Abbreviated Property Label or Show Full Property Label. Select how data is sorted in the Workspace tree by selecting from the Options list and adding to the Selected list. The available options are based on tire data properties. See tireData Properties.

For example, if Include Property Prefix in Workspace tree is selected, Show Abbreviated Property Label is selected, and the tree is sorted by test method and average inclination angle, the Workspace tree appears like this image.

Workspace tree

Fitting

Click Use Parallel Fit selected to end icon to enable parallel fitting. This option requires Parallel Computing Toolbox™.

The fit scheduler displays the fit steps relevant to the selected fit type. To edit a fit step, click the gear Fit scheduler settings gear icon icon. This action opens a document with these tabs:

  • Parameters — From the table on the Parameters tab, you can adjust parameter values, edit lower and upper bounds of a parameter, and change the selection of parameters to use for model fitting. If a parameter is defined in multiple fit steps, a warning appears in the table.

  • Data — View the test method and variable values for each data object. You can change the selection of data objects to use for model fitting.

  • Options — If applicable, the Options tab contains solver settings that you can modify for the fit step.

Tire Manager app fit step configuration

To view the results of a fit step, click the View Fit Results View fit results icon button next to the gear icon. The results document includes a table of fit results, a plot of the fit, error statistics, and optimization output.

Tire Manager app fit results

Programmatic Use

tireManager opens the Tire Manager app or brings focus to the app if it is already open.

tireManager("newSessionFile.mat") opens the Tire Manager app from the session file specified.

tireManager(tireData) opens the Tire Manager app with the tire data object specified.

tireManager(tireModel) opens the Tire Manager app with the tire model object specified.

Version History

Introduced in R2026a