Mall:Graph:Lines

Dokumentation

Denna mall använder sig av Modul:Graph och Extension:Graphs, som inaktiverades den 18 april 2023 på grund av tekniska problem. De erbjöd datavisualisering och baserades på en äldre version av biblioteket Vega 2 som renderar diagrammen i webbläsaren, baserat på javascript-kod. Versionen var föråldrad och svår att uppgradera, och Graph hade säkerhetsbrister relaterade till möjlig cross-site scripting (XSS).

Alternativ till Graph

Extension:Chart

Som ersättning för Graph initierade Wikimedia Foundation under sommaren 2024 utvecklingen av ett nytt diagramtillägg, vilket dokumenteras på Extension:Chart och Extension:Chart/Project. En första försöksversion aktiverades den 5 december 2024 på tre språkversioner av Wikipedia, däribland den svenskspråkiga.

Diagrammen kräver två komponenter: (1) Rådata som konverterats från exempelvis CSV-format och lagrats som en .tab-fil. (2) En diagramdefinition i form av en .chart-fil. Båda filtyperna är JSON-baserade och lagras i namnrymden Data: på Wikimedia Commons.

För användningsexempel, se:

Kategori:Sidor på som använder diagramtillägget på svenskspråkiga Wikipedia.
Tillgängliga .tab-filer på commons.
Tillgängliga .chart-filer på Commons.

Det nya tillägget använder Apache ECharts som grafikmotor, men har ett eget förenklat JSON-baserat format för diagramdefinition. Diagrammen renderas som SVG-bilder på serversidan, vilket tillåter interaktiva tooltips, men undviker de säkerhetsproblem som förknippas med klientbaserad rendering.

Äldre alternativ

Äldre alternativ till Graph är istället:

{{#invoke:Chart}} (Lua-modul)
{{Stolpdiagram}}
{{Stapeldiagram}}
{{Stapeldiagram2}}
{{Cirkeldiagram}}

Dessa genererar enklare statiska diagram på serversidan, som enbart bygger på wikitext och HTML/CSS och saknar interaktivitet. De använder inte JavaScript eller grafikmotorer.

English documentation

This graph's main version resides at Template:Graph:Lines. Please make or suggest all the changes there, and copy it everywhere else (until the copying is automated)

This graph draws one or more independent numeric data series as lines. The data must be stored on Commons' Data namespace or come from Wikidata Query Service.

Gender pay gap

{{Graph:Lines
| table=bls.gov/US Women's weekly earnings as a percent of men's by age, annual averages.tab
| type=year | xField=year
| series="age_16_24", "age_25_34", "age_35_44", "age_45_54"
| title=Gender pay gap in the United States
| yZero=false | xAxis=Year | yAxis=Percentage | yMax=100 | yGrid=y | width=500 | legend=Age group
| vAnnotationsValues={"text": "Fictitious event", "x": 1990}
}}

Se eller redigera rådata.

Paintings per decades

{{Graph:Lines
| tabletype=query | table=SELECT ?decade (COUNT(?decade) AS ?count) WHERE {
  ?item wdt:P31 wd:Q3305213 .
  ?item wdt:P571 ?inception .
  BIND( year(?inception) as ?year ). 
  BIND( ROUND(?year/10)*10 as ?decade ) .
  FILTER( ?year > 1400)
  FILTER( ?year <= year(now()))
} GROUP BY ?decade ORDER BY ?decade
| series="count" | type=year | xField=decade
|yAxisFormat=s
| yZero=false  | width=550
| title=Paintings by decade
| hAnnotationsValues={"text": "Fictitious value", "y": 20000}
}}

Sökfråga på wikidata efter rådata.

Population in countries bordering the Baltic Sea

Wikidata query produces three columns - year, population size, and country name. This graph shows one line per country.

{{Graph:Lines
| tabletype=query | table=
#Population of countries sharing a border with the Baltic Sea
SELECT ?year ?population ?countryLabel WHERE {
  {
    SELECT ?country ?year (AVG(?populations) AS ?population) WHERE {
      {
        SELECT ?country (YEAR(?date) AS ?year) ?populations WHERE {
          ?country  wdt:P31 wd:Q63791824.
          ?country p:P1082 ?populationStatement.
          ?populationStatement ps:P1082 ?populations.
          ?populationStatement pq:P585 ?date.
        }  
      } FILTER( ?year >= 1950)
    }
    GROUP BY ?country ?year
  }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "en". }
}
| type=year | xField=year | group=countryLabel | value=population
| colorscheme=category20
| yScale=log
| legend=- | xGrid=y | yGrid=y | yTicks=7| width=600
| colorscheme=category20
|yAxisFormat=.1s
}}

Sökfråga på wikidata efter rådata.

This graph draws one or more independent numeric data series as lines. The data must be stored on Commons' Data namespace or come from Wikidata Query Service.

Mallparametrar[Redigera TemplateData]
Parameter		Beskrivning	Typ	Status
Table type	`tabletype`	Specifies the type of the table data. "tab" (default) uses data namespace on commons, without the data: prefix. "query" sends request to wikidata query service. Standard tab	Sträng	valfri
Table	`table`	Data page name on Commons, without the Data: prefix. The table should contain xField column, like year or date, and one or more series columns to plot. If tabletype parameter is set to "query", this value is the query.	Sträng	obligatorisk
X axis type	`type`	Type of the x axis - time (e.g. "2015-10" or "2013-03-08"), year (integer, but treated as a year), linear (numbers), ordinal (anything). Standard year	Sträng	föreslagen
X field	`xField`	Id of the data column that contains values for the X axis. If type=year, xField is also "year" by default.	Sträng	obligatorisk
Series	`series`	If each line is represented by a separate column of data (or if there is only one column), list of the data columns to show as lines. Must be in quotes, and listed by field IDs if coming from a .tab page: "field1", "field2", "field3".	Sträng	valfri
Group	`group`	If line color depends on just one column, specify that column's ID, instead of the series parameter.	Sträng	valfri
Value	`value`	If line color depends on one column, this parameter should be set to the column which has the values.	Sträng	valfri
Filter	`filter`	Optionally filter data with an template expression parameter e.g. `filter = datum.some_dataset_field > 1900 && datum.some_dataset_field < 2000` where `some_dataset_field` means some valid field of displayed dataset	Sträng	valfri
X axis starts at 0	`xAxisZero, xZero`	Force to start or not to start X axis with zero. Can be either true or false.	Sträng	valfri
Y axis zero starts at 0	`yAxisZero, yZero`	Force to start or not to start Y axis with zero. Can be either true or false.	Sträng	valfri
X axis scale clamp	`xAxisClamp`	Épingle sur l'échelle de l'axe X. Les courbes au delà de cette épingle seront cachées.	Boolesk	valfri
Y axis scale clamp	`yAxisClamp`	Épingle sur l'échelle de l'axe Y. Les courbes au delà de cette épingle seront cachées.	Boolesk	valfri
X axis minimum	`xAxisMin, xMin`	Force X axis to start from this value.	Nummer	valfri
X axis maximum	`xAxisMax, xMax`	Force X axis to end with this value.	Nummer	valfri
Y axis minimum	`yAxisMin, yMin`	Force Y axis to start from this value.	Nummer	valfri
Y axis maximum	`yAxisMax, yMax`	Force Y axis to end with this value.	Nummer	valfri
Y axis scale	`yScale`	Set Y axis scaling type - linear, log and sqrt. Standard linear	Sträng	valfri
Replace zero values	`replaceZerosWith`	Replaces 0 values in Y data field. Recommended to be use alongside with yScale=log (else zeros will be filtered out).	Nummer	valfri
Title	`title`	Title of the whole graph.	Sträng	valfri
Title horizontal alignment	`titleXAlign`	Horizontal alignment of title, could be one of: left, center, right	Sträng	valfri
Title horizontal offset	`titleXOffset`	Horizontal offset of title position, could be negative, to shift title to the left, or positive to shift title to the right	Nummer	valfri
X axis title	`xAxisTitle`	Title of the X axis.	Sträng	valfri
Y axis title	`yAxisTitle`	Title of the Y axis.	Sträng	valfri
X axis format	`xAxisFormat`	Changes the formatting of the X axis labels Standard %b %y (for dates)	Sträng	valfri
Y axis format	`yAxisFormat`	Changes the formatting of the Y axis labels Standard ,d (for numbers)	Sträng	valfri
X axis labels angle	`xAxisAngle`	Rotates the x axis labels by the specified angle. Recommended values are: -45, +45, -90, +90.	Nummer	valfri
Y axis labels angle	`yAxisAngle`	Rotates the y axis labels by the specified angle.	Nummer	valfri
X axis labels font size	`xAxisFontSize`	ingen beskrivning	Nummer	valfri
Y axis labels font size	`yAxisFontSize`	ingen beskrivning	Nummer	valfri
X axis grid	`xGrid`	Show grid lines for X axis.	Boolesk	valfri
Y axis grid	`yGrid`	Show grid lines for Y axis.	Boolesk	valfri
X axis ticks	`xTicks, xAxisTicks`	How many ticks to show on X axis. 7 by default. '-' value makes it automatic. Standard 7	Nummer	valfri
Y axis ticks	`yTicks, yAxisTicks`	How many ticks to show on Y axis. Auto '-' by default. Standard -	Nummer	valfri
Raw vertical annotation values	`vAnnotationsValues`	Supply all annotation values as a list of JSON objects: {"text": "Big event", "x": 1980}, ...	Sträng	valfri
Raw horizontal annotation values	`hAnnotationsValues`	Supply all horizontal annotation values as a list of JSON objects: {"text":"Big event", "y": 980}, ...	Sträng	valfri
Vertical annotation table	`vAnnotationsTable`	Data page name on Commons, without the Data: prefix. The table must contain "x" column, and optional "text" and "color" columns.	Sträng	valfri
Horizontal annotation table	`hAnnotationsTable`	Data page name on Commons, without the Data: prefix. The table must contain "y" column, and optional "text" and "color" columns.	Sträng	valfri
Vertical annotation data transforms	`vAnnotationsTransforms`	ingen beskrivning	Sträng	valfri
Horizontal annotation data transforms	`hAnnotationsTransforms`	ingen beskrivning	Sträng	valfri
Legend	`legend`	Title of the legend. "-" shows the legend without title.	Sträng	valfri
Width	`width`	ingen beskrivning	Nummer	valfri
Height	`height`	ingen beskrivning	Nummer	valfri
Chart sizing mode	`chartSizing`	Chart sizing mode, could be one of: fit, pad. Use `fit` to force resulting chart canvas sizes to be exactly equal to provided width and height values. Use `pad` to define prefered plotting size with provided width and height values, and let Vega increase overall chart size to include legend and title (if any) Standard fit	Sträng	valfri
Colors	`colors`	The colors of the lines, specified as a list like red, green. It has priority over colorscheme	Sträng	valfri
Color scheme	`colorscheme`	The colors of the lines, specified as Vega defined rangeliteral. Standard category10	Sträng	valfri
Line width	`linewidth`	Line width for line charts or distance between the pie segments for pie charts. Standard 2.5	Nummer	valfri
Debug	`debug`	Debug output: if set, will show graph as raw JSON.	Sträng	valfri

Redigera parameteröversättningar

Ovanstående dokumentation transkluderas från sidan ”Mall:Graph:Lines/dok”. Kategorier ska placeras på den dokumentationssidan.