Module:Diagramme/Documentation

Une page de Wikipédia, l'encyclopédie libre.

Ce module exporte deux fonctions :

  • histogramme : un diagramme en colonnes (bar chart)
  • camembert : un diagramme en secteurs, circulaire (pie chart)

Histogramme[modifier le code]

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

Paramètres[modifier le code]

Paramètre Résultat
séparateur 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
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.)
hauteur Si ce paramètre est renseigné, la valeur minimale est de 200. (La valeur par défaut est de 350.)
groupe n « n » étant un nombre, écrivez groupe 1, groupe 2, etc. en fonction de groupes de colonnes présents dans le graphique ; les valeurs devant être renseignées, voir l'exemple illustré.
infobulle 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" ..
liens n Les liens vers les articles associés à chaque colonne.
empilement 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.
valeur cumulée Fonctionne uniquement avec le paramètre empilement, destinée à faire afficher dans l'info-bulle la valeur cumulée de tous les blocs (non testé).
couleurs 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.
légendes Les légendes pour chaque groupe de colonne ; la syntaxe wiki peut être employée pour insérer un lien interne.
légendes cachées 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.
échelle par groupe Configure une échelle Y distincte pour chaque groupe. Incompatible avec empilement. 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.
préfixe 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
unité Suffixe qui apparaîtrait dans l'info-bulle. 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).
noms Les légendes affectées aux différents groupes de colonnes.


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

Table des couleurs[modifier le code]

Exemple basique[modifier le code]

{{ #invoke:Diagramme | histogramme
| groupe 1 = 40 : 50 : 60 : 20
| groupe 2 = 20 : 60 : 12 : 44
| groupe 3 = 55 : 14 : 33 : 5
| liens 1 = Pomme : McIntosh (pomme) : Golden delicious
| liens 2 = Banane : Abricot : Pêche (fruit)
| liens 3 = Orange : Poire : Raisin
| infobulle 2 = infobulle 1 : infobulle 2 : infobulle 3 : infobulle 4
| couleurs = green : yellow : orange
| noms = Pomme: Banane : Orange
| légendes = Avant : Pendant : Après : Post mortem
}}
Transparent.png
Transparent.png
Transparent.png
infobulle 1
infobulle 2
infobulle 3
Transparent.png
Transparent.png
Transparent.png
10
20
30
40
50
60
70
Avant
Pendant
Après
Post mortem
  •   Pomme
  •   Banane
  •   Orange

Exemple avec empilement[modifier le code]

Le même graphique, avec une taille plus petite, utilisant les paramètres hauteur, largeur, empilement, unité.

{{ #invoke:Diagramme | histogramme
| hauteur = 250
| largeur = 300
| empilement = 1
| groupe 1 = 40 : 50 : 60 : 20
| groupe 2 = 20 : 60 : 12 : 44
| groupe 3 = 55 : 14 : 33 : 5
| couleurs = green : yellow : orange
| noms = Pomme : Banane : Orange
| unité = kg
| légendes = Avant : Pendant : Après : Post mortem
}}
25
50
75
100
125
150
Avant
Pendant
Après
Post mortem
  •   Pomme
  •   Banane
  •   Orange

Exemple avec une échelle différente par groupe[modifier le code]

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

{{ #invoke:Diagramme | histogramme
| largeur = 800
| groupe 1 = 1500000 : 2500000 : 3500000
| groupe 2 = 200 : 5000 : 45000
| groupe 3 = 2000 : 5000 : 20000
| couleurs = red : blue : green
| noms = Population : Auto : Coût moyen
| légendes = 1920 : 1965 : 2002
| infobulle 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.
| unité =::_€
| échelle par groupe = 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"


1 000 000
2 000 000
3 000 000
4 000 000
10 000
20 000
30 000
40 000
50 000
5 000
10 000
15 000
20 000
25 000
30 000
1920
1965
2002
  •   Population
  •   Auto
  •   Coût moyen

Exemple avec un grand nombre de légendes[modifier le code]

{{ #invoke:Diagramme | histogramme
| largeur = 800
| hauteur = 550
| groupe 1 = 1:2:3:4:5:4:3:2:1
| groupe 2 = 1:2:3:4:5:4:3:2:1
| groupe 3 = 1:2:3:4:5:4:3:2:1
| groupe 4 = 1:2:3:4:5:4:3:2:1
| groupe 5 = 1:2:3:4:5:4:3:2:1
| groupe 6 = 1:2:3:4:5:4:3:2:1
| groupe 7 = 1:2:3:4:5:4:3:2:1
| groupe 8 = 1:2:3:4:5:4:3:2:1
| groupe 9 = 1:2:3:4:5:4:3:2:1
| groupe 10 = 1:2:3:4:5:4:3:2:1
| groupe 11 = 1:2:3:4:5:4:3:2:1
| groupe 12 = 1:2:3:4:5:4:3:2:1
| groupe 13 = 1:2:3:4:5:4:3:2:1
| groupe 14 = 1:2:3:4:5:4:3:2:1
| groupe 15 = 1:2:3:4:5:4:3:2:1
| groupe 16 = 1:2:3:4:5:4:3:2:1
| groupe 17 = 1:2:3:4:5:4:3:2:1
| groupe 18 = 1:2:3:4:5:4:3:2:1
| groupe 19 = 1:2:3:4:5:4:3:2:1
| groupe 20 = 1:2:3:4:5:4:3:2:1
| groupe 21 = 1:2:3:4:5:4:3:2:1
| couleurs = Silver:Gray:Black:Red:Maroon:Yellow:Olive:Lime:Green:Aqua:Teal:Blue:Navy:Fuchsia:Purple:ForestGreen:Tomato:LightSeaGreen:RosyBrown:DarkOliveGreen:MediumVioletRed
| noms = Alabama:Alaska:Arizona:Arkansas:California:Colorado:Connecticut:Delaware:Florida:Georgia:	Hawaii:Idaho:Illinois:Indiana:Iowa:Kansas:Kentucky:Louisiana:Maine:Maryland:Massachusetts
| légendes = 1920 : 1930 : 1940: 1950 : 1960 : 1970 : 1990 : 2000 : 2010
| préfixe = $
| unité = _Billion
| empilement = 1
}}


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


25
50
75
100
125
150
1920
1930
1940
1950
1960
1970
1990
2000
2010
  •   Alabama
  •   Alaska
  •   Arizona
  •   Arkansas
  •   California
  •   Colorado
  •   Connecticut
  •   Delaware
  •   Florida
  •   Georgia
  •   Hawaii
  •   Idaho
  •   Illinois
  •   Indiana
  •   Iowa
  •   Kansas
  •   Kentucky
  •   Louisiana
  •   Maine
  •   Maryland
  •   Massachusetts

Exemple divers[modifier le code]

{{ #invoke:Diagramme | histogramme
| groupe 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
| unité = _Things
| noms = Some
| légendes = ::::1940::::::::::1950::::::::::1960::::::::::1970::::::::::1980::::::::::1990::::
}}
10
20
30
40
50
60
1940
1950
1960
1970
1980
1990


Diagramme circulaire[modifier le code]

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

Paramètres[modifier le code]

Paramètres Résultat
séparateur Idem tableau précédent
rayon Le nombre exprimant le nombre de pixels
secteurs Utilisez le paramètre séparateur à 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.
secteur n Syntaxe alternative à secteurs. n est le numéro de la tranche, en commençant par 1. Veillez à ne pas sauter de numéro : si vous définissez secteur 1, secteur 2, secteur 4, secteur 5 ..., en sautant secteur 3, seuls les deux premières tranches seront affichées. La syntaxe est incompatible avec secteurs, c'est à dire qu'ils ne doivent pas être utilisés en association dans le même appel. Les deux codes secteurs et secteur 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:
 | secteur 1 = Value1 : Name1 : Color1 : Link1
 | secteur 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.

pourcentage 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 pourcentage, 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.
préfixe Idem tableau précédent
unité Idem tableau précédent
légendes cachées Idem tableau précédent

Exemple avec paramètre « secteurs »[modifier le code]

{{#invoke:Diagramme|camembert
| rayon = 150
| secteurs = 
    ( 1000000 : Pommes) 
    ( 2000000 : Bananes  : gold) 
    ( 1440000 : Abricots ) 
    ( 6.4e5 : Pêches : : [[Pêche (fruit)|Pêches]] )
    ( 750,000 : Ananas)
| unité = _tonnes
| pourcentage = true
}}

Vous pouvez 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. Également, les valeurs peuvent être fournies 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 est importé dans d'autres wikis).

Pommes: 1 000 000 tonnes (19,7 %)Bananes: 2 000 000 tonnes (39,4 %)Abricots: 1 440 000 tonnes (28,3 %)PêchesAnanas: 750 tonnes (0 %)Circle frame.svg
  •   Pommes: 1 000 000 tonnes (19,7 %)
  •   Bananes: 2 000 000 tonnes (39,4 %)
  •   Abricots: 1 440 000 tonnes (28,3 %)
  •   Pêches: 640 000 tonnes (12,6 %)
  •   Ananas: 750 tonnes (0 %)

Exemple avec paramètre « secteur n »[modifier le code]

Un exemple avec la syntaxe alternative avec "secteur 1", "secteur 2" etc.

{{#invoke:Diagramme|camembert
|rayon= 200
|unité = _Unités
| secteur 1 = 1 : 1
| secteur 2 = 7 : 7
| secteur 3 = 8 : 8
| secteur 4 = 9 : 9
| secteur 5 = 10 : 10
| secteur 6 = 11 : 11
| secteur 7  = 12 : 12
| secteur 8  = 13 : 13
| secteur 9  = 14 : 14
| secteur 10 = 15 : 15
| secteur 11 = 16 : 16
| secteur 12 = 17 : 17
| secteur 13 = 18 : 18
| secteur 14 = 19 : 19
| secteur 15 = 20 : 20
| secteur 16 = 21 : 21
| secteur 17 = 22 : 22
| secteur 18 = 23 : 23
| secteur 19 = 24 : 24
| secteur 20 = 25 : 25
| secteur 21 = 26 : 26
| secteur 22 = 27 : 27
| secteur 23 = 28 : 28
| secteur 24 = 29 : 29
| secteur 25 = 30 : 30
| secteur 26 = 31 : 31
| pourcentage = true
}}
1: 1 Unités (0,2 %)7: 7 Unités (1,5 %)8: 8 Unités (1,7 %)9: 9 Unités (1,9 %)10: 10 Unités (2,1 %)11: 11 Unités (2,3 %)12: 12 Unités (2,5 %)13: 13 Unités (2,7 %)14: 14 Unités (2,9 %)15: 15 Unités (3,2 %)16: 16 Unités (3,4 %)17: 17 Unités (3,6 %)18: 18 Unités (3,8 %)19: 19 Unités (4 %)20: 20 Unités (4,2 %)21: 21 Unités (4,4 %)22: 22 Unités (4,6 %)23: 23 Unités (4,8 %)24: 24 Unités (5 %)25: 25 Unités (5,3 %)26: 26 Unités (5,5 %)27: 27 Unités (5,7 %)28: 28 Unités (5,9 %)29: 29 Unités (6,1 %)30: 30 Unités (6,3 %)31: 31 Unités (6,5 %)Circle frame.svg
  •   1: 1 Unités (0,2 %)
  •   7: 7 Unités (1,5 %)
  •   8: 8 Unités (1,7 %)
  •   9: 9 Unités (1,9 %)
  •   10: 10 Unités (2,1 %)
  •   11: 11 Unités (2,3 %)
  •   12: 12 Unités (2,5 %)
  •   13: 13 Unités (2,7 %)
  •   14: 14 Unités (2,9 %)
  •   15: 15 Unités (3,2 %)
  •   16: 16 Unités (3,4 %)
  •   17: 17 Unités (3,6 %)
  •   18: 18 Unités (3,8 %)
  •   19: 19 Unités (4 %)
  •   20: 20 Unités (4,2 %)
  •   21: 21 Unités (4,4 %)
  •   22: 22 Unités (4,6 %)
  •   23: 23 Unités (4,8 %)
  •   24: 24 Unités (5 %)
  •   25: 25 Unités (5,3 %)
  •   26: 26 Unités (5,5 %)
  •   27: 27 Unités (5,7 %)
  •   28: 28 Unités (5,9 %)
  •   29: 29 Unités (6,1 %)
  •   30: 30 Unités (6,3 %)
  •   31: 31 Unités (6,5 %)