data/bronze/.
Usage
usage: ingest.py [-h] (--start-season YEAR | -s YEAR) [--end-season YEAR] [--round N] [--session {R,Q,both}] [--skip-telemetry] [--telemetry-full] [--force] [--dry-run] [--log-level LOG_LEVEL]
Options
-h, --help show this help message and exit
--start-season YEAR First season to ingest (use with --end-season)
-s, --season YEAR Single season shorthand (equivalent to --start-season
N --end-season N)
--end-season YEAR Last season to ingest (inclusive). Required with
--start-season.
--round N Ingest only this round number (requires a single
season via -s/--season)
--session {R,Q,both} Which session types to ingest (default: both)
--skip-telemetry Skip telemetry extraction (faster dry-runs and
qualifying-only runs)
--telemetry-full Ingest full-channel car_data (Speed, Throttle, Brake,
nGear, RPM, DRS) and pos_data (v0.2)
--force Overwrite existing Parquet files instead of skipping
them
--dry-run Show what would be fetched without pulling data
--log-level LOG_LEVEL
Logging level: DEBUG, INFO, WARNING, ERROR (default:
INFO)
Examples
python ingest.py --season 2024 --round 1 --session R
Ingest a single race (2024 Rd1, Bahrain)
python ingest.py --season 2024 --session R
Ingest 2024 races only
python ingest.py --season 2024 --session both
Ingest 2024 races and qualifying
python ingest.py --start-season 2018 --end-season 2024 --session both
Full historical backfill (4–6 hours)
python ingest.py --season 2024 --force
Re-ingest 2024, overwriting existing files
python ingest.py --season 2024 --skip-telemetry --dry-run
Dry-run without pulling telemetry