Add README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Football Elite Classifier — AutoML (AutoGluon Tabular)
|
| 2 |
+
|
| 3 |
+
**Task:** Binary classification — predict `Elite` (0/1) from tabular receiver stats.
|
| 4 |
+
|
| 5 |
+
## Dataset
|
| 6 |
+
- **Source:** <classmate name + HF dataset link if public>
|
| 7 |
+
- **Split:** Stratified Train/Test = 80/20 on the **original** split.
|
| 8 |
+
- **Features:** ['Tgt', 'Rec', 'Yds', 'YBC_per_R', 'YAC_per_R', 'ADOT', 'Drop_pct', 'Rat']
|
| 9 |
+
- **Target:** `Elite` (0/1)
|
| 10 |
+
- **Preprocessing:** Identifier columns dropped (e.g., Player). Numeric coercion; rows with NA removed.
|
| 11 |
+
|
| 12 |
+
## Training (AutoML)
|
| 13 |
+
- **Framework:** AutoGluon Tabular
|
| 14 |
+
- **Preset:** `best_quality`
|
| 15 |
+
- **Time budget:** 300s
|
| 16 |
+
- **Seed:** 42
|
| 17 |
+
- **Eval metric:** F1 (binary)
|
| 18 |
+
- **Notes:** AutoGluon performs model selection, ensembling, and stacking automatically.
|
| 19 |
+
|
| 20 |
+
## Results (Held-out Test)
|
| 21 |
+
```json
|
| 22 |
+
{
|
| 23 |
+
"accuracy": 0.8333333333333334,
|
| 24 |
+
"f1": 0.8
|
| 25 |
+
}
|
| 26 |
+
|
| 27 |
+
## Limitations & Ethics
|
| 28 |
+
- Correlations do not imply causation; labels may reflect selection bias.
|
| 29 |
+
- Out-of-distribution players/contexts may reduce performance.
|
| 30 |
+
- Intended for coursework, not for real personnel decisions.
|
| 31 |
+
|
| 32 |
+
## License
|
| 33 |
+
- Code & weights: <MIT/Apache-2.0 or course-required license>
|
| 34 |
+
|
| 35 |
+
## Acknowledgments
|
| 36 |
+
AutoML with [AutoGluon Tabular].
|
| 37 |
+
Trained in Google Colab.
|
| 38 |
+
GenAI tools assisted with boilerplate and doc structure.
|
| 39 |
+
James Kramers hugging face dataset
|