Module:Chart/doc: Difference between revisions

Content deleted Content added
Why would an outdated extension with security issues have been more suitable?
 
(42 intermediate revisions by 16 users not shown)
Line 1:
{{high-use|850}}
{{Template display|badmobile}}
Module Chart exports two functions: bar chart and pie chart
 
Line 21 ⟶ 23:
|links n || links to articles to be associated with specific bar
|-
|stack || whether to stack the different groups on top of each other. do not specify to show bars side by side. Any non-empty value means "yes". To say "no", simply do not supply this parameter at all, or leave the value blank.
|-
|{{nowrap|tooltip value accumulation}} || useful only with stack: when set to true, tooltip will show accumulated value of all blocks up to current one
|-
|colors || the colors used to denote the various groups. should have exactly as many values as # of groups. can be given as standard html-recognized color names, or using #xxx or #xxxxxx notation.
Line 27 ⟶ 31:
|x legends || The legends for the X values. Wikicode, such as internal links or templates can be used.
|-
|{{Nowrapnowrap|scale perhide group legends}} || if set to 1true, togroup uselegends separatewill Y-not scalebe forshown eachbelow groupchart. leaveAny non-empty tovalue usemeans one scale for all groups"yes". incompatibleTo withsay "stackno"., Notesimply thatdo evennot ifsupply somethis ofparameter theat scalesall, areor exactlyleave the same, they will be drawn separately when this setting isvalue onblank.
|-
|{{Nowrap|scale per group}} || set to use separate Y- scale for each group. leave empty to use one scale for all groups. incompatible with "stack". Note that even if some of the scales are exactly the same, they will be drawn separately when this setting is on. Any non-empty value means "yes". To say "no", simply do not supply this parameter at all, or leave the value blank.
|-
|{{nowrap|units prefix}} || used in tooltip. e.g., $, so values will show as "$500" instead of "500" in the tooltip
Line 34 ⟶ 40:
|-
| {{nowrap|group names}} || names of different groups
|-
| {{nowrap|y tick marks}} || number of tick marks on the y axis. if the value is negative or omitted, the module will attempt to automatically calculate a sensible number of tick marks.
|}
 
==Display in the mobile view==
many of the parameters are multi-valued, and are delimited with "delimiter"
Bar charts behave unpredictably, causing problems with the axes and legend. Use [[Template:Graph:Chart]] instead. {{dubious span |date=July 2023 |Pie charts aren't too bad.}}
 
===Examples===
some simple examples:
 
==== Basic ====
<pre>
{{ #invoke:Chart | bar chart
Line 70 ⟶ 80:
 
 
====Stacked====
Here is the same graph, with more modest height and width, using "stack", and adding "units suffix" for good measure:
 
Line 101 ⟶ 112:
 
 
====Scale per group====
It is possible to show each of the groups using different scale and units:
 
This option has been disabled. It was rarely used and broke in the last code update.
<pre>
Here is an example with large number of groups - mainly to test how it looks with large number of legends:
{{ #invoke:Chart | 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 = People : Cars : Average car cost
| x legends = 1920 : 1965 : 2002
| tooltip 2 = : There is no good data for number of cars in 1965. we use 5,000 as best estimate
| units prefix = : : $
| scale per group = 1
}}
</pre>
 
Notice the "units prefix" field: we do not need prefix for the first 2 groups, so we use colons with no content. we could write "::$" instead of " : : $".
 
Also note the special tooltip for the "Cars" number for 1965.
 
 
 
{{ #invoke:Chart | 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 = People : Cars : Average car cost
| x legends = 1920 : 1965 : 2002
| tooltip 2 = : There is no good data for number of cars in 1965. we use 5,000 as best estimate
| units prefix = : : $
| scale per group = 1
}}
 
<pre>
{{ #invoke:Chart | bar chart
| width = 800
| height = 550
| group 1 = 1500000 : 2500000 : 3500000
| group 21 = 200 1: 5000 2: 450003:4:5:4:3:2:1
| group 32 = 2000 1: 5000 2: 200003:4:5:4:3:2:1
| group 3 = 1:2:3:4:5:4:3:2:1
| colors = red : blue : green
| group names4 = People 1: Cars 2: Average car cost3:4:5:4:3:2:1
| group 5 = 1:2:3:4:5:4:3:2:1
| x legends = 1920 : 1965 : 2002
| group 6 = 1:2:3:4:5:4:3:2:1
| tooltip 2 = : There is no good data for number of cars in 1965. we use 5,000 as best estimate
| unitsgroup prefix7 = 1: 2: $3:4:5:4:3:2:1
| group 8 = 1:2:3:4:5:4:3:2:1
| scale per group = 1
| group 9 = 1:2:3:4:5:4:3:2:1
| group 10 = 1:2:3:4:5:4:3:2:1
| group 11 = 1:2:3:4:5:4:3:2:1
| group 12 = 1:2:3:4:5:4:3:2:1
| group 13 = 1:2:3:4:5:4:3:2:1
| group 14 = 1:2:3:4:5:4:3:2:1
| group 15 = 1:2:3:4:5:4:3:2:1
| group 16 = 1:2:3:4:5:4:3:2:1
| group 17 = 1:2:3:4:5:4:3:2:1
| group 18 = 1:2:3:4:5:4:3:2:1
| group 19 = 1:2:3:4:5:4:3:2:1
| group 20 = 1:2:3:4:5:4:3:2:1
| group 21 = 1:2:3:4:5:4:3:2:1
| colors = Silver:Gray:Black:Red:Maroon:Yellow:Olive:Lime:Green:Aqua:Teal:Blue:Navy:Fuchsia:Purple:ForestGreen:Tomato:LightSeaGreen:RosyBrown:DarkOliveGreen:MediumVioletRed
| group names = Alabama:Alaska:Arizona:Arkansas:California:Colorado:Connecticut:Delaware:Florida:Georgia:Hawaii:Idaho:Illinois:Indiana:Iowa:Kansas:Kentucky:Louisiana:Maine:Maryland:Massachusetts
| x legends = 1920 : 1930 : 1940: 1950 : 1960 : 1970 : 1990 : 2000 : 2010
| units prefix = $
| units suffix = _billion
| stack = 1
}}
</pre>
 
Notice the "units prefix" field: we do not need prefix for the first 2 groups, so we use colons with no content. we could write "::$" instead of " : : $".
 
Also note the special tooltip for the "Cars" number for 1965.
 
 
 
Here is an example with large number of groups - mainly to test how does it look with large number of legends.
 
{{ #invoke:Chart | bar chart
Line 185 ⟶ 176:
| group 21 = 1:2:3:4:5:4:3:2:1
| colors = Silver:Gray:Black:Red:Maroon:Yellow:Olive:Lime:Green:Aqua:Teal:Blue:Navy:Fuchsia:Purple:ForestGreen:Tomato:LightSeaGreen:RosyBrown:DarkOliveGreen:MediumVioletRed
| group names = Alabama:Alaska:Arizona:Arkansas:California:Colorado:Connecticut:Delaware:Florida:Georgia: Hawaii:Idaho:Illinois:Indiana:Iowa:Kansas:Kentucky:Louisiana:Maine:Maryland:Massachusetts
| x legends = 1920 : 1930 : 1940: 1950 : 1960 : 1970 : 1990 : 2000 : 2010
| units prefix = $
| units suffix = _Billion_billion
| stack = 1
}}
Line 194 ⟶ 185:
 
If there are many values, x legends can be diluted by using delimiters with nothing in between:
 
 
<pre>
Line 215 ⟶ 205:
 
{{-}}
 
 
 
 
== Drawing Pie charts: "pie chart" ==
Line 231 ⟶ 218:
|'''radius''' ||number. The radius of the pie in pixels
|-
|'''slices''' || TupplesTuples, in parenthesis. Use delimiter inside the tuppletuple:
( Value1 : Name1 : Color1 : Link1 ) ( Value2 : Name2 : Color2 : Link2 ) ...
The values are numbers. The numbers can be integers or decimal fractions, or using the scientific notation: 7.24e6, 7,240,000, or 7240000.00 are all acceptable for 7 Million and 240 thousands.
 
Names are strings. Colors are optional. you can use any [[Web colors]], such as "red" or "#FF0000". Up to 26 default colors are defined, but if your pie has more than 26 slices, you must define the colors of slice #27 and up. Links can be external or internal links, including linking to internal anchors and paragraphs in the same article, like so: <nowiki>[[Article|Tooltip]] for internal link, [[#Paragraph name|Tooltip]] for linking to an anchor in same article, or [http://example.org Tooltip] for external link.</nowiki>
|-
|{{nowrap|'''slice n'''}}|| alternative syntax to "slices". n is the slice number, beginning with 1. make sure not to skip: if you define "slice 1", "slice 2", "slice 4", "slice 5"..., skipping slice 3, only the first two slices will be shown. this syntax is incompatible with "slices", i.e., they should not be used in conjunction in the same invocation. Using both "slices" and "slice n" in the same invocation will cause unpredictable results. The value is like a single "tuple" as explained above, but without the parenthesis:
|'''percent'''|| if used, the percentage of each slice will be calculated and added to the legend: so if you have two slices, like so: ( 1 : Younglings ) ( 3 : elders ), and use define "percent", the legends will become "Younglings: 1 (25%)" and "Elders: 3 (75%)", instead of simply "Younglings: 1" and "Elders: 3"
<pre>
| slice 1 = Value1 : Name1 : Color1 : Link1
| slice 2 = Value2 : Name2 : Color2 : Link2
| ...
</pre>
This syntax allows you to use parenthesis in names, links, and colors.
|-
|'''percent'''|| if used, the percentage of each slice will be calculated and added to the legend: so if you have two slices, like so: ( 1 : Younglings ) ( 3 : elders ), and use define "percent", the legends will become "Younglings: 1 (25%)" and "Elders: 3 (75%)", instead of simply "Younglings: 1" and "Elders: 3". Any non-empty value means "yes". To say "no", simply do not supply this parameter at all, or leave the value blank.
|{{nowrap|units prefix}} || used in the legend. e.g., defining "units prefix=$", values will show as "$500" instead of "500" in the legends
|-
|'''{{nowrap|units suffixprefix}}''' || dittoused forin unitsthe suffixlegend. use, e.g., defining "Kg"units soprefix=$", values will show as 88Kg"$500" instead of 88 in legend. underscore ("_500") are replaced by spaces, to allow a space betweenin the value and the suffix.legends
|-
|'''{{nowrap|units suffix}}''' || ditto for units suffix. use, e.g. "Kg" so values will show as 88Kg instead of 88 in legend. underscore ("_") are replaced by spaces, to allow a space between the value and the suffix.
|-
|'''{{nowrap|hide group legends}}''' || Setting to true prevents displaying of the group legends under the chart. Any non-empty value means "yes". To say "no", simply do not supply this parameter at all, or leave the value blank.
|}
 
===Examples===
 
<pre>
{{#invoke:Chart|pie chart
| radius = 200150
| slices =
( 1001000000 : Apples )
( 2002000000 : Bananas : gold)
( 1441440000 : Apricots )
( 606.4e5 : Pears : : [[Pear|Pears]] )
( 75750,000 : Pineapples )
| units suffix = _Kg_Tonne
| percent = true
}}
 
Note that we can leave the color empty to use the default, but in order to add the link to "Pear",
we had to mark the parameter by adding an extra delimiter to mark the omitted color parameter
</pre>
 
{{#invoke:Chart|pie chart
| radius = 200150
| slices =
( 1001000000 : Apples )
( 2002000000 : Bananas : gold )
( 1441440000 : Apricots )
( 606.4e5 : Pears : : [[Pear|Pears]] )
( 75750,000 : Pineapples )
| units suffix = _Kg_Tonne
| percent = true
}}
 
<pre>
{{#invoke:chart|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
}}
</pre>
 
{{#invoke:chart|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
}}
<noinclude>
[[Category:Module documentation pages]]
</noinclude>