Wikipedia:Graphs and charts
This help page is a how-to guide. It explains concepts or processes used by the Wikipedia community. It is not one of Wikipedia's policies or guidelines, and may reflect varying levels of consensus. |
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 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" and "diagram" are ambiguous terms, sometimes used interchangeably.
Accuracy
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 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
Vega
A graph-making tool called Vega was introduced in May 2015. You can use it to make charts and maps. If you have an old browser, you will see images instead. You can learn how to use it and write help pages for your wiki. You can use the 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
A variety of templates and styles are available to create timelines.
- The {{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 here, and an example of it being used in an article here.
- The {{Timeline}} template is designed to show three items in a simple timeline, representing past, present, and future. It is convenient for navigation through a series of articles, e.g., the succession of people holding an elected office. It looks like this:
Template:Timeline may refer to:
- {{For timeline}}
- {{Navbox timeline}}
- {{Include timeline}}
- {{Timeline Legend}}
- {{Prose timeline}}
- {{Sidebar timeline}}
- {{Timeline of release years}}
- {{Timeline-start}}
- {{Timeline-item}}
- {{Timeline-end}}
- {{Timeline-event}}
- {{Timeline-links}}
- 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
70 / 100
|
70% of women with breast cancer have no known risk factors |
{{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:
{| class="infobox" style="width: 10em;"
|-
| {{Composition bar|70|100|hex=pink}}
|-
| class="thumbcaption" | 70% of women with breast cancer have no known risk factors
|}
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}} is an experimental graph-drawing template that produces a pie chart 200 pixels wide in the article.
Setting the other
parameter to yes
will pad the chart so that the values total to 100.
This example was created by typing the following code:
{{Pie chart
|other = yes
|value1 = 27
|label1 = One
|value2 = 32
|label2 = Two
|value3 = 12
|label3 = Three
|value4 = 9
|label4 = Four}}
Up to nine wedges can be included.
Horizontal bar graph
Bar chart
{{Bar chart}} is a template that displays the data as a horizontal bar chart. The width of the graph can be changed.
Country | Predicted median age at death |
---|---|
China | |
India | |
USA | |
Indonesia | |
Brazil |
Bar box
{{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.
Stacked bar
{{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
|
Vertical bar graph
Module:Chart is a Lua module that may be used to create several different types of vertical bar graphs.
A standard vertical bar graph
- Apple
- Banana
- Orange
A stacked vertical bar graph
- Apple
- Banana
- Orange
Brick chart
{{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 {{Graph:Chart}} implements line charts, such as:
Graphs are unavailable due to technical issues. There is more info on Phabricator and on MediaWiki.org. |
{{Graph:Chart}} can also draw area charts, bar charts, pie charts and scatter plots.
Geographical maps
The template {{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:
Graphs are unavailable due to technical issues. There is more info on Phabricator and on MediaWiki.org. |
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
- Many spreadsheet, drawing, and desktop publishing programs allow you to create graphs and export them as images.[1][2]
- gnuplot can produce a wide variety of charts and graphs; see samples with source code at Commons.
- In Python using matplotlib (examples)
- The 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 here.
- WebPlotDigitizer 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:Chart and graph resources
- Choose the color
- BrewerColorLegends