Fast-F1

Bug Fixes

• temporarily restrict Pandas<2.1.0 due to unexpected API changes

New Features

• Added additional circuit information that includes the location of corners,
  marshal lights, marshal sectors and the rotation of the track map. This
  data is available through fastf1.core.Session.get_circuit_info. Also
  check out the new examples that show how to annotate your plots using this
  data.
  A huge thank you to @multiviewer (https://multiviewer.app/) for providing
  this information through MultiViewer's API.

• "SessionInfo" data from the F1 livetiming API is now available through
  fastf1.core.Session.session_info

• Added driver colors for Shwartzman and Lawson (by @pesaventofilippo) (#441)

• Various improvement to the Laps.pick_* methods to make it easier to select
  specific laps from fastf1.core.Laps (by @Casper-Guo) (#376).

  New (no equivalent has existed before)

  • fastf1.core.Laps.pick_not_deleted for selecting all laps that
    haven't been deleted

  New (these methods replace methods that only accepted single values; the
  new functions accept single values or lists of values)

  • fastf1.core.Laps.pick_laps for selecting one or multiple laps
    by their lap number; replaces fastf1.core.Laps.pick_lap

  • fastf1.core.Laps.pick_drivers for selecting laps from one or
    multiple drivers; replaces fastf1.core.Laps.pick_driver

  • ~fastf1.core.Laps.pick_compounds for selecting laps driven on one or
    multiple compounds; replaces fastf1.core.Laps.pick_tyre

  Improved

  • fastf1.core.Laps.pick_track_status now has additional options for
    the how argument to exclude laps with a specific track status or match
    or exclude laps with one of multiple track status values.

Performance

• greatly improved speed when parsing car data and position data

Bug Fixes

• Fixed ~fastf1.core.Laps.split_qualifying_sessions returns
  incorrect result

• Fixed incorrect calculation of results for Qualifying-like sessions (#429)

• Fixed incorrect alignment of lap start/end times that causes shifted telemetry
  data when comparing laps and incorrect results for calculated grid positions
  (#440)

• Fixed an unhandled exception in the lap timing parser that made it impossible
  to load data for the 2020 Miami Qualifying (#431)

• Fixed incorrectly set lap start times after some red flag restarts

• Fixed a bug that could prevent data loading in case of partially missing data

Deprecations

• Deprecated fastf1.core.Laps.pick_lap

• Deprecated fastf1.core.Laps.pick_driver

• Deprecated fastf1.core.Laps.pick_tyre

Other Changes

• Fixed some errors in the documentation (by @dawiddzhafarov, @RyanHaniff)
  (#439, #402)

• Fixed some examples to no longer use deprecated arguments (by @wakamex) (#423)

• Fixed an error in the SignalRClient example (by @erdieee) (#421)

• Added a new team pace ranking example (by @Casper-Guo) (#420)

Release has been yanked - use v3.1.1

(Broken package due to incorrect package definition)

• Fixed an issue that prevented telemetry data from being loaded when position
  data is missing (and vice versa) (#412)

• Fixed loading of Sprint Shootout results
  (#413, regression introduced in v3.0.3)

• Added driver color for Ricciardo at AlphaTauri (by @pesaventofilippo in #418)

This release forces a cache update after updating from v3.0.4 and lower. Else, the changes from v3.0.5 are not applied if the data is cached already.

• Fixed an error when loading historic sessions (#400).

• Fixed an error where lap times are incorrectly not marked as 'Personal Best'.
  This also caused Laps.pick_fastest to return incorrect laps. (#403)

• Added missing color for compound "TEST-UNKNOWN" (by @Casper-Guo)
• Bumped minimum version requirement for dependency 'timple'

• Fixed incorrectly formatted color codes for tyre compound colors.
  (by @Casper-Guo)

• Fixed a bug that prevented the calculation of results for Qualifying-like
  sessions (for example Sprint Shootout) that only occurred on Pandas v1.5.3
  and older.

• Improved support for Sprint Shootout sessions and added session results for
  these. (by @mdsakalu)

• Improved exception handling on various internal functions

New Contributors

• @mdsakalu made their first contribution in https://github.com/theOehrly/Fast-F1/pull/363

Bug Fixes

• fixed a bug that prevented the use of the livetiming client from the
  commandline

This release offers a huge amount of new features and bug fixes.

Read more about all the changes in the Release Notes

New Contributors

• @TasosOperatingInBinary made their first contribution in https://github.com/theOehrly/Fast-F1/pull/250
• @Toskosz made their first contribution in https://github.com/theOehrly/Fast-F1/pull/276
• @Neron-png made their first contribution in https://github.com/theOehrly/Fast-F1/pull/285
• @SpyrosKoun made their first contribution in https://github.com/theOehrly/Fast-F1/pull/303
• @BCurbs made their first contribution in https://github.com/theOehrly/Fast-F1/pull/287
• @f1multiviewer made their first contribution in https://github.com/theOehrly/Fast-F1/pull/319
• @Casper-Guo made their first contribution in https://github.com/theOehrly/Fast-F1/pull/326
• @daylinmorgan made their first contribution in https://github.com/theOehrly/Fast-F1/pull/333
• @TracingInsights made their first contribution in https://github.com/theOehrly/Fast-F1/pull/329
• @lmontrieux made their first contribution in https://github.com/theOehrly/Fast-F1/pull/337
• @harningle made their first contribution in https://github.com/theOehrly/Fast-F1/pull/351

Maintenance release that adds support for the new Sprint Shootout session type.

Maintenance release to require pandas <2.0.0 on a clean installation.

Maintenance release to add driver names and colours for the 2023 season.

Alpha release to test Ergast API support.

Bug Fixes:

• The matplotlib dependency version is now required to be >= 3.3.3 to prevent
  incompatibility. (#210)

• Fixed: NaT values for 'Time' or 'LapStartTime' may cause a crash
  in fastf1.core.Telemetry.calculate_driver_ahead (#151)

• Fixed: Data for speed trap 'SpeedST' is added to the wrong lap.
  This additionally caused empty laps to exist for some drivers at the
  beginning of some sessions.

• Fixed: fastf1.core.Telemetry.add_driver_ahead could not
  be called on previously resampled telemetry data. (#178)

• Added: Better error handling for sessions that did not take place.

• Fixed: Tyre compound shown for some laps was incorrect in some special
  cases. (#204)

• Fixed: Incorrect first and last name for Hulkenberg in fallback driver list
  (by @niallmcevoy)

• Fixed: metadata for ~fastf1.core.Telemetry was not propagated
  correctly in fastf1.core.Telemetry.merge_channels and
  fastf1.core.Telemetry.resample_channels.

• Fixed: incorrect call of scipy method in
  fastf1.legacy.inject_driver_ahead

• Fixed: Error handling regression in fastf1.core.Session.load

• Fixed: ~fastf1.core.DataNotLoadedError not raised for car_data and
  pos_data.

New Features:

• Added: Function fastf1.get_events_remaining (by @oscr)

• Added: Support for shorthand paths (e.g. '~/cache') in
  fastf1.Cache.enable_cache (by @oscr)

Changes:

• The default base url scheme for Ergast is changed from http to https.

Deprecations and Notices for Upcoming Changes:

• Deprecation: Undocumented function fastf1.ergast.fetch_weekend
  will be removed without a direct replacement in a future version
  (target: v3.0.0).

• Change: fastf1.utils.to_timedelta and
  fastf1.utils.to_datetime will return NaT instead of raising and
  exception if a valued cannot be parsed in a future version
  (target: v3.0.0).

• Fix a typo in :attr:fastf1.plotting.DRIVER_TRANSLATE (#207)

• Ensure that Session.drivers returns a list of
  unique values. This prevents problems that result from drivers being
  incorrectly listed multiple times in the session result information.
  (see #182 for example)

Bug Fixes:

• Fixed an issue that prevented merging of car data and position data
  in some cases (see #180)

Bug Fixes:

• Fixed incorrect lap start times for first lap after a red flag restart

• Fixed first lap missing if a driver crashed during the first lap of a
  sprint race (#175)

• Fixed headshot url missing from result of :func:fastf1.api.driver_info
  (by @bruzie in #173)

New Features:

• Added a check detect and to remove incorrect lap times in the api parser
  (#167)