Modèle:Graphique polygonal

Documentation du modèle

Utilisation

modifier

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

modifier

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

modifier

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

modifier

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

modifier

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

modifier
  • 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

modifier
  • 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

modifier

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

modifier
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

modifier
  • 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

modifier
  • 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

modifier
  • 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

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

Ajout du 08/02/2014

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

Ajout du 31/03/2016

modifier
  • Passage de la limite de 25 à 35.

Variante

modifier

Sous-modèles

modifier

Voir aussi

modifier