Module:Diagramme/Documentation

Ce module exporte deux fonctions :

• bar chart : l'histogramme (graphique en colonne)
• pie chart : le diagramme en secteurs (camembert)

Histogramme

Le module est appelé par le code {{#invoke:Diagramme|bar chart|…|…|…}}

Paramètres

Paramètre	Résultat
delimiter	Délimite plusieurs valeurs lorsqu'il est spécifié en utilisant par défaut le symbole à deux points (:). En principe vous n'avez pas à toucher à ce paramètre
width	Largeur : si ce paramètre est renseigné, la valeur indiquée doit être au minimum de 200. (La valeur par défaut est de 500.)
height	Hauteur : si ce paramètre est renseigné, la valeur minimale est de 200. (La valeur par défaut est de 350.)
group n	« n » étant un nombre, écrivez group 1, group 2, etc. en fonction de groupes de colonnes présents dans le graphique ; les valeurs devant être renseignées, voir l'exemple illustré.
tooltip n	Info-bulle associée à une colonne spécifique. Si aucune info-bulle n'est définie spécifiquement pour une colonne, et que cette dernière a un lien, alors ce lien sera utilisée comme info-bulle. Sinon, l'info-bulle sera combiné à partir du nom du groupe et la valeur, éventuellement avec "unités préfixe" et "unités suffixe" ..
links n	Les liens vers les articles associés à chaque colonne.
stack	Empilement au sein d'une même colonne. Le seul fait de mentionner ce paramètre signifie « oui » (même en laissant la valeur en blanc). Pour dire « non », il suffit de l'omettre.
tooltip value accumulation	Fonctionne uniquement avec le paramètre stack, destinée à faire afficher dans l'info-bulle la valeur cumulée de tous les blocs (non testé).
colors	Couleurs désignant les différents groupes ; il devrait y avoir en avoir autant que le nombre de groupes. Utilisez les noms de couleurs html ou les notations #xxx ou #xxxxxx.
x legends	Les légendes pour chaque groupe de colonne ; la syntaxe wiki peut être employée pour insérer un lien interne.
hide group legends	Les légendes du groupe ne seront pas affichés en dessous du tableau. Toute valeur signifie « oui ». Pour dire « non », il suffit de ne pas spécifier ce paramètre, ou laisser la valeur à blanc.
scale per group	Configure une échelle Y distincte pour chaque groupe. Incompatible avec stack. Même si certaines de ces échelles sont identiques, elles seront tirées au sort séparément lorsque ce paramètre est activé. Toute valeur non-vide signifie « oui ». Pour dire « non », il suffit de ne spécifiez pas ce paramètre, ou laisser la valeur à blanc.
units prefix	Préfixe qui apparaîtrait dans l'info-bulle. Par exemple, si vous ajoutiez le symbole $, si les valeurs s'afficheraient sous la forme « $500 » au lieu de « 500 » dans l'info-bulle
units suffix	Suffixe : idem. Si vous utilisez € l'info-bulle affichera par exemple 88€ au lieu de 88. Utiliser _€ affichera 88 € (le tiret bas est remplacé par un espace dans l'info-bulle).
group names	Les légendes affectées aux différents groupes de colonnes.

Modules externes et autres éléments dont ce module a besoin pour fonctionner :

• Module:Plotter/DefaultColors – .

Exemple basique

{{ #invoke:Diagramme | bar chart
| group 1 = 40 : 50 : 60 : 20
| group 2 = 20 : 60 : 12 : 44
| group 3 = 55 : 14 : 33 : 5
| links 1 = Pomme : McIntosh (pomme) : Golden delicious
| links 2 = Banane : Abricot : Pêche (fruit)
| links 3 = Orange : Poire : Raisin
| tooltip 2 = tooltip 1 : tooltip 2 : tooltip 3 : tooltip 4
| colors = green : yellow : orange
| group names = Pomme: Banane : Orange
| x legends = Avant : Pendant : Après : Post mortem
}}

Exemple avec empilement (paramètre stack)

Le même graphique, avec une taille plus petite, utilisant les paramètres height, width, stack, units suffix.

{{ #invoke:Diagramme | bar chart
| height = 250
| width = 300
| stack = 1
| group 1 = 40 : 50 : 60 : 20
| group 2 = 20 : 60 : 12 : 44
| group 3 = 55 : 14 : 33 : 5
| colors = green : yellow : orange
| group names = Apple : Banana : Orange
| units suffix = kg
| x legends = Before : During : After : Post mortem
}}

Exemple avec une échelle différente par groupe

Il est possible d'afficher une échelle et des unités différentes pour chaque groupe :

{{ #invoke:Diagramme | bar chart
| width = 800
| group 1 = 1500000 : 2500000 : 3500000
| group 2 = 200 : 5000 : 45000
| group 3 = 2000 : 5000 : 20000
| colors = red : blue : green
| group names = Population : Auto : Coût moyen
| x legends = 1920 : 1965 : 2002
| tooltip 2 = : Il n'y a pas de donnée fiable pour le nombre de voiture en 1965. Nous avons pris 5000 comme étant la meilleure estimation.
| units suffix =::_€
| scale per group = 1
}}

Regardez le paramètre "unit suffix" : nous n'avons pas besoin du préfixe pour les 2 premiers groupes, nous utilisons donc des colonnes sans contenu.

Prenez connaissance aussi de l'info-bulle spéciale pour "Auto"

Exemple avec un grand nombre de légendes

Principalement pour tester l'affichage avec un grand nombre de groupes.

Exemple divers

{{ #invoke:Diagramme | bar chart
| group 1 = 1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23:24:25:26:27:28:29:30
:31:32:33:34:35:36:37:38:39:40:41:42:43:44:45:46:47:48:49:50:51:52:53:54:55:56:57:58:59
| units suffix = _Things
| group names = Some
| x legends = ::::1940::::::::::1950::::::::::1960::::::::::1970::::::::::1980::::::::::1990::::
}}

Diagramme circulaire

Le module est appelé par le code {{#invoke:Diagramme|pie chart|…|…|…}}

Paramètres

Paramètres	Résultat
delimiter	Idem tableau précédent
radius	Rayon : le nombre exprimant le nombre de pixels
slices	Secteurs (ou tranches) : utilisez le paramètre delimiter à l'intérieur des parenthèses (Table Uplet (Tuple)) = ( Value1 : Name1 : Color1 : Link1 ) ( Value2 : Name2 : Color2 : Link2 ) ... Les valeurs sont des nombres qui peuvent être entiers ou des fractions décimales, ou utilisant la notation scientifique : 7.24e6, 7,240,000, ou 7240000.00 sont toutes acceptables pour 7 millions et 240 mille. Les couleurs sont optionnelles. Vous pouvez utiliser les couleurs du web, comme "red" ou "#FF0000". Jusqu'à 26 couleurs sont définies, mais si votre diagramme comporte plus de 26 secteurs, vous devez définir les couleurs à partir du 27e et plus. Les liens peuvent être externes ou internes, y compris des liens ancrés à des sections présentes dans l'article lui-même.
slice n	Syntaxe alternative à slices. n est le numéro de la tranche, en commençant par 1. Veillez à ne pas sauter de numéro : si vous définissez slice 1, slice 2, slice 4, slice 5 ..., en sautant slice 3, seuls les deux premiers tranches seront affichés. La syntaxe est incompatible avec slices, c'est à dire qu'ils ne doivent pas être utilisés en association dans le même appel. Les deux codes slices et slice n dans le même appel entraînerait des résultats imprévisibles. La valeur est comme un « tuple », comme expliqué ci-dessus, mais sans les parenthèses: | slice 1 = Value1 : Name1 : Color1 : Link1 | slice 2 = Value2 : Name2 : Color2 : Link2 | ... L'intérêt de cette syntaxe alternative est de vous permettre d'utiliser des parenthèses dans les noms, des liens et des couleurs.
percent	Si utilisé, le pourcentage de chaque tranche sera calculé et ajouté à la légende: si vous avez deux tranches, comme suit: ( 1: younglings ) ( 3 : Elders ), et utilisez percent, les légendes deviendront "younglings: 1 (25%) »et« aînés: 3 (75%)", au lieu de simplement "Younglings: 1" and " elders: 3". Toute valeur non-vide signifie « oui ». Pour dire « non », il suffit de ne pas spécifier ce paramètre à tout, ou laisser la valeur à blanc.
units prefix	Idem tableau précédent
units suffix	Idem tableau précédent
hide group legends	Idem tableau précédent

Exemple avec paramètre « slices »

{{#invoke:Diagramme|pie chart
| radius = 150
| slices = 
    ( 1000000 : Pommes) 
    ( 2000000 : Bananes  : gold) 
    ( 1440000 : Abricots ) 
    ( 6.4e5 : Pêches : : [[Pêche (fruit)|Pêches]] )
    ( 750,000 : Ananas)
| units suffix = _Tonne
| percent = true
}}

Notez que nous pouvons laisser la couleur vide pour utiliser la valeur par défaut, mais pour ajouter le lien « pêche », nous avons du ajouter un séparateur supplémentaire pour marquer le paramètre de couleur omis. Notez également que les valeurs peuvent être fournis avec le format « langage spécifique » (comme 1,000), ou la notation scientifique comme 6.4e5. Dans les légendes, les numéros seront toujours affichés normalement (peut être différent si le module importé dans d'autres wikis).

Exemple avec paramètre « slice n »

Un example avec la syntaxe alternative avec "slice 1", "slice 2" etc.

{{#invoke:Diagramme|pie chart
|radius= 200
|units suffix = _Units
| slice 1 = 1 : 1
| slice 2 = 7 : 7
| slice 3 = 8 : 8
| slice 4 = 9 : 9
| slice 5 = 10 : 10
| slice 6 = 11 : 11
| slice 7  = 12 : 12
| slice 8  = 13 : 13
| slice 9  = 14 : 14
| slice 10 = 15 : 15
| slice 11 = 16 : 16
| slice 12 = 17 : 17
| slice 13 = 18 : 18
| slice 14 = 19 : 19
| slice 15 = 20 : 20
| slice 16 = 21 : 21
| slice 17 = 22 : 22
| slice 18 = 23 : 23
| slice 19 = 24 : 24
| slice 20 = 25 : 25
| slice 21 = 26 : 26
| slice 22 = 27 : 27
| slice 23 = 28 : 28
| slice 24 = 29 : 29
| slice 25 = 30 : 30
| slice 26 = 31 : 31
| percent = true
}}