@byrde/f1-feature-extractor
v1.1.0
Published
Extract per-driver KPIs from F1 free practice sessions and produce multi-resolution reports
Readme
F1 Feature Extractor
Extract per-driver KPIs from F1 free practice sessions via the OpenF1 API and produce a report at multiple resolutions (per-session and aggregated weekend view).
Usage
npx @byrde/f1-feature-extractor [options]| Option | Description |
|---|---|
| -m, --meeting <name> | Meeting name to search (e.g. bahrain, monza). Omit to use the latest race weekend. |
| -y, --year <number> | Season year (e.g. 2024). Defaults to the current year. |
| -o, --output <format> | Output format: sheets, csv, or json. Defaults to sheets. |
| -p, --project <id> | Google Cloud project ID (required for sheets output). |
| -d, --drive-path <path> | Google Drive folder path for the report (e.g. F1/Reports/2024). Missing folders are created automatically. Omit to place the spreadsheet in your Drive root. |
| --login | Force re-authentication with Google. |
Output formats
- sheets — writes directly to a Google Sheets spreadsheet (default).
- csv — writes one CSV file per session plus a combined weekend file to
./out/. - json — prints the full feature payload to stdout.
