View source for Wikipedia:Graphs and charts


{{For|record charts|Wikipedia:Record charts}}
{{For|instructions on how to make a graph in Wikitext|Help:Graph}}
{{Wikipedia how-to|WP:GRAPHS}}
A '''[[graph]]''' or '''[[chart]]''' or '''[[diagram]]''' is a diagrammatical illustration of a set of [[data]]. If the graph is uploaded as an image file, it can be placed within articles [[Wikipedia:Picture tutorial|just like any other image]].

Graphs must be accurate and convey information efficiently.  They should be viewable at different computer screen resolutions.  Ideally, graphs will also be aesthetically pleasing.

Please note that "[[graph]]", "[[chart (disambiguation)|chart]]" and "[[diagram]]" are ambiguous terms, sometimes used interchangeably.

==Accuracy==
{{main|Wikipedia:Don't draw misleading graphs}}
Graphs that show a trend of data should illustrate the trend accurately in its context, rather than illustrating the trend in an exaggerated or sensationalized way. In short, '''don't draw misleading graphs'''.

Choose a type of graph that is appropriate for the data you are illustrating.  
*[[Cartesian coordinate system|Cartesian coordinates]]
*[[Pie chart]] — good for showing how a whole is divided up (e.g., how much money is spent on each thing in a budget)
*[[Bar graph]] — good for showing how things compare to each other (e.g., whether [[foo]] or [[bar]] is bigger) or how it has changed (e.g., sales of [[foo]] each year)

==Creating graphs for Wikipedia==
{{main|Wikipedia:How to create graphs for Wikipedia articles}}

===Vega===
A graph-making tool called Vega was introduced in May 2015.  You can use it to make [[mw:Extension:Graph/Demo|charts and maps]]. If you have an old browser, you will see images instead. You can [https://github.com/vega/vega/wiki learn how to use it] and write help pages for your wiki. You can use the [http://vega.github.io/vega-editor/?mode=vega Vega v2 edit tool] to make charts and copy the code to your wiki. Note that only Vega 2 is supported at the moment. Charts and maps use complex code, and you should put them into templates.

===Methods using Wikipedia templates===
====Timeline====
{{Main|Wikipedia:Timeline}}

A variety of templates and styles are available to create timelines.  

* The {{tl|Graphical timeline}} template allows representations of extensive timelines.  The template offers complex formatting and labeling options to control the output.  Typically, each use is made into its own template, and the template is then transcluded into the article.  See an example [[Template:Graphical timeline#In_use:_an_example|here]], and an example of it being used in an article [[CBER|here]]. 
* The use of fixed images, such as [[:File:Narnia Timeline.svg]], was common in the past.  However, these are difficult or impossible to adjust later, so this approach is frequently not the best option.
* In other cases, whole articles or sections present timelines in text as association (definition) lists.  [[Timeline of chemistry]] is a featured list that uses this style to good effect.

====Single statistic====
{| class="infobox" style="width: 10em;"
|-
| {{Composition bar|70|100|hex=pink}}
|-
| class="thumbcaption" | 70% of women with breast cancer have no known risk factors
|}
{{tl|Composition bar}} can be used to provide a single statistic.

This example shows 70% (70 out of 100), but the template is flexible and can show any positive integer out of any (equal or larger) integer.  The template is 100 pixels wide, so the results are rounded to 1%.

The code for producing this, set in a one-column, two-row table with a caption in the second row, is shown here:

:<code><nowiki>{| class="infobox" style="width: 10em;" </nowiki></code>
:<code><nowiki>|-</nowiki></code>
:<code><nowiki>| {{Composition bar|70|100|hex=pink}}</nowiki></code>
:<code><nowiki>|-</nowiki></code>
:<code><nowiki>| class="thumbcaption" | 70% of women with breast cancer have no known risk factors</nowiki></code>
:<code><nowiki>|}</nowiki></code>

To use this, copy the above and replace the values ("70" and "100" in the middle line) and the caption ("70% of women...") with your data.  The color can also be changed, from "red" in this example to "blue", "green", or any [[hex color]].

If you want to present multiple statistics, you can stack multiple copies of the template inside the first cell of the table.

====Pie chart====
{{Pie chart
|other = yes
|value1 = 27
|label1 = One
|value2 = 32
|label2 = Two
|value3 = 12
|label3 = Three
|value4 = 9
|label4 = Four}}

{{tl|Pie chart}} is an ''experimental'' graph-drawing template that produces a [[pie chart]] 200 pixels wide in the article.

Setting the <code>other</code> parameter to <code>yes</code> will pad the chart so that the values total to 100.

This example was created by typing the following code:

:<code><nowiki>{{Pie chart</nowiki></code>
:<code><nowiki>|other = yes</nowiki></code>
:<code><nowiki>|value1 = 27</nowiki></code>
:<code><nowiki>|label1 = One</nowiki></code>
:<code><nowiki>|value2 = 32</nowiki></code>
:<code><nowiki>|label2 = Two</nowiki></code>
:<code><nowiki>|value3 = 12</nowiki></code>
:<code><nowiki>|label3 = Three</nowiki></code>
:<code><nowiki>|value4 = 9</nowiki></code>
:<code><nowiki>|label4 = Four}}</nowiki></code>

Up to 30 slices can be included.

==== Horizontal bar graph ====
===== Bar chart =====
{{tl|Bar chart}} is a template that displays the data as a horizontal [[bar chart]].  The width of the graph can be changed.

{{Bar chart
| title       = Women's life expectancy at birth
| label_type  = Country
| data_type   = Predicted median age at death
| bar_width   = 20
| width_units = em
| data_max    = 85
| label1   = China
| data1    = 71
| label2   = India
| data2    = 60
| label3   = USA
| data3    = 79
| label4   = Indonesia
| data4    = 71
| label5   = Brazil
| data5    = 67
}}

===== Bar box =====
{{tl|Bar box}} is a template that displays the data as a horizontal [[bar chart]]. The width of the chart can be changed, but care must be taken to make sure the bars stay within the box on many browsers.

{{bar box
|Delayed bone age=7%
|Hypertelorism=46%
|Brachydactyly=44%
|Triangular face=42%
|Speech delay=39%
|Frontal bossing=36%
|Anomalous ear=30%
|Café-au-lait spots=30%
|Cryptorchidism=30%
|Cardiac abnormalities=30%

|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=400px
|bars=
{{bar pixel|Foobar|red|33|,213}}
{{bar pixel|Barfoo|green|123|,123}}
{{bar pixel|Bazbar|blue|210|,121}}
{{bar pixel|Barfoobaz|orange|13||12,854}}
|caption=Some stuff displayed by quantity.
}}

===== Stacked bar =====
{{tl|Stacked bar}} is a template that displays a set of data as a single bar of a stacked bar chart. The template supports up to 12 segments in their proportional lengths compared to a total, along with captions for each section. Care must be taken that the captions do not overlap excessively in smaller resolutions, and in many cases you may not be able to include captions if the segment(s) is too small.

;Number of video game articles in the 1970s and earlier by year

{{Stacked bar|A1=13|T1=<1970s|A2=5|T2=71|A3=4|T3=72|A4=8|T4=73|A5=7|T5=74|A6=16|T6=1975|A7=23|T7=1976|A8=24|T8=1977|A9=37|T9=1978|A10=54|T10=1979|Total=191}}

==== Vertical bar graph ====
[[Module:Chart]] is a [[WP:Lua|Lua]] module that may be used to create several different types of vertical bar graphs.

'''A standard vertical bar graph'''
{{ #invoke:Chart | bar-chart
| 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
| x legends = Before : During : After : Post mortem
}}

<br />
'''A stacked vertical bar graph'''
{{ #invoke:Chart | 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
}}

====Brick chart====
{{Brick chart
|caption = Causes of death
|label1 = [[Cardiovascular diseases]]
|value1 = 29
|label2 = [[Infectious]] and [[parasitic disease]]s
|value2 = 23
|label3 = [[Cancer]]
|value3 = 13
|label4 = [[Respiratory disease]]
|value4 = 7
|label5 = Unintentional injuries
|value5 = 6
|label6 = Uncertain
|value6 = 0.2 | color6=#616161
}}

{{tl|Brick chart}} is a simple block-oriented chart template.  It assumes that everything must add up to total=100 (or specify), and fills in any missing amounts with "other".

You can label (and optionally choose colors for) each item, and the labels can be wikilinks to relevant articles.  Now, decimal amounts are supported (tiny amounts will appear as slivers).

====Line charts====
The template {{tl|Graph:Chart}} implements [[line chart]]s, such as:
{{Graph:Chart|type=line
|width=500
|height=350
|showSymbols=yes
|colors=red,blue,green
|yGrid =
|x=1,2,3,4,5,6,7,8,9,10
| y1 = ,2200,2400,2500,2600,2500
| y2 = 1400,2000,1600,1800,2400,2400,2500,2000,1600,1800
| y3 = 1800,,,2000,1600,1800,2400,,2400
}}

{{tl|Graph:Chart}} can also draw area charts, bar charts, pie charts and scatter plots.

====Geographical maps====
The template {{tl|Graph:Map}} allows to draw geographical maps with either discrete colors for qualitative maps, or a gradient of colors for continuous values per country. Here is an example:
{{Highlighted world map by country
|US=blue
|CA=green
|IN=#ff9933
|projection=mercator|scale=80
}}

===Methods outside Wikipedia===
:''[[Scalable Vector Graphics]] (SVG) is the recommended format.''
* '''[[Module:Chart]]''' creates bar and pie charts on Wikipedia without need for external tools

* [https://charts.livegap.com/ livegap Charts] creates  line , bar , spider ,polarArea and pie charts and export them as images without need  to download any tools.

* Many spreadsheet, drawing, and [[desktop publishing]] programs allow you to create graphs and export them as images.

[http://stackoverflow.com/questions/7485835/how-can-i-export-an-excel-openoffice-libreoffice-chart-to-svg][http://superuser.com/questions/415707/export-excel-graphs-as-vector-graphics-files-e-g-svgs]
* [[Wikipedia:How_to_create_charts_for_Wikipedia_articles#gnuplot|gnuplot]] can produce a wide variety of charts and graphs; see [[:commons:Category:Images with Gnuplot source code|samples with source code at Commons]].
* In Python using [[matplotlib]] ([[:commons:Category:Created_with_Matplotlib|examples]])
* The [[R (programming language)|R programming language]] can be used for creating Wikipedia graphs.
* Google's chart [[application programming interface]] allows a variety of graphs to be created. It can be found [http://code.google.com/apis/chart/ here].
* [https://veusz.github.io/ Veusz] is a free scientific graphing tool that can produce 2D and 3D plots. Users can use it as a module in Python.
* [https://www.geogebra.org/ GeoGebra] is open-source graphing calculator and is freely available for non-commercial users.
* [https://apps.automeris.io/wpd/ WebPlotDigitizer] or [https://plotdigitizer.com/app PlotDigitizer's online free app] can be used to extract data from charts.

==See also==
*[[Wikipedia:How to create charts for Wikipedia articles]]
*[[Help:Barchart]]
*[[Wikipedia:Family trees]]
*[[Wikipedia:Collaboration to convert graphs to SVG]]
*[[Wikipedia:Don't draw misleading graphs]]
*[[Wikipedia:To scale charts]]
*[[Wikipedia:Images]]
*[[Wikipedia:Record charts]]
*[[Commons:Commons:Chart and graph resources|Commons:Chart and graph resources]]
*[[Wikipedia:Coloring cartographic maps#Choose the colors|Choose the color]]
*[[Wikipedia:Coloring cartographic maps#Preparing the code from the legend of the map|BrewerColorLegends]]
*[[mw:Extension:Graph/Interactive Graph Tutorial]]
*[[Special:GraphSandbox]]

{{Wikipedia technical help|collapsed}}
[[Category:Wikipedia help]]