User:Jonathan Lane Studeman/Barchart/doc

This is a template for displaying a bar chart.

Simple example in the default style: {{User:Jonathan Lane Studeman/Barchart | columns = 6 | Jan| Feb| Mar| Apr| May| Jun | blue|Berries| 65| 38| 72| 47| 20| 30 }}	Berries 65 38 72 47 20 30 Jan Feb Mar Apr May Jun Total: 272
Same thing, but horizontal (style=2): {{User:Jonathan Lane Studeman/Barchart | style = 2 | columns = 6 | Jan| Feb| Mar| Apr| May| Jun | blue|Berries| 65| 38| 72| 47| 20| 30 }}	Berries Jan 65 Feb 38 Mar 72 Apr 47 May 20 Jun 30 Total: 272

Given multiple data rows that look like this:
↔ Max. data columns: 16
{{User:Jonathan Lane Studeman/Barchart | columns = 12 |Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec | green| Apples| 60| 70| 90| 30| 50| 30|100|130|120| 90| 50|110 |yellow| Bananas| 90| 80|110| 60| 70| 80| 70| 70| 40| 50| 50| 60 |orange| Oranges| 50| 40| 60|110| 90| 60| 30| 60| 70| 60| 80| 40 }}	↕ Max. data rows: 8
...the template displays a color-keyed chart that looks like this: 200 190 260 200 210 170 200 260 230 200 180 210 Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec Total: 2510 Apples Bananas Oranges

Title, Scale and Source

Optional named parameters include title, scale and source.

A title appears bolded and centered above the chart.

A scale is needed for handling very small or large numbers.

A source tells the viewer where the data came from.

title = Small numbers, large scalescale = 10source = Data invented for this example. {{User:Jonathan Lane Studeman/Barchart | title = Small numbers, large scale | scale = 10 | source = Data invented for this example. | columns = 6 |Jan|Feb|Mar|Apr|May|Jun | red|Cherries| 6| 7| 9| 3| 5| 3 | blue| Berries| 9| 8| 11| 6| 7| 8 |purple| Grapes| 5| 4| 6| 11| 9| 6 }} Small numbers, large scale (10) 20 19 26 20 21 17 Jan Feb Mar Apr May Jun Total: 123 Cherries Berries Grapes Source: Data invented for this example.

title = Large numbers, small scalescale = 0.1        style = 2source = Data invented for this example. {{User:Jonathan Lane Studeman/Barchart | title = Large numbers, small scale (0.1) | scale = 0.1 | style = 2 | source = Data invented for this example. | columns = 6 | Jul| Aug| Sep| Oct| Nov| Dec | green| Apples| 600| 700| 900| 300| 500| 300 |yellow| Bananas| 900| 800|1100| 600| 700| 800 |orange| Oranges| 500| 400| 600|1100| 900| 600 }} Large numbers, small scale (0.1) Jul 2000 Aug 1900 Sep 2600 Oct 2000 Nov 2100 Dec 1700 Total: 12300 Apples Bananas Oranges Source: Data invented for this example.

Styles

Lastly, there are eight styles to choose from.

Odd numbered styles are vertical.

Even numbered styles are horizontal.

Styles 3 and 4 have borders and shading.

Styles 5 thru 8 are the same as 1 thru 4, but with additional detail.

For example, here's one using style=8, a horizontal bar chart with borders,
shading and additional detail, also illustrating the effect of missing data:

{{User:Jonathan Lane Studeman/Barchart | style = 8 | scale = 0.1 | title = Fruit Amounts (lbs) | source = Data invented for this example. | columns = 6 |2009|2010|2011|2012|2013|2014 | green| Apples| | 700| 900| 300| 500| 300 |yellow| Bananas| 900| |1100| 600| 700| 800 |orange| Oranges| 500| 400| |1100| 900| 600 | red|Cherries| 700| 300| 600| | 900| 600 | blue| Berries| 300| 500| 600| 900| 700| }}

Fruit Amounts (lbs) 2009 300 700 500 900 2400 2010 500 300 400 700 1900 2011 600 600 1100 900 3200 2012 900 1100 600 300 2900 2013 700 900 900 700 500 3700 2014 600 600 800 300 2300 Total: 16400 Apples (2700) Bananas (4100) Oranges (3500) Cherries (3100) Berries (3000) Source: Data invented for this example.

And here's the same data in style=5, a detailed vertical chart:

Fruit Amounts (lbs) 2400   900 500 700 300 1900   700 400 300 500 3200   900 1100 600 600 2900   300 600 1100 900 3700   500 700 900 900 700 2300   300 800 600 600 2009 2010 2011 2012 2013 2014 Total: 16400 Apples (2700) Bananas (4100) Oranges (3500) Cherries (3100) Berries (3000) Source: Data invented for this example.