docs: explain trained localization model versions

README.md

@@ -0,0 +1,21 @@
+---
+library_name: opensportslib
+tags:
+- action-spotting
+- sports
+---
+# OSL-loc-NetVLADpp
+
+OpenSportsLib localization models. `main` is the version catalog; load an explicit experiment revision using `LocalizationModel.from_pretrained`.
+
+<!-- osl-model-versions:start -->
+## Trained model versions
+
+Select a version below to read its recipe, data, measured metrics and usage instructions. Each weight/config pair belongs to the linked experiment and seed.
+
+| Version / README | Dataset | Seed | Scope | Measured test scores | Artifacts |
+|---|---|---:|---|---|---|
+| [soccernet_netvladpp_resnet_pca512](https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/tree/soccernet_netvladpp_resnet_pca512) | SoccerNet-v2 | 1 | released-code PCA ablation | loose average-mAP: 50.4990%; tight average-mAP: 11.9517% | [weights](https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/resolve/05e1b644fb77668c2ac49daeaef01779cddeb360/model.pth) · [config](https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/resolve/05e1b644fb77668c2ac49daeaef01779cddeb360/config.yaml) |
+
+Per-seed measurements do not establish exact paper reproduction. Read each version's protocol and aggregation notes.
+<!-- osl-model-versions:end -->

model-versions.json

@@ -0,0 +1,13 @@
+{
+  "soccernet_netvladpp_resnet_pca512": {
+    "card_url": "https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/tree/soccernet_netvladpp_resnet_pca512",
+    "config_url": "https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/resolve/05e1b644fb77668c2ac49daeaef01779cddeb360/config.yaml",
+    "dataset": "SoccerNet-v2",
+    "experiment": "soccernet_netvladpp_resnet_pca512",
+    "model_url": "https://huggingface.co/OpenSportsLab/OSL-loc-NetVLADpp/resolve/05e1b644fb77668c2ac49daeaef01779cddeb360/model.pth",
+    "revision": "soccernet_netvladpp_resnet_pca512",
+    "scope": "released-code PCA ablation",
+    "scores": "loose average-mAP: 50.4990%; tight average-mAP: 11.9517%",
+    "seed": 1
+  }
+}