# Mappers et variables personnalisés (/docs/creation-seances/mappers-variables)
## Vue d'ensemble [#vue-densemble]
Un **mapper** est une **fiche de paramètres** que tu attaches à un exercice ou à une séance. Il contient un ensemble de **variables** (charge, séries, répétitions, %VMA, RPE, distance, vitesse, hauteur de saut…) que tu peux saisir, individualiser par sportif, ou faire calculer automatiquement.
Concrètement, un mapper te permet de :
* prescrire une charge en pourcentage (par exemple **80 % du 1RM**) qui devient automatiquement une **charge en kg** propre à chaque joueur,
* prescrire une vitesse en pourcentage de VMA qui devient une **vitesse en km/h** propre à chaque joueur,
* faire calculer automatiquement le **tonnage**, le **1RM estimé** (formule Epley), la **perte de vitesse VBT**, le **RSI**, etc., dès que les variables nécessaires sont saisies.
## Étapes — créer un mapper [#étapes--créer-un-mapper]
### 1. Aller sur la page Mappers [#1-aller-sur-la-page-mappers]
Depuis le menu, va sur **Création > Mappers**, puis lance la création d'un nouveau mapper.
### 2. Nommer le mapper et choisir une catégorie [#2-nommer-le-mapper-et-choisir-une-catégorie]
Donne un nom explicite (par exemple « Force max — squat ») et sélectionne (ou crée) une **catégorie** pour le ranger.
### 3. Sélectionner les variables [#3-sélectionner-les-variables]
La bibliothèque de variables est organisée en grandes catégories :
* **Volume** — séries, répétitions, charge, %1RM, tonnage, distance…
* **Intensité** — RPE, RIR, vitesse VBT, fréquence cardiaque, %VMA, watts…
* **Tempo** — phases excentrique/concentrique, isométrie, modalité de contraction, TST…
* **Récupération** — temps de récupération inter-série, temps de travail/récup en circuit, ratios…
* **Pliométrie** — hauteur de saut, temps de contact, RSI, distance/temps/vitesse de sprint…
* **Organisation** — type d'organisation (station, circuit, superset, EMOM, AMRAP…), latéralité, matériel…
* **Qualitatif** — critère technique, commentaire coach, vidéo explicative…
Tu **glisses-déposes** les variables qui t'intéressent dans la zone du mapper. Tu peux aussi en créer une nouvelle de toutes pièces avec son nom, son type (nombre, texte…) et son unité.
### 4. Vérifier les dépendances [#4-vérifier-les-dépendances]
Pour les variables calculées ou individualisées, FormaPulse t'affiche **les variables nécessaires** (« Nécessite : … »). Si toutes les dépendances sont présentes, une coche verte apparaît : **« Variables minimales présentes, calcul automatique possible »**.
### 5. Définir les séries (optionnel) [#5-définir-les-séries-optionnel]
Tu peux pré-remplir des séries types (par exemple 4×6 à 80 % du 1RM avec 2 min de récup) qui seront proposées par défaut quand le mapper sera utilisé.
### 6. Enregistrer [#6-enregistrer]
Le mapper rejoint ta bibliothèque. Tu pourras l'attacher à n'importe quel exercice ou séance.
## Variables individualisées par un test [#variables-individualisées-par-un-test]
Certaines variables prennent une **valeur en pourcentage** que FormaPulse traduit automatiquement en **valeur absolue** propre à chaque sportif, en utilisant un **test de référence** rattaché à sa fiche.
| Variable | Test de référence | Calcul automatique |
| -------------------- | --------------------------- | ---------------------------------------------- |
| **% 1RM** | 1RM (test de poids) | %1RM × 1RM du sportif → charge en kg |
| **% Poids de corps** | Anthropométrie (poids) | %PDC × poids du sportif → charge en kg |
| **% VMA** | Test VMA | %VMA × VMA du sportif → vitesse en km/h |
| **% FCmax** | Test FCmax | %FCmax × FCmax du sportif → FC cible en bpm |
| **% PeakForce** | Test de force | %PeakForce × force max du sportif → force en N |
| **% Vmax** | Test de vitesse d'exécution | %Vmax × Vmax du sportif → vitesse cible |
| **Distance** | Test VMA | %VMA × VMA × durée de travail → distance en m |
| **Hauteur de saut** | Test de hauteur de saut | Hauteur de référence du sportif (cm) |
| **Temps sprint** | Test de temps de sprint | Temps de référence du sportif |
**Comment ça marche** : tu prescris la **valeur en %** (par exemple 80 % du 1RM) au niveau de la séance ou du programme. Quand le sportif accède à sa séance, FormaPulse va chercher son **test de référence** le plus récent et calcule sa cible personnalisée.
Pour qu'une variable individualisée fonctionne, le sportif doit avoir
un **test du bon type récent** dans sa fiche. Sans ce test, le calcul
ne se fait pas et la cible reste vide. → [Variable du mapper qui ne se
calcule pas automatiquement](/docs/erreurs-frequentes/variable-mapper-non-calculee)
## Variables calculées à partir d'autres variables [#variables-calculées-à-partir-dautres-variables]
Certaines variables sont **calculées automatiquement** dès que les variables sources nécessaires sont saisies — sans intervention manuelle. Voici les principales :
| Variable | Variables nécessaires | Calcul |
| --------------------------------- | ------------------------------------------ | ---------------------------------------- |
| **1RM estimé** | Charge + Répétitions | Charge × (1 + Reps / 30) — formule Epley |
| **Tonnage** | Charge + Répétitions (× Séries si présent) | Charge × Reps × Séries |
| **Tonnage relatif** | Tonnage + 1RM estimé | Tonnage / 1RM estimé |
| **INOL** | Répétitions + %1RM | Reps / (100 − %1RM) |
| **Volume de charge (NL)** | Répétitions (× Séries si présent) | Total des répétitions effectuées |
| **TST (temps sous tension)** | Tempo (ou temps iso) + Reps + Séries | (Tempo + Temps iso) × Reps × Séries |
| **Perte de vitesse VBT** | Vitesse 1ʳᵉ rép + Vitesse dernière rép | (V1ʳᵉ − Vdernière) / V1ʳᵉ × 100 |
| **% FCmax** | Fréquence cardiaque mesurée | FC / FCmax estimée × 100 |
| **Ratio Travail:Repos** | Temps travail + Temps récup (circuit) | Temps travail / Temps récup |
| **RSI (Reactive Strength Index)** | Hauteur de saut + Temps de contact au sol | Hauteur (m) / Temps contact (s) |
**Comment ça marche** : tu ajoutes la variable calculée à ton mapper ET tu ajoutes les variables sources nécessaires. Dès que tu (ou le sportif) saisis les valeurs des variables sources, la variable calculée s'affiche automatiquement.
Si une variable source manque, le calcul reste vide. C'est volontaire pour ne pas afficher de valeur tronquée.
Certaines variables calculées acceptent des **dépendances alternatives**
(par exemple Reps OU Reps/côté OU Reps droite + Reps gauche). FormaPulse
prend la première combinaison disponible.
## Exemples concrets [#exemples-concrets]
### Exemple terrain — % VMA pour un intermittent [#exemple-terrain---vma-pour-un-intermittent]
Tu crées un mapper « Intermittent VMA » avec **% VMA**, **durée de travail**, **récupération** et **séries**. Tu prescris 105 % de VMA pendant 15 s avec 15 s de récup, 4 séries de 6 répétitions. Chaque joueur reçoit dans son app sa **vitesse cible en km/h** (ex: Joueur A à 16,8 km/h, Joueur B à 15,7 km/h selon leur VMA respective).
### Exemple musculation — % 1RM pour un squat [#exemple-musculation---1rm-pour-un-squat]
Tu crées un mapper « Force max squat » avec **% 1RM**, **séries**, **répétitions**, **récupération**, **RPE**. Tu prescris 4×6 à 80 % du 1RM. Chaque joueur reçoit dans son app sa **charge en kg** calculée à partir de son 1RM (ex: 100 kg pour un 1RM à 125 kg). FormaPulse calcule aussi automatiquement le **tonnage** post-séance.
### Exemple pliométrie — RSI calculé [#exemple-pliométrie--rsi-calculé]
Tu crées un mapper « Drop jump » avec **hauteur de saut** et **temps de contact au sol**. Le sportif (ou le coach) saisit les deux mesures. FormaPulse calcule automatiquement le **RSI** (Reactive Strength Index) sans intervention.
## Erreurs à éviter [#erreurs-à-éviter]
* **Trop de variables** : un mapper de 15 variables est illisible. Reste sur les 4-6 paramètres clés pour ton objectif.
* **Variable individualisée sans test sur la fiche du sportif** : le calcul ne se fait pas. Vérifie que les sportifs ont un test du bon type avant de lancer la séance.
* **Variables calculées sans leurs dépendances** : si tu ajoutes « Tonnage » mais pas « Charge » dans ton mapper, le tonnage ne pourra jamais se calculer.
* **Mélanger les unités** : un test de VMA en km/h et une variable cible en m/s ne s'alimentent pas correctement. Reste cohérent.
## Aller plus loin [#aller-plus-loin]