Modèle:Graphique polygonal/Documentation

Utilisation

Ce modèle permet de créer des graphiques en ligne polygonaux à partir de données chiffrées passées en paramètres.

À l'heure actuelle, ce modèle permet de créer des graphes avec les limitations suivantes:

Nombre maximal de séries de données : 10
Nombre maximal de valeurs en abscisse : 35

Ce modèle se base sur l'extension EasyTimeline.

Ce modèle permet aussi d'obtenir le code Timeline généré, au moyen du paramètre mode=code (à utiliser en prévisualisation).

Syntaxe

L'ordre des paramètres n'ayant pas d'importance, il est obligatoire d'indiquer le nom des paramètres à l'appel du modèle.

{{Graphique polygonal
 | marge_h                = 
 | marge_b                = 
 | marge_d                = 
 | marge_g                = 
 | largeur                = 
 | hauteur                = 
 | nb_abscisses           = 
 | y_max                  = 
 | nb_series              = 
 | coul_fond              = 
 | grille                 = 
 | coul_grille_principale = 
 | coul_grille_secondaire = 
 | pas_grille_principale  = 
 | pas_grille_secondaire  = 
 | points                 = 
 | coul_serie_1           = 
 | ...
 | coul_serie_10          = 
 | lb_x1                  = 
 | ...
 | lb_x35                 = 
 | S01V01                 = 
 | ...
 | S01V35                 = 
 | S02V01                 = 
 | ...
 | S02V35                 = 
 | ...
 | S10V01                 = 
 | ...
 | S10V35                 = 
 | mode                   =<!-- optionnel (mode=code pour afficher le code Timeline généré) -->
}}

Paramètres

Les paramètres peuvent êtres regroupés en plusieurs catégories:

Les paramètres de mise en forme (taille de l'image, marges de tracé...)
Les paramètres de formes et couleurs (épaisseur des trais de tracé, couleurs des grilles, du fond de l'image, des tracés...)
Les paramètres des séries de données (valeurs de données par série)
Les paramètres des axes (valeur maximale de l'ordonnée, nombre d'abscisses, libellés des abscisses, ...)

Paramètres de mise en forme

Tous ces paramètres sont optionnels:

largeur : largeur en pixels de l'image de rendu (500 par défaut)
hauteur : hauteur en pixels de l'image de rendu (350 par défaut).
marge_h : marge en pixels entre le haut de l'image et le haut de la zone de tracé (10 par défaut)
marge_b : marge en pixels entre le bas de l'image et le bas de la zone de tracé (20 par défaut)
marge_d : marge en pixels entre la droite de l'image et la droite de la zone de tracé (10 par défaut)
marge_g : marge en pixels entre la gauche de l'image et la gauche de la zone de tracé (30 par défaut)

Paramètres de formes et couleurs

Tous ces paramètres sont optionnels:

coul_fond : couleur de fond de l'image générée (blanc par défaut).
coul_grille_principale : couleur des graduations principales de la grille d'ordonnées (gris foncé par défaut).
coul_grille_secondaire : couleur des graduations secondaire de la grille d'ordonnées (gris clair par défaut).
coul_serie_1 à coul_serie_10 : couleur de chaque tracé de série de données
epaisseur_serie1 à epaisseur_serie10 : épaisseur du tracé de chaque série, de 0.1 (très fin) à 10 (très épais). Valeur par défaut : 0.8

L'intégralité des codes couleurs correspondant à EasyTimeline et utilisables dans le modèle sont disponibles sur l'aide de l'extension EasyTimeline.

Paramètres de séries de données

SaaVxx : Valeur xx (de 01 à 35) de la série aa (de 01 à 10). La valeur qui suit est comprise entre 0 et le paramètre y_max (voir ci-dessous).
- Exemple : S05V01 = 25 signifie : « La première valeur (d'abscisse 01) de la cinquième série (05) vaut 25 ».
points : Indique si des points symbolisant l'abscisse des données doivent être ajoutés à la courbe. points = oui signifie que l'on ajoute des points pour toute série de données. Toute autre valeur du paramètre ne sera pas prise en compte.

Paramètres des axes

pas_grille_principale : pas de chaque subdivision principale de l'ordonnée. Obligatoire.
pas_grille_secondaire : pas de chaque subdivision secondaire de l'ordonnée (si la paramètre grille est paramétré à oui.
nb_abscisses : nombre de valeurs en abscisses. Obligatoire.
lb_x1 à lb_x35 : les étiquettes (libellés) des valeurs de l'axe des abscisses. Il doit y en avoir le même nombre que paramétré dans nb_abscisses. Valeur par défaut : nombre de 1 à 35.
y_max : Valeur maximale de l'ordonnée (axe y). Obligatoire.
y_min : Valeur minimale de l'ordonnée (axe y). facultatif, par défaut 0.

Paramètres mode

Le paramètre optionel mode=code permet d'afficher le code Timeline généré, à utiliser en mode prévisualisation. Cela peut être utile soit pour du débug, soit si on souhaite copier-coller le code Timeline directement dans l'article, éventuellement en y apportant des modifications manuelles.

Exemple

Codes source

Rendu

{{Graphique polygonal
| coul_fond = white
| largeur = 500
| hauteur = 350
| marge_g = 40
| marge_d = 15
| marge_h = 10
| marge_b = 20
| nb_series = 3
| nb_abscisses = 10 
| lb_x1 = Val. 1 | lb_x2 = Val. 2 | lb_x3 = Val. 3 | lb_x4 = Val. 4 | lb_x5 = Val. 5
| lb_x6 = Val. 6 | lb_x7 = Val. 7 | lb_x8 = Val. 8 | lb_x9 = Val. 9 | lb_x10 = Val. 10
| y_max = 3000
| y_min = 1000
| grille = oui
| pas_grille_principale = 1000
| pas_grille_secondaire = 100
| S01V02 = 2200 | S01V03 = 2400 | S01V04 = 2500 | S01V05 = 2600 | S01V06 = 2500
| S02V01 = 1400 | S02V02 = 2000 | S02V03 = 1600 | S02V04 = 1800 | S02V05 = 2400 
| S02V06 = 2400 | S02V07 = 2500 | S02V08 = 2000 | S02V09 = 1600 | S02V10 = 1800
| S03V01 = 1800 | S03V04 = 2000 | S03V05 = 1600 | S03V06 = 1800 | S03V07 = 2400 
| S03V09 = 2400
| points = oui
}}

Limitations

Il est impossible d'utiliser le mot magique formatnum pour mettre en forme les valeurs d'abscisses.
Pas d'alternative textuelle pour l'accessibilité du contenu.

Ajout du 25/02/2012

Il est désormais possible de « sauter » des valeurs en abscisses. Exemple: Renseigner la valeur S01V01 et S01V03, sans la valeur S01V02 tracera un segment entre l'abscisse 1 et l'abscisse 3 à leurs valeurs respectives.

Ajout du 06/03/2012

Il est désormais possible d'intégrer des points symbolisant la position des données de série sur chaque polygone, en utilisant le paramètre points = oui .

Ajout du 17/01/2013

Il est désormais possible de définir la valeur minimum de l'axe de ordonnées : y_min

Ajout du 08/02/2014

Il est désormais possible d'obtenir le code Timeline avec le paramètre mode=code.

Ajout du 31/03/2016

Passage de la limite de 25 à 35.

Variante

Sous-modèles

Voir aussi

EasyTimeline