Magic Formula Tyre Library

MATLAB library for Magic Formula Tyre Modeling
778 descargas
Actualizado 21 ene 2024

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

Citar como

Tom Teasdale (2024). Magic Formula Tyre Library (https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.2.0), GitHub. Recuperado .

Compatibilidad con la versión de MATLAB
Se creó con R2023b
Compatible con cualquier versión desde R2020b
Compatibilidad con las plataformas
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Versión Publicado Notas de la versión
2.2.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.2.0

2.1.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.1.0

2.0.4

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.0.4

2.0.3.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.0.3

2.0.2.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.0.2

2.0.1.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.0.1

2.0.0.0

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v2.0.0

1.1.3

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v1.1.3

1.1.2

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v1.1.2

1.1.1

See release notes for this release on GitHub: https://github.com/teasit/magic-formula-tyre-library/releases/tag/v1.1.1

1.1.0

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.1.0

1.0.5

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.0.5

1.0.4

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.0.4

1.0.3

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.0.3

1.0.2

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.0.2

1.0.1

See release notes for this release on GitHub: https://github.com/teasit/mftyre-matlab-library/releases/tag/v1.0.1

1.0.0

Para consultar o notificar algún problema sobre este complemento de GitHub, visite el repositorio de GitHub.
Para consultar o notificar algún problema sobre este complemento de GitHub, visite el repositorio de GitHub.