# Modélisation GPS athlètes (/docs/pro-analytics/modelisation-gps-athletes)



## Vue d'ensemble [#vue-densemble]

La page **Modélisation GPS athlètes** affiche les normes GPS calculées sur tes données réelles. Tu peux les consulter **par joueur**, ou agrégées **par poste** ou **par tag**, et les filtrer par type d'événement (séance / match) et par croisements configurés.

Page accessible via le menu **pro-analytics > Modélisation GPS > Modélisation GPS athlètes**.

<VideoAVenir titre="Pro-analytics — Modélisation GPS athlètes" />

## Prérequis [#prérequis]

* **Configuration GPS*&#x2A; active dans tes préférences. Sinon, la page affiche un écran &#x2A;« Paramétrez une clé GPS »* avec un bouton **Configurer GPS** vers `/profil/preferences`.
* **Configuration des normes** (croisements actifs, période, durée minimale de match) — réglable via l'icône engrenage en bas de la sidebar.

## Sidebar [#sidebar]

### Croisement [#croisement]

Sélecteur en haut de la sidebar avec deux types d'options :

* **Personnalisé** — tu construis librement le filtre.
* Les **croisements actifs** définis dans la configuration des normes (ex : `Type évent × Poste`, `Poste`, `Tag`, `Poste × Tag`…).

Choisir un croisement applique automatiquement les filtres correspondants.

### Par joueur [#par-joueur]

Section dépliée par défaut. Permet de sélectionner :

* Des **équipes** (sélectionner une équipe coche tous ses joueurs ; la décocher les décoche tous).
* Des **joueurs** individuels.

Le badge à droite du titre affiche le total &#x2A;(joueurs + équipes)* sélectionnés. Les joueurs hors des postes sélectionnés sont désactivés.

### Par poste [#par-poste]

Section repliée par défaut. Liste des postes du club.

* **Toggle « Agréger par poste »** — quand actif :
  * désactive la sélection manuelle de postes,
  * sélectionne tous les joueurs,
  * bascule l'affichage : **une ligne par poste** au lieu d'une par joueur.

Si le croisement par poste n'est pas activé dans la configuration, un message d'indisponibilité apparaît.

### Par tags [#par-tags]

Section repliée par défaut.

* En mode normal : sélection **exclusive** (un seul tag).
* Avec le &#x2A;*toggle « Agréger par tag »** activé : sélection **multiple**, tous les tags sont cochés par défaut, et l'affichage devient **une ligne par tag**.

Comme pour les postes, le croisement *Tag* (ou *Poste × Tag*) doit être activé dans la configuration pour être disponible.

### Par type d'événement [#par-type-dévénement]

Section repliée par défaut. Trois boutons (sélection unique) :

* **Tous**
* **Séance*&#x2A; &#x2A;(défaut)*
* **Match**

### Footer [#footer]

* **Mettre à jour les normes*&#x2A; — déclenche le recalcul. Un message de confirmation &#x2A;« Normes GPS mises à jour avec succès »* s'affiche en fin de calcul.
* **Configuration** (icône engrenage) — ouvre une fenêtre latérale avec les réglages : *durée minimale de match*, *période en jours*, *croisements actifs*.

## Tableau des normes [#tableau-des-normes]

Le tableau central s'adapte au mode actif.

### Sélecteur Référencentiel [#sélecteur-référencentiel]

Au-dessus du tableau, le select **Référencentiel** définit la méthode de calcul affichée :

| Méthode        | Description                           |
| -------------- | ------------------------------------- |
| **Moyenne**    | Moyenne arithmétique                  |
| **Max**        | Valeur maximale                       |
| **Top3 Avg**   | Moyenne des 3 valeurs les plus hautes |
| **P25**        | Percentile 25                         |
| **P50**        | Percentile 50 (médiane)               |
| **P75**        | Percentile 75                         |
| **P90**        | Percentile 90                         |
| **Ecart Type** | Écart-type                            |

Changer le référentiel recharge les valeurs du tableau en temps réel.

### Colonnes [#colonnes]

1. **Checkbox** — sélection multiple des lignes.
2. **Joueur / Poste / Tag** selon le mode :
   * Par joueur : avatar (initiales `prenom[0] + nom[0]&#x60;), nom complet, sous-texte &#x2A;« N échantillons »*.
   * Agrégé par poste : avatar à 2 lettres, nom du poste, sous-texte &#x2A;« X joueurs · Y échantillons »*.
   * Agrégé par tag : avatar coloré (couleur du tag), libellé du tag, sous-texte &#x2A;« X joueurs · Y échantillons »*.
3. **Une colonne par métrique GPS*&#x2A; — libellé &#x2A;« Nom métrique (unité) »*, valeurs formatées à une décimale, en police mono. Cellule grisée si valeur nulle.

### Histogramme [#histogramme]

Un graphique en barres horizontales affiche les valeurs de la métrique sélectionnée pour la méthode choisie. Le sélecteur de métrique se trouve au-dessus du graphique. L'ordre et la visibilité des barres sont configurables.

## Calcul des normes [#calcul-des-normes]

Le recalcul peut prendre plusieurs minutes selon la taille de l'effectif et la période. Un suivi de progression apparaît en haut de l'écran ; tu peux continuer à naviguer pendant ce temps. Une fois terminé, le tableau est rafraîchi avec les nouvelles valeurs.

## Limites et bonnes pratiques [#limites-et-bonnes-pratiques]

* Les normes ne sont pertinentes qu'avec un volume d'échantillons suffisant — surveille la colonne &#x2A;« N échantillons »*.
* L'agrégation **par poste** et **par tag** est exclusive (les deux toggles ne s'activent pas en même temps).
* Pour modéliser à l'**exercice près**, utilise la page jumelle [Modélisation GPS exercices](/docs/pro-analytics/modelisation-gps-exercices).

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Modélisation GPS exercices" href="/docs/pro-analytics/modelisation-gps-exercices" />

  <Card title="Pro Longitudinal" href="/docs/pro-analytics/pro-longitudinal" />

  <Card title="Vue d'ensemble Pro Analytics" href="/docs/pro-analytics/vue-densemble" />
</Cards>

<SignalerBug sujet="Pro Analytics — Modélisation GPS athlètes" contexte="/docs/pro-analytics/modelisation-gps-athletes" />
