Přeskočit na obsah

Modul:Diagram/Dokumentace

Z Wikipedie, otevřené encyklopedie

Modul Diagram poskytuje dvě funkce: sloupcový diagram a koláčový diagram.

Vykreslení sloupcového diagramu: "sloupcovy"

Parametry

název parametru co dělá
delimiter Řetězec, který bude použit k oddělování jednotlivých hodnot. Implicitně je nastavena dvojtečka (:). Obvykle není třeba nastavovat uživatelskou hodnotu, nastavení je však užitečné pro případ, že byste chtěli použít dvojtečku jako součást některého z parametrů.
sirka Šířka diagramu v pixelech. Je-li uvedena, minimální hodnota je 200. implicitně: 500
vyska Výška diagramu v pixelech. je-li uvedena, minimální hodnota je 200. implicitně: 350
skupina n (kde "n" je číslo; použitím parametrů "skupina 1", "skupina 2" atd. vytvoříte tolik skupin, kolik je jich v grafu zapotřebí) Hodnoty, které mají být v diagramu zobrazeny. viz dále.
tooltip n tooltip, Který bude připojen k příslušnému sloupci. Jestliže sloupec nemá definovaný tooltip a má odkaz, bude tento odkaz použit jako tooltip. Není-li tomu tak, tooltip bude vytvořen pomocí kombinace názvu skupiny a hodnoty, případně doplněné o "jednotky před" a "jednotky za".
odkazy n Odkazy na články, které mají být propojené s jednotlivými sloupci
na sobe Zda umístit sloupce jednotlivých skupin nad sebe. Není-li parametr definován, zobrazí se sloupce vedle sebe. Jakákoli neprázdná hodnota znamená "ano". Umístění nad sebe zakážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
spojeny tooltip Použitelné v kombinaci s parametrem "na sobe": Je-li nastavena hodnota true, tooltip bude zobrazovat akumulovanou hodnotu všech bloků až po aktuální.
barvy Barvy použité pro označení jednotlivých skupin. Musí mít přesně stejný počet hodnot, jako je počet skupin. Barvy mohou být zadány standardními názvy barev použitelnými v html, nebo ve formátu #xxx nebo #xxxxxx.
legenda x Legenda pro jednotlivé hodnoty na ose x. Lze použít formátování Wiki, jako interní odkazy nebo šablony.
skryt popis skupin Je-li nastavena hodnota true, popisky ke skupinám pod diagramem nebudou zobrazeny. Jakákoli neprázdná hodnota znamená "ano". Zobrazení přikážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
oddelene stupnice Nastavení parametru způsobí použití oddělených stupnic v ose y pro každou ze skupin. Prázdná hodnota způsobí použití jedné stupnice pro všechny skupiny. Nelze použít v kombinaci s parametrem "na sobe". Pozor: je-li tento parametr nastaven, stupnice budou vykresleny odděleně i v případě, že některé ze stupnic budou zcela identické. Jakákoli neprázdná hodnota znamená "ano". Společnou stupnici nastavíte tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
jednotky pred Prefix jednotky, který se zobrazí v tooltipu. Např. použití "$" způsobí, že hodnoty se budou v tooltipu zobrazovat jako "$500", a ne pouze "500".
jednotky za Totéž pro sufix jednotky. Např. použití "Kg" způsobí, že hodnoty se budou v tooltiup zobrazovat jako "88Kg", a ne jako "88". Podtržítko ("_") je nahrazeno mezerou; takto lze vložit mezeru mezi hodnotu a sufix.
nazvy skupin Názvy jednotlivých skupin.

Příklady

Základní

{{ #invoke:Diagram | sloupcovy
| skupina 1 = 40 : 50 : 60 : 20
| skupina 2 = 20 : 60 : 12 : 44
| skupina 3 = 55 : 14 : 33 : 5
| odkazy 1 = Apple : McCintosh : Golden delicious
| odkazy 2 = Banán : Meruňka : Broskev
| odkazy 3 = Pomeranč : Hruška : Služka
| tooltip 2 = tooltip 1 : tooltip 2 : tooltip 3 : tooltip 4
| barvy = green : yellow : orange
| nazvy skupin = Jablka : Banány : Pomeranče
| legenda x = Před : Během : Po : In memoriam
}}


tooltip 1
tooltip 2
tooltip 3
10
20
30
40
50
60
70
Před
Během
Po
In memoriam
  •   Jablka
  •   Banány
  •   Pomeranče


Na sobě

Ukázka stejných dat zobrazených v grafu s poněkud umírněnou šířkou a výškou, s použitím možnosti "na sobe" a s nastavením "jednotky za":

{{ #invoke:Diagram | sloupcovy
| vyska = 250
| sirka = 300
| na sobe = 1
| skupina 1 = 40 : 50 : 60 : 20
| skupina 2 = 20 : 60 : 12 : 44
| skupina 3 = 55 : 14 : 33 : 5
| barvy = green : yellow : orange
| nazvy skupin = jablko : banán : pomeranč
| jednotky za = _kg
| legenda x = před : během : po : in memoriam
}}
25
50
75
100
125
150
před
během
po
in memoriam
  •   jablko
  •   banán
  •   pomeranč


Oddělené stupnice

Je možné nastavit pro každou skupinu samostatnou stupnici a jednotky:

{{ #invoke:Diagram | sloupcovy
| sirka = 800
| skupina 1 = 1500000 : 2500000 : 3500000
| skupina 2 = 200 : 5000 : 45000
| skupina 3 = 2000 : 5000 : 20000
| barvy = red : blue : green
| nazvy skupin = Lidé : Auta : Průměrná cena
| legenda x = 1920 : 1965 : 2002
| tooltip 2 = : Pro počet aut v r. 1965 nejsou spolehlivé údaje. Použitá hodnota 5000 představuje kvalifikovaný odhad.
| jednotky pred = : : $
| oddelene stupnice = 1
}}

Všimněte si u "jednotky pred": pro první dvě skupiny prefix jednotky nepotřebujeme, použijeme tedy dvojtečky a prázdné hodnoty. Je možné zadat "::$" namísto " : : $".

Všimněte si také speciálního tooltipu pro počet aut v r. 1965.

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
  •   Lidé
  •   Auta
  •   Průměrná cena

Zde je další příklad s velkým množstvím skupin. Jeho účelem je ukázat, jak bude vypadat diagram s množstvím popisek v legendě.

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

Je-li mnoho hodnot, legendu v ose x lze naředit použitím oddělovačů s prázdnými hodnotami mezi nimi:

{{ #invoke:Diagram | sloupcovy
| skupina 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
| jednotky za = _věcí
| nazvy skupin = něco
| legenda x = ::::1940::::::::::1950::::::::::1960::::::::::1970::::::::::1980::::::::::1990::::
}}
10
20
30
40
50
60
1940
1950
1960
1970
1980
1990

Vykreslení koláčového diagramu: "kolacovy"

Parametery

název parametru co dělá
oddelovac Řetězec, který bude použit k oddělování jednotlivých hodnot. Implicitně je nastavena dvojtečka (:). Obvykle není třeba nastavovat uživatelskou hodnotu, nastavení je však užitečné pro případ, že byste chtěli použít dvojtečku jako součást některého z parametrů.
polomer číslo. Poloměr koláče v pixelech
sektory uspořádané čtveřice zobrazovaných dat uzavřené v závorce. Jednotlivé prvky čtveřice oddělujte pomocí oddělovače definovaného v parametru delimiter: ( hodnota1 : název1 : barva1 : odkaz1 ) ( hodnota2 : název2 : barva2 : odkaz2 ) ...

"Hodnota" je číslo. Lze použít celá čísla, desetinné zlomky (oddělené desetinnou tečkou) nebo vědecký zápis: číslo "sedm milionů dvě stě čtyřicet tisíc" lze zapsat jako 7.24e6, 7240000 nebo 7240000.00.

"Název" je řetězec.

"Barva" je nepovinný údaj. Lze použít všechny webové barvy, jako red nebo #FF0000. 26 barev je nadefinováno implicitně; pokud váš diagram obsahuje více než 26 výsečí, musíte definovat barvy pro výseče č. 27 a vyšší.

"Odkaz" může být externí nebo interní, včetně odkazů na interní kotvy a odstavce v tomtéž článku. Příklad: [[Článek|Text odkazu]] vytvoří odkaz na článek, [[#Nadpis odstavce|Text odkazu]] vytvoří odkaz na kotvu v tomtéž článku, [http://example.org Text odkazu] vytvoří externí odkaz.

sektor n alternativní zápis pro sektory. n je číslo výseče, počítáno od 1. Nelze vynechávat čísla; pokud nadefinujete sektor 1, sektor 2, sektor 4, sektor 5 ... a přeskočíte sektor 3, budou zobrazeny pouze první dvě výseče. Tento zápis je neslučitelný s použitím parametru sektory, tzn. že by neměly být použity oba parametry v jednom volání modulu. Použití parametrů sektory and sektor n v jednom volání může způsobit nepředvídatelné výsledky. Hodnotou parametru sektor n je uspořádaná čtveřice, jak byla popsána výše, ale bez závorek:
 | sektor 1 = Hodnota1 : Název1 : Barva1 : Odkaz1
 | sektor 2 = Hodnota2 : Název2 : Barva2 : Odkaz2
 | ...

Tento zápis umožňuje použít závorky v názvech, odkazech a definicích barev.

procenta Je-li použito, je vypočítaná procentuální hodnota každé výseče připojena k legendě. Zadáte-li např. dvě výseče ( 1 : mláďata ) ( 3 : dospělí ) a použijete parametr procenta, v legendě se zobrazí „mláďata: 1 (25 %)“ a „dospělí: 3 (75 %)“; bez použití parametru procenta se zobrazí pouze „mláďata: 1“ a „“dospělí: 3. Jakákoli neprázdná hodnota znamená "ano". Zobrazení procent zakážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
jednotky pred Prefix jednotky, který se zobrazí v tooltipu. Např. použití "$" způsobí, že hodnoty se budou v tooltipu zobrazovat jako "$500", a ne pouze "500".
jednotky za Totéž pro sufix jednotky. Např. použití "Kg" způsobí, že hodnoty se budou v tooltiup zobrazovat jako "88Kg", a ne jako "88". Podtržítko ("_") je nahrazeno mezerou; takto lze vložit mezeru mezi hodnotu a sufix.
skryt popis skupin Nastavení tohoto parametru zabrání zobrazení legendy ke skupinám pod diagramem. Jakákoli neprázdná hodnota znamená "ano". Zobrazení přikážete tak, že neuvedete parametr vůbec, nebo ho ponecháte nevyplněný.
zahlavi Zobrazí se jako nadpis nad diagramem a legendou.
float obtékání diagramu. Lze použít hodnoty right, left nebo none. Hodnota right umístí diagram vpravo, text bude obtékat zleva. Hodnota left umístí diagram vlevo, text bude obtékat zprava. Hodnota none nebo vynechání parametru způsobí, že diagram se zobrazí vlevo, ale text bude pokračovat až za diagramem a legendou.

Příklady

{{#invoke:Diagram|kolacovy
| polomer = 150
| sektory = 
    ( 1000000 : jablka ) 
    ( 2000000 : banány  : gold) 
    ( 1440000 : meruňky ) 
    ( 6.4e5 : hrušky : : [[Hruška|hrušky]] )
    ( 750000 : ananasy )
| jednotky za = _t
| procenta = zobraz
}}

Všimněte si, že je možné ponechat barvu nedefinovanou (bude použita implicitní hodnota), ale chceme-li přidat odkaz na "hrušku", musíme naznačit chybějící část parametru tím, že přidáme navíc jeden oddělovač.

Všiměte si také, že hodnoty je možné zadávat v prostém formátu nebo ve vědeckém zápisu (jako 6.4e5); v legendě se čísla vždy zobrazí ve formátu podle jazyka nastaveného v příslušné wiki.

jablka: 1 000 000 t (17.2 %)banány: 2 000 000 t (34.3 %)meruňky: 1 440 000 t (24.7 %)hruškyananasy: 750 000 t (12.9 %)
  •   jablka: 1 000 000 t (17.2 %)
  •   banány: 2 000 000 t (34.3 %)
  •   meruňky: 1 440 000 t (24.7 %)
  •   hrušky: 640 000 t (11.0 %)
  •   ananasy: 750 000 t (12.9 %)

Příklad alternativní syntaxe pomocí "sektor 1", "sektor 2" atd.

{{#invoke:Diagram|kolacovy
| polomer = 200
| jednotky za = _ks
| sektor 1 = 1 : 1
| sektor 2 = 7 : 7
| sektor 3 = 8 : 8
| sektor 4 = 9 : 9
| sektor 5 = 10 : 10
| sektor 6 = 11 : 11
| sektor 7  = 12 : 12
| sektor 8  = 13 : 13
| sektor 9  = 14 : 14
| sektor 10 = 15 : 15
| sektor 11 = 16 : 16
| sektor 12 = 17 : 17
| sektor 13 = 18 : 18
| sektor 14 = 19 : 19
| sektor 15 = 20 : 20
| sektor 16 = 21 : 21
| sektor 17 = 22 : 22
| sektor 18 = 23 : 23
| sektor 19 = 24 : 24
| sektor 20 = 25 : 25
| sektor 21 = 26 : 26
| sektor 22 = 27 : 27
| sektor 23 = 28 : 28
| sektor 24 = 29 : 29
| sektor 25 = 30 : 30
| sektor 26 = 31 : 31
| procenta = true
}}
1: 1 ks (0.2 %)7: 7 ks (1.5 %)8: 8 ks (1.7 %)9: 9 ks (1.9 %)10: 10 ks (2.1 %)11: 11 ks (2.3 %)12: 12 ks (2.5 %)13: 13 ks (2.7 %)14: 14 ks (2.9 %)15: 15 ks (3.2 %)16: 16 ks (3.4 %)17: 17 ks (3.6 %)18: 18 ks (3.8 %)19: 19 ks (4.0 %)20: 20 ks (4.2 %)21: 21 ks (4.4 %)22: 22 ks (4.6 %)23: 23 ks (4.8 %)24: 24 ks (5.0 %)25: 25 ks (5.3 %)26: 26 ks (5.5 %)27: 27 ks (5.7 %)28: 28 ks (5.9 %)29: 29 ks (6.1 %)30: 30 ks (6.3 %)31: 31 ks (6.5 %)
  •   1: 1 ks (0.2 %)
  •   7: 7 ks (1.5 %)
  •   8: 8 ks (1.7 %)
  •   9: 9 ks (1.9 %)
  •   10: 10 ks (2.1 %)
  •   11: 11 ks (2.3 %)
  •   12: 12 ks (2.5 %)
  •   13: 13 ks (2.7 %)
  •   14: 14 ks (2.9 %)
  •   15: 15 ks (3.2 %)
  •   16: 16 ks (3.4 %)
  •   17: 17 ks (3.6 %)
  •   18: 18 ks (3.8 %)
  •   19: 19 ks (4.0 %)
  •   20: 20 ks (4.2 %)
  •   21: 21 ks (4.4 %)
  •   22: 22 ks (4.6 %)
  •   23: 23 ks (4.8 %)
  •   24: 24 ks (5.0 %)
  •   25: 25 ks (5.3 %)
  •   26: 26 ks (5.5 %)
  •   27: 27 ks (5.7 %)
  •   28: 28 ks (5.9 %)
  •   29: 29 ks (6.1 %)
  •   30: 30 ks (6.3 %)
  •   31: 31 ks (6.5 %)

Odkazy

V tomto článku byl použit překlad textu z článku Module:Chart/doc na anglické Wikipedii.