Help:Chart

De Chart-extensie biedt basisfuncties voor interactieve datavisualisatie die zijn ontworpen om sommige, maar niet alle, aspecten van de Graph-extensie te vervangen. Deze extensie is momenteel in ontwikkeling voor Wikimedia-wiki's. Zie Extension:Chart/Project voor meer informatie over het ontwikkelingsproces.

Deze extensie ondersteunt de volgende grafiektypen:

• Lijndiagram
• Staafdiagram
• Vlakdiagram
• Cirkeldiagram

Om een grafiek te renderen, moet u een grafiekdefinitie definiëren die u koppelt aan de gegevensbron die u wilt renderen. Een grafiekdefinitie is gestructureerd als een relatief eenvoudig JSON-bestand; zie Extension:Chart/Specification voor meer informatie over de syntaxis.

Alle grafieken in dit voorbeeld kunnen worden gerenderd vanuit dezelfde gegevensbron: Data:Chart_Example_Data.tab, een fictieve dataset. Voorbeeldinhoud voor deze pagina's is te vinden in de voorbeeldmap.

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "subtitle": {
        "en": "Example Subtitle"
    },"xAxis": {
        "title": {
        	"en": "Example X Axis Title"
        },
        "format": "none"
    },
    "yAxis": {
        "title": {
            "en": "Example Y Axis Title"
        },
        "format": "none"
    },
    "mediawikiCategories": [
        {
            "name": "Example category",
            "sort": "Its sortkey"
        }
    ],
    "transform": {
        "module": "Optional lua module for data transforms",
        "function": "transform_func",
        "args": {
            "arg_name": "arg_value"
        }
    }
}

Zodra een grafiek is gedefinieerd, kunt u deze eenvoudig weergeven met de parserfunctie #chart. In dit geval worden de grafiekgegevens gedefinieerd in Data:Chart_Example_Data.tab en de grafiek zelf in Data:Example.Line.chart.

{{#chart:Example.Line.chart}}

Houd er rekening mee dat een grafiek generiek kan zijn en opnieuw kan worden gebruikt met verschillende gegevensbronnen, zoals hier:

{{#chart:Population through years.chart
|data=Population of USA.tab
}}

{{#chart:Population through years.chart
|data=Population of UK.tab
}}

{{#chart:Population through years.chart
|data=Population of Poland.tab
}}

Voor alle grafieken geldt dat de gegevens in kolommen moeten worden gerangschikt, waarbij de eerste kolom de x-as vertegenwoordigt en de volgende kolommen reeksen op de y-as vertegenwoordigen.

Grootte

Momenteel nemen diagrammen de volledige breedte in beslag van de container waarin u ze plaatst.

Internationalisatie

Grafieken kunnen alleen worden ingesloten in de taal van de wiki-inhoud; de queryreeks "uselang" (bijv. ?uselang=es) heeft dus geen invloed op de grafiek.

De grafiekindeling ondersteunt het definiëren van tekst zoals titels en labels in verschillende talen, zodat dezelfde grafiek kan worden gebruikt in wiki's met verschillende talen. Zie dit voorbeeld van een grafiek met ondersteuning voor meerdere talen die wordt weergegeven in een Spaanstalige wiki.

Types

Voor alle grafieken geldt dat de gegevens in kolommen moeten worden gerangschikt, waarbij de eerste kolom de x-as vertegenwoordigt en de volgende kolommen reeksen op de y-as vertegenwoordigen.

Lijn

• (gebruikte data)

Staaf

• (gebruikte data)

Vlak

• (gebruikte data)

Cirkel

Cirkeldiagrammen zijn een speciaal type diagram en gegevensbronnen moeten mogelijk worden aangepast om correct te worden weergegeven.

Bij het lezen van gegevens worden alle kolommen die geen getallen bevatten (bijvoorbeeld de x-as) weggelaten en wordt de som van alle rijen in het diagram weergegeven.

Als meerdere rijen bijvoorbeeld waarden voor A, B en C op verschillende datums weergeven, bijvoorbeeld 1 en 2 januari, geeft het cirkeldiagramsegment voor A de som weer van alle rijwaarden van A voor die datums.

• (gebruikte data)

Opmerkingen

• Afdrukken kan op dit moment alleen dmv. de link "afdrukversie" in het menu "afdrukken/exporteren". Afdrukken via de browser en downloaden als PDF werkt (nog?) niet.
• Firefox (versie 136) onder Android 11 toont de charts alleen wanneer de browser wordt omgeschakeld naar "Desktopwebsite"-modus.

Links

• Extension:Chart/Project/FAQ (MediaWiki)
• Extension:Chart/Transforms (MediaWiki)

Bronnen

• MediaWiki:Chart extension (MediaWiki)