Release v0.3

New features

• Implementation of a limited electric boost for f1-3dof vehicles. See the example examples/python/f1/optimal-laptime/3-boost. This requires an extra XML element:

  <rear_axle> 
      <boost> 
          <maximum_power> value </maximum_power> 
      </boost> 
  </rear_axle>

• New tracks are available thanks to our contributors! Check the full list here

Changes to the API

• As usual, take a fresh look at the examples

• delete_variables(), delete_variable(), delete_variables_by_prefix() unified into a single delete_variable() that can take regular expressions

• In python: new function dict = download_variables(prefix, variables) that downloads all variables given by name in the list variables and with prefix prefix into a dictionary. This can be used to download all optimal laptime variables in one go using

  run = fastest_lap.download_variables(*fastest_lap.optimal_laptime(vehicle,track,s,options));

  this will load all possible outputs into a python dictionary whose variables can be extracted using run["variable_name"]

• Optimal laptime: all available variables can be exported if <variables/> is not present in the option list. To export all variables use:

  <output_variables>
      <prefix> run/ </prefix>
  </output_variables>

  If you only want to export some variables, you can still use <variables/> as in earlier releases:

  <output_variables>
      <prefix> run/ </prefix>
      <variables>
           <chassis.velocity.x/>
           <time/>
           <laptime/>
      </variables>
  </output_variables>

  I have not experienced any performance degradation when exporting all variables as compared to exporting some variables.

• Variables have been renamed. Some changes are:

  old	new	old	new
  u	chassis.velocity.x	ax	chassis.acceleration.x
  v	chassis.velocity.y	ay	chassis.acceleration.y
  x	chassis.position.x	psi	chassis.attitude.psi
  y	chassis.position.y	delta	front-axle.steering-angle
  throttle	chassis.throttle

Bug fixes

• Bug fix in steady-state (g-g diagram) computations: the yaw torque equation was not successfully solved.
• Circuit preprocessor: error was not properly computed in some cases: #24

Usage

Download and unzip. The contents of the zip folder are:

• bin: the dynamic libraries. Fastest-lap C++ core is there. If fastest-lap is used from MATLAB, point loadlibrary() to this directory.
• include: fastestlapc.h and fastest_lap.py. To use python scripts, make sure this folder is on the PYTHONPATH
• examples: python notebook examples.
• database: car and track data
• lib: the static library, needed to link with visual studio

Included pull requests

• Unused Attribute by @kvkpraneeth in #29
• Added European Tracks by @pierre-trott in #23

New Contributors

• @kvkpraneeth made their first contribution in #29
• @pierre-trott made their first contribution in #23

Full Changelog: v0.2...v0.3