# tif1

> High-performance Formula 1 data analysis for Python with a FastF1-compatible API.

## Docs

- [VERSIONING](https://tif1.tracinginsights.com/VERSIONING.md)
- [Async Fetch API](https://tif1.tracinginsights.com/api-reference/async-fetch.md): High-performance parallel HTTP fetching with niquests
- [Cache API](https://tif1.tracinginsights.com/api-reference/cache.md): Complete reference for interacting with the tif1 two-tier caching system
- [CDN API](https://tif1.tracinginsights.com/api-reference/cdn.md): Enterprise-grade multi-source CDN management with automatic fallback, health tracking, and intelligent source selection
- [CLI Reference](https://tif1.tracinginsights.com/api-reference/cli.md): Complete command-line interface reference for tif1 - comprehensive guide to all CLI commands, options, workflows, and best practices
- [Configuration API](https://tif1.tracinginsights.com/api-reference/config.md): Comprehensive guide to configuring tif1 via config files, environment variables, and runtime API for optimal performance
- [Core API](https://tif1.tracinginsights.com/api-reference/core.md): Complete reference for Session, Driver, Lap, Laps, and Telemetry classes - the foundation of tif1
- [Core Utilities](https://tif1.tracinginsights.com/api-reference/core-utils.md): Internal utilities for DataFrame operations, JSON parsing, and backend conversion
- [Events & Schedule](https://tif1.tracinginsights.com/api-reference/events.md): Comprehensive API for discovering, querying, and working with Formula 1 events, Grand Prix schedules, and session metadata across multiple seasons
- [Exceptions](https://tif1.tracinginsights.com/api-reference/exceptions.md): Error handling and exception hierarchy
- [FastF1 Compatibility API](https://tif1.tracinginsights.com/api-reference/fastf1-compat.md): Drop-in replacement functions for migrating from fastf1
- [Fuzzy Matching](https://tif1.tracinginsights.com/api-reference/fuzzy.md): Comprehensive guide to fuzzy string matching for event and session name resolution in tif1
- [HTTP & Networking](https://tif1.tracinginsights.com/api-reference/http.md): Comprehensive technical reference for HTTP session management, async fetching, connection pooling, retry logic, circuit breakers, CDN fallback, and network optimization in tif1
- [HTTP Session Management](https://tif1.tracinginsights.com/api-reference/http-session.md): Advanced HTTP session management with intelligent connection pooling, DNS-over-HTTPS fallback, and comprehensive performance monitoring
- [I/O Pipeline API](https://tif1.tracinginsights.com/api-reference/io-pipeline.md): Internal data transformation and DataFrame construction pipeline
- [Jupyter Integration](https://tif1.tracinginsights.com/api-reference/jupyter.md): Rich display and notebook utilities
- [Lap Operations](https://tif1.tracinginsights.com/api-reference/lap-operations.md): Comprehensive guide to lap data operations, filtering, transformations, and analysis
- [Models](https://tif1.tracinginsights.com/api-reference/models.md): Comprehensive guide to Laps, Lap, Driver, Telemetry, SessionResults, DriverResult, and CircuitInfo classes
- [API Overview](https://tif1.tracinginsights.com/api-reference/overview.md): A comprehensive map of the tif1 programmatic interface
- [Plotting API](https://tif1.tracinginsights.com/api-reference/plotting.md): Visualization utilities and color schemes for F1 data
- [Retry & Reliability](https://tif1.tracinginsights.com/api-reference/retry.md): Circuit breaker, retry strategies, and failure handling
- [Schedule Schema & Validation](https://tif1.tracinginsights.com/api-reference/schedule.md): Comprehensive guide to schedule data validation, schema management, and internal data structures for Formula 1 event and session information
- [Data Types & Type Hints](https://tif1.tracinginsights.com/api-reference/types.md): Comprehensive guide to type definitions, schemas, and type hints in tif1
- [Utilities](https://tif1.tracinginsights.com/api-reference/utilities.md): Helper functions for configuration, logging, cache management, and data manipulation
- [Utilities API](https://tif1.tracinginsights.com/api-reference/utils.md): Comprehensive utility functions for data manipulation, time conversion, and analysis
- [Data Validation](https://tif1.tracinginsights.com/api-reference/validation.md): Comprehensive Pydantic-based validation system for F1 data integrity and quality assurance
- [Architecture](https://tif1.tracinginsights.com/architecture.md): Internal architecture, module ownership, and data flow in tif1
- [Data Backends](https://tif1.tracinginsights.com/concepts/backends.md): Understanding pandas vs polars backends in tif1
- [Caching Strategy](https://tif1.tracinginsights.com/concepts/caching-strategy.md): Deep dive into tif1's sophisticated multi-layer caching architecture for optimal performance
- [CLI Tool](https://tif1.tracinginsights.com/concepts/cli.md): Comprehensive command-line interface for tif1 - Fast F1 data access from your terminal
- [Data Flow Architecture](https://tif1.tracinginsights.com/concepts/data-flow.md): Comprehensive guide to understanding how data moves through tif1's multi-tier architecture
- [Jupyter Integration](https://tif1.tracinginsights.com/concepts/jupyter.md): Rich HTML displays for interactive F1 data analysis
- [Sessions](https://tif1.tracinginsights.com/concepts/sessions.md): Understanding F1 sessions in tif1
- [Design language](https://tif1.tracinginsights.com/design_language.md)
- [Examples](https://tif1.tracinginsights.com/examples.md): Common use cases and code examples for tif1
- [Getting Started Guide](https://tif1.tracinginsights.com/getting-started.md): Complete guide to start analyzing F1 data with tif1
- [Best Practices](https://tif1.tracinginsights.com/guides/best-practices.md): Recommended patterns and practices for using tif1 effectively
- [Common Use Cases](https://tif1.tracinginsights.com/guides/common-use-cases.md): Real-world scenarios and solutions with tif1
- [Data Visualization](https://tif1.tracinginsights.com/guides/data-visualization.md): Create compelling visualizations from F1 data
- [Error Handling](https://tif1.tracinginsights.com/guides/error-handling.md): Comprehensive guide to handling errors and exceptions in tif1
- [Installation](https://tif1.tracinginsights.com/installation.md): How to install and configure tif1
- [Introduction](https://tif1.tracinginsights.com/introduction.md): A faster alternative to fastf1 with the same bindings
- [Migration from fastf1](https://tif1.tracinginsights.com/migration-from-fastf1.md): Step-by-step guide to switching to tif1
- [Quickstart](https://tif1.tracinginsights.com/quickstart.md): Start analyzing F1 data in less than 30 seconds
- [CLI Commands](https://tif1.tracinginsights.com/reference/cli-commands.md): Complete reference for the tif1 command-line interface
- [Contributing](https://tif1.tracinginsights.com/reference/contributing.md): Guidelines for developing and contributing to tif1
- [Data Schema Reference](https://tif1.tracinginsights.com/reference/data-schema.md): Complete reference for all data columns, units, and formulas
- [Environment Variables](https://tif1.tracinginsights.com/reference/environment-variables.md): Configure tif1 behavior with environment variables
- [FAQ](https://tif1.tracinginsights.com/reference/faq.md): Frequently asked questions about tif1
- [Troubleshooting](https://tif1.tracinginsights.com/reference/troubleshooting.md): Common issues and solutions
- [Advanced Telemetry Analysis](https://tif1.tracinginsights.com/tutorials/advanced-telemetry.md): Deep dive into acceleration, position data, and racing lines
- [Annotated Speed Trace](https://tif1.tracinginsights.com/tutorials/annotated-speed-trace.md): Visualizing speed traces with corner markers and annotations
- [Data Export & Integration](https://tif1.tracinginsights.com/tutorials/data-export.md): Export tif1 data to various formats for external analysis
- [Downforce Level Analysis](https://tif1.tracinginsights.com/tutorials/downforce-levels.md): Analyze car setup through speed metrics
- [Driver Lap Times Visualization](https://tif1.tracinginsights.com/tutorials/driver-laptimes.md): Visualize driver lap times with compound color coding
- [Gear Shifts on Track](https://tif1.tracinginsights.com/tutorials/gear-shifts-on-track.md): Visualizing which gear is used at each point on the circuit
- [G-G Diagram (Acceleration Envelope)](https://tif1.tracinginsights.com/tutorials/gg-diagram.md): Visualize car performance limits with lateral and longitudinal acceleration
- [Lap Time Delta Comparison](https://tif1.tracinginsights.com/tutorials/lap-delta-comparison.md): Compare lap-by-lap performance between two drivers
- [Lap Time Heatmap](https://tif1.tracinginsights.com/tutorials/laptime-heatmap.md): Visualize race pace patterns across all drivers and laps
- [Lap Times Distribution Visualization](https://tif1.tracinginsights.com/tutorials/laptimes-distribution.md): Visualize lap time distributions across multiple drivers using violin and swarm plots
- [Multi-Driver Speed Comparison](https://tif1.tracinginsights.com/tutorials/multi-driver-speed-comparison.md): Visualize driver speed variations around the circuit with color-coded track maps
- [Position Changes During a Race](https://tif1.tracinginsights.com/tutorials/position-changes.md): Visualize how driver positions evolve throughout a race
- [Qualifying Analysis](https://tif1.tracinginsights.com/tutorials/qualifying-analysis.md): Analyzing qualifying performance and progression through Q1, Q2, Q3
- [Qualifying Results Visualization](https://tif1.tracinginsights.com/tutorials/qualifying-results.md): Create a visual overview of qualifying results with gap to pole position
- [Complete Race Analysis](https://tif1.tracinginsights.com/tutorials/race-analysis.md): End-to-end guide to analyzing a full race with tif1
- [Race Pace Analysis](https://tif1.tracinginsights.com/tutorials/race-pace-analysis.md): Learn how to compare driver performance and consistency
- [Speed Traces Comparison](https://tif1.tracinginsights.com/tutorials/speed-traces.md): Overlaying speed traces to compare fastest laps
- [Telemetry Comparison with Acceleration](https://tif1.tracinginsights.com/tutorials/telemetry-comparison.md): Compare driver performance with speed, acceleration, and driver actions
- [Full Throttle Distance Analysis](https://tif1.tracinginsights.com/tutorials/throttle-distance.md): Analyze how much of the lap drivers spend at full throttle
- [Tire Degradation Analysis](https://tif1.tracinginsights.com/tutorials/tire-degradation.md): Visualizing tire performance degradation over race distance
- [Tire Strategy Analysis](https://tif1.tracinginsights.com/tutorials/tire-strategy.md): Analyzing tire compounds, degradation, and stint lengths
- [Top Speeds by Team](https://tif1.tracinginsights.com/tutorials/top-speeds.md): Visualizing maximum speed trap data across teams
- [Track Acceleration Map](https://tif1.tracinginsights.com/tutorials/track-acceleration-map.md): Visualize acceleration forces around the circuit
- [Track Brake Zones](https://tif1.tracinginsights.com/tutorials/track-brake-zones.md): Identify braking zones around the circuit
- [Track Speed Map](https://tif1.tracinginsights.com/tutorials/track-speed-map.md): Visualize speed variations around the circuit
- [Track Temperature Analysis](https://tif1.tracinginsights.com/tutorials/track-temperature.md): Visualizing track temperature changes throughout a session
- [Track Throttle Map](https://tif1.tracinginsights.com/tutorials/track-throttle-map.md): Visualize throttle application around the circuit
- [Weather Impact Analysis](https://tif1.tracinginsights.com/tutorials/weather-impact.md): Analyzing how weather conditions affect lap times and performance

## OpenAPI Specs

- [openapi](https://tif1.tracinginsights.com/api-reference/openapi.json)