==================== FastF1 documentation ==================== For the passionate F1 nerds. To get a quick overview over how to use FastF1, check out :doc:`examples/index` or the :doc:`examples_gallery/index`. Furthermore, there are some great articles and examples written by other people. They provide a nice overview about what you can do with FastF1 and might help you to get started. - `Accessing Formula-1 Race's historical data using Python (medium.com) `_ - `Formula 1 Data Analysis Tutorial - 2021 Russian GP: "To Box, or Not to Box?" (medium.com) `_ - `How I Analyze Formula 1 Data With Python: 2021 Italian GP (medium.com) `_ Introduction ============ FastF1 gives you access to F1 lap timing, car telemetry and position, tyre data, weather data, the event schedule and session results. The module is designed around Pandas, Numpy and Matplotlib. This makes it easy to use while offering lots of possibilities for data analysis and visualization. FastF1 handles big chunks of data (~50-100mb per session) so most of the information is stored locally as cached requests (be aware). All data is downloaded from two sources: - The official f1 data stream -> `f1-live `_ - Ergast web api -> `ergast.com `_ Have fun! Installation ============ It is recommended to install FastF1 using pip: pip install fastf1 Note that Python 3.8 or higher is required. (The live timing client does not support Python 3.10, therefore full functionality is only available with Python 3.8 and 3.9) Alternatively, a wheel or a source distribution can be downloaded from Pypi. .. toctree:: ← Back to Github .. toctree:: :maxdepth: 1 :caption: Contents: examples/index examples_gallery/index fastf1 core events api utils plotting livetiming legacy .. toctree:: :maxdepth: 1 :caption: Information: time_explanation howto_accurate_calculations known_bugs troubleshooting contributing/index changelog ============== Available Data ============== The following is a short overview over the available data with some references to functions and objects used to work with this data. - The event schedule for past seasons and the current season, including upcoming events. The schedule provides event names, countries, locations, dates, scheduled starting times and more. See :func:`fastf1.get_event_schedule`, :class:`~fastf1.events.EventSchedule` This data is also available for individual events. See :func:`fastf1.get_event`, :class:`~fastf1.events.Event` - Driver information and session results, including driver names, team names, finishing and grid positions, points, and more. See :class:`~fastf1.core.SessionResults`, :class:`~fastf1.core.DriverResult` - Lap timing data including sector times, lap times, pit stops, tyre data and more. See :class:`~fastf1.core.Laps` - Telemetry data including speed, rpm, gear and more. See :class:`~fastf1.core.Telemetry` Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` For questions feel free to contact me: oehrly@mailbox.org Notice ------ FastF1 is unofficial software and in no way associated with the Formula 1 group of companies.