Skip to content

teasit/magic-formula-tyre-library

Repository files navigation

Magic Formula Tyre Library

View on File Exchange GitHub release (latest by date) MATLAB Latest Tests Status

Social-Preview

[FX,FY,MZ,MY,MX] = magicformula(params,__)
  • Computationally efficient
  • Code generation compatible
  • Automated fitting to data
  • TIR (*.tir) import/export
  • TYDEX (*.tdx) import/export

Requirements

  • MATLAB Base
  • (Optional) Optimization Toolbox (fitting)
  • (Optional) Parallel Computing Toolbox (parallel fitting)

Release Compatibility

  • R2023b
  • R2022b
  • R2021b
  • R2020b

Installation

Usage and Examples

See GettingStarted.mlx to get started. If you install the library as a toolbox, you will be prompted to open said Live Script. It contains an overview of the library and is the recommended way to get started.

Example: Model vs. Data

This code generates the title figure of this README. Either clone the library or install it as a toolbox and try it yourself. You can download the example data here. The data has been de-identified to conform with the FSAE TTC's license agreement.

parser = tydex.parsers.FSAETTC_SI_ISO_Mat();
measurements = parser.run('doc/examples/ttc/drivebrake.mat');
tyre = MagicFormulaTyre('doc/examples/ttc/obfuscated.tir');
figure(); grid on; hold on
magicformula.plots.compareFxSX(tyre, measurements(2:5))

Model vs. Data Plot

Example: Friction Ellipse

Also known as the Kamm-Circle when approximating the tire friction limit as a circle when it actually is an ellipse.

tyre = MagicFormulaTyre('doc/examples/ttc/obfuscated.tir');
figure(); grid on; hold on
magicformula.plots.kamm(tyre)

Kamm Plot

Further examples can be found in the doc/examples folder.

Motivation

The project was motivated by my work in the Formula Student Team UPBracing. My goal was to create an easy-to-use MATLAB library for other students to use in their vehicle dynamics projects.

This project would not have been possible without the data provided by the Formula SAE Tire Test Consortium (FSAE TTC) and the Calspan Tire Testing Research Facility (TIRF). De-identified and obscured test data has been used in examples and images or recordings of the application, to conform to the license agreement. Special thanks to Dr. Edward M. Kasprzak for granting me permission to provide the used, de-identified and obscured data for demonstration purposes.

Known Issues

  • Currenlty only version 6.1.2 (61) is implemented
  • Turnslip is ignored