v2.2.0

Changelog

• NEW: Range checks (e.g. FZMIN < FZ < FZMAX)
• small readability improvements
• simulink library was out-of-date

v2.1.0

Changelog

• NEW: FSAE TTC Parser refactored for readability and to remove
  'Signal Processing Toolbox' as a requirement to run the parser
• NEW: Kamm Circle plot

v2.0.4

Changelog

• FIX: bug in import script for FSAE TTC data (prominently occured in Round 9 data)

v2.0.3

Changelog

• CHANGED: input handling of "VX" was not ideal; now has more fallback levels
• CHANGED: Fitter settings are not stored as optim.options.SolverOptions but as struct.
  This is easier to handle when storing settings in the global MATLAB settings().
• FIX: parser handling of FSAE TTC MAT files
• improved error handling

v2.0.2

Changelog

• FIX: Definition of enumeration "MagicFormulaVersion" caused unnecessary
  dependency to Simulink, so it had to be installed for MATLAB-only.
• NEW: Automatic unit tests on GitHub; this tells you which MATLAB releases
  are compatible.

v2.0.1

Changelog

• FIX: GettingStarted.mlx missed a line of code

v2.0.0

Changelog

In this big update I tried to refactor the library in a way that eases the
use of the functions at the command-line. The most notatble change is the
magicformula() function that acts as a version-independent convenience
function to evaluate parameter sets. To make the function-call easier, a few
input arguments have been declared optional. For this change, the order of
arguments has been changed as noted below.

• FIX: Within calculation of Fy0, the pacejka equation (4.E30) used a wrong
  paramter (PKY5 instead of PPY5). This is now fixed!
• NEW: Convenience function magicformula().
  Intended to replace calling magicformula.v61.eval() directly.
  In the future, this function is supposed to be able to evaluate
  different versions of parameter sets (e.g. both v52 and v61).
• NEW: Convenience class MagicFormulaTyre. See examples.
• NEW: Plot package. Use magicformula.plots to access them.
• NEW: Added calculation of MZ, MY, MX. Can also be fitted. See examples.
• NEW: Velocity can now be passed as an input (influences combined slip FX/FY and MZ calculations)
• BREAKING: Moved +tir package into +magicformula.
• BREAKING: order of arguments changed for evaluation functions:
  OLD (params,SA,SX,IA,IP,FZ,side) --> NEW (params,SX,SA,FZ,IP,IA,VX,side)
  Rationale was to put arguments that can more easily be ommited last
  and make them optional. Slip ratio (SX) and slip angle (SA) are usually
  known or assumed zero, so they are the only mandatory arguments.
  All other inputs can be set to nominal values from parameter set or
  set to zero.
• BREAKING: position of multiple functions and classes within the package
  +magicformula has changed; subpackage +v62 has been corrected to
  +v61. If you have been using some functions or classes within the
  magicformula package, make sure you update their path.
  (e.g. magicformula.v62.equations.Fx0 --> magicformula.v61.Fx0)
• BREAKING: order of outputs of magicformula() function changed:
  [FX,FY,mux,muy] --> [FX,FY,MZ,MY,MX] (mue have been removed)

v1.1.3

Changelog

• Can now read TYDEX files instead of only exporting. See this example for examples

v1.1.2

Changelog

• Renaming of library and functions

v1.1.1

Changelog

• Renaming of library and functions due to trademark issues
• Added example measurement data (de-identified and obscured TTC data)
• Updated FSAE TTC interactive example to use new data
• Updated unit tests
• Convenience changes:

  • New: Wrapper for magicformula.v62.eval() function. Can now call method eval() on magicformula.v62.Model objects. Example:

    model = magicformula.v62.Model();
    model.importTyrePropertiesFile(file)
    [FX, FY] = model.eval(SA, SX, IA, IP, FZ, 0);

  • New: Can now instantiate magicformula.v62.Model directly with TIR file, without having to call importTyrePropertiesFile() method. Example:

    model = magicformula.v62.Model(file);
    [FX, FY] = model.eval(SA, SX, IA, IP, FZ, 0);