Magic Formula Tyre Library

版本 2.2.0 (7.7 MB) 作者: Tom Teasdale
MATLAB library for Magic Formula Tyre Modeling
5.0
(2)
978.0 次下载
更新时间 2024/1/21
在 GitHub 上查看许可证

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

引用格式

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

MATLAB 版本兼容性
创建方式 R2023b
与 R2020b 及更高版本兼容
平台兼容性
Windows macOS Linux

Community Treasure Hunt

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

Start Hunting!

src

src/+magicformula

src/+magicformula/+exceptions

src/+magicformula/+plots

src/+magicformula/+v52

src/+magicformula/+v61

src/+tydex

src/+tydex/+parsers

src/@MagicFormulaTyre

src/enum

src/simulink

doc/examples

src/simulink

doc

doc/examples

版本 已发布 发行说明
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

要查看或报告此来自 GitHub 的附加功能中的问题，请访问其 GitHub 仓库。
要查看或报告此来自 GitHub 的附加功能中的问题，请访问其 GitHub 仓库。