Template:Television ratings graph

Template documentation[view] [edit] [history] [purge]

This template uses Lua:

Module:Television ratings graph (sandbox)

Usage

The purpose of the {{Television ratings graph}} template is to display an EasyTimeline of the viewer figures for a television series, in both graph and tabular format. Bars are displayed on the graph for each episode, with the overall episode number below, and seasons are separated by different colours.

Syntax

{{Television ratings graph
| title           = TEXT
| season_title    = TEXT
| no_graph        = TEXT
| no_table        = TEXT
| color{1,2,...}  = COLOR
| legend{1,2,...} = TEXT
| refs            = REFERENCES
| width           = NUMBER
| height          = NUMBER
| average         = TEXT
| country         = TEXT
| (Unnamed)       = NUMBER OR HYPHEN
}}

Example

Code

{{Television ratings graph
| title       = Game of Thrones
| country     = U.S.
| color1      = #295354
| color2      = #D09916
| color3      = #54575A
| color4      = #222222
| color5      = #68411C
| color6      = #31485C
| color7      = #091411 
| color8      = #C6D9E4 
| average     = y
| refs        = {{Dummy ref}}
|-
<!-- S01E01 -->| 3.06
<!-- S01E02 -->| 2.20
<!-- S01E03 -->| 2.44
<!-- S01E04 -->| 2.45
<!-- S01E05 -->| 2.58
<!-- S01E06 -->| 2.44
<!-- S01E07 -->| 2.40
<!-- S01E08 -->| 2.72
<!-- S01E09 -->| 2.66
<!-- S01E10 -->| 3.04
<!-- S01_AV -->| 2.52
|-
<!-- S02E01 -->| 3.86
<!-- S02E02 -->| 3.76
<!-- S02E03 -->| 3.77
<!-- S02E04 -->| 3.65
<!-- S02E05 -->| 3.90
<!-- S02E06 -->| 3.88
<!-- S02E07 -->| 3.69
<!-- S02E08 -->| 3.86
<!-- S02E09 -->| 3.38
<!-- S02E10 -->| 4.20
<!-- S02_AV -->| 3.80
|-
<!-- S03E01 -->| 4.37
<!-- S03E02 -->| 4.27
<!-- S03E03 -->| 4.72
<!-- S03E04 -->| 4.87
<!-- S03E05 -->| 5.35
<!-- S03E06 -->| 5.50
<!-- S03E07 -->| 6.09
<!-- S03E08 -->| 5.13
<!-- S03E09 -->| 5.22
<!-- S03E10 -->| 5.39
<!-- S03_AV -->| 4.97
|-
<!-- S04E01 -->| 6.64
<!-- S04E02 -->| 6.31
<!-- S04E03 -->| 6.59
<!-- S04E04 -->| 6.95
<!-- S04E05 -->| 7.16
<!-- S04E06 -->| 6.40
<!-- S04E07 -->| 7.20
<!-- S04E08 -->| 7.17
<!-- S04E09 -->| 6.95
<!-- S04E10 -->| 7.09
<!-- S04_AV -->| 6.84
|-
<!-- S05E01 -->| 8.00
<!-- S05E02 -->| 6.81
<!-- S05E03 -->| 6.71
<!-- S05E04 -->| 6.82
<!-- S05E05 -->| 6.56
<!-- S05E06 -->| 6.24
<!-- S05E07 -->| 5.40
<!-- S05E08 -->| 7.01
<!-- S05E09 -->| 7.14
<!-- S05E10 -->| 8.11
<!-- S05_AV -->| 6.88
|-
<!-- S06E01 -->| 7.94
<!-- S06E02 -->| 7.29
<!-- S06E03 -->| 7.28
<!-- S06E04 -->| 7.82
<!-- S06E05 -->| 7.89
<!-- S06E06 -->| 6.71
<!-- S06E07 -->| 7.80
<!-- S06E08 -->| 7.60
<!-- S06E09 -->| 7.66
<!-- S06E10 -->| 8.89
<!-- S06_AV -->| 7.69
|-
<!-- S07E01 -->| 10.11
<!-- S07E02 -->| 9.27
<!-- S07E03 -->| 9.25
<!-- S07E04 -->| 10.17
<!-- S07E05 -->| 10.72
<!-- S07E06 -->| 10.24
<!-- S07E07 -->| 12.07
<!-- S07_AV -->| 10.26 
|-
<!-- S08E01 -->| 11.76
<!-- S08E02 -->| 10.29
<!-- S08E03 -->| 12.02
<!-- S08E04 -->| 11.80
<!-- S08E05 -->| 12.48
<!-- S08E06 -->| 13.61
<!-- S08_AV -->| 11.99
}}

Game of Thrones : U.S. viewers per episode (millions)

Season		Episode number										Average
Season		1	2	3	4	5	6	7	8	9	10	Average
	1	2.22	2.20	2.44	2.45	2.58	2.44	2.40	2.72	2.66	3.04	2.52
	2	3.86	3.76	3.77	3.65	3.90	3.88	3.69	3.86	3.38	4.20	3.80
	3	4.37	4.27	4.72	4.87	5.35	5.50	4.84	5.13	5.22	5.39	4.97
	4	6.64	6.31	6.59	6.95	7.16	6.40	7.20	7.17	6.95	7.09	6.84
	5	8.00	6.81	6.71	6.82	6.56	6.24	5.40	7.01	7.14	8.11	6.88
	6	7.94	7.29	7.28	7.82	7.89	6.71	7.80	7.60	7.66	8.89	7.69
	7	10.11	9.27	9.25	10.17	10.72	10.24	12.07	–			10.26
	8	11.76	10.29	12.02	11.80	12.48	13.61	–				11.99

Audience measurement performed by Nielsen Media Research^[1]

Parameters

Parameter		Description	Type	Status
Title	title	Title of the series in plain text.	Text	Required
Season title	season_title	Alternate text instead of "Season", e.g. "Series" for British and Australian shows.	Text	Optional
No Graph	no_graph	Display the template without the pictorial graph. Set to y.	Text	Optional
No Table	no_table	Display the template without the data table. Set to y.	Text	Optional
Colors	color{1,2,...}	The background color of the bars and legend for each season in hexadecimal format (3 or 6 characters). Required for each season. Default of #006600. Format: #FFFFFF or #FFF	String	Required
Legend	legend{1,2,...}	Alternate text for season names in the graph legend and table.	Text	Optional
References	refs	The references for the ratings, in regular reference format. For more than one sources, consider bundling the citations for readability purposes. Required to verify ratings.	Reference	Required
Width	width	Width of the graph in plain number format. If no value is given, it will be set automatically to create a space of 2 pixels between the bars. Format: 800	Number	Optional
Height	height	Height of the graph in plain number format. Default is 300px. Format: 250	Number	Optional
Average	average	Determine if an average value is included as the final figure of a season by setting the parameter to anything. An average column is added to each row but not included in the graph.	Text	Optional
Country	country	The series' country of origin. Setting this parameter will display "Viewers" in the graph and table in lowercase, with the country prepended to it. Not setting the country will display "Viewers" capitalized.	Text	Optional
Viewer figures	—	Existing figures: The viewer figures for the seasons in plain number format in millions, a separate unnamed parameter for each viewer figure: `\|2.50` TBD figures: Include an empty parameter for a viewer figure, will set a place for an empty bar in the graph and a `{{N/A\|TBD}}` cell in the table: `\|` N/A figures: Set unavailable viewer figures to N/A, will set a place for an empty bar in the graph and a `{{N/A}}` cell in the table: `\|N/A` Separating seasons: Add a new parameter and set it to a hyphen (include before the first season, do not include after the last season, and make sure it is a hyphen "-" and not a dash "–"/"—"): `\|-` The template will automatically include spanning `{{N/A}}` cells when the number of episodes between seasons differs.	Number / Hyphen / Text	Required

The above documentation is transcluded from Template:Television ratings graph/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.