ÖsterreichWiki:Lua/Modul/Graph/de: Unterschied zwischen den Versionen

* '''basemap''': Gibt an welche Basiskarte verwendet werden soll. Die Kartendefinition muss im [https://github.com/mbostock/topojson/wiki TopoJSON]-Format erfolgen, dann auf Wikipedia abgelegt werden, wo sie fortan zur Verfügung für dieses Modul steht. Karten im Standardverzeichnis [[Spezial:Präfixindex/Modul:Graph/]] wie [[Modul:Graph/WorldMap-iso2.json|WorldMap-iso2.json]] sollten nur mit ihrem Namen referenziert und der Präfix „Modul:Graph/“ der Portierbarkeit wegen weggelassen werden. Daneben werden auch URLs akzeptiert, z.B. wenn Karten von anderen Wikipedia-Sprachversionen genutzt werden sollen (die Angabe sollte hierbei als <tt>//en.wikipedia.org/w/index.php?title=''Mapname''&action=raw</tt> erfolgen, d.h. protokollrelativ ohne http/s am Anfang und mit action=raw um ausschließlich den Seiteninhalt zuzurückzugeben). URLs auf Karten von externen Websites sollten aus Gründen der Stabilität, Performanz und Sicherheit nicht genutzt werden bzw. würden von der Software oder dem Browser vermutlich geblockt werden.

* '''scale''': Skalierungsfaktor der Karte (Standard: 100)

* '''projection''': Methode der [[Kartenprojektion]]. Für mögliche Werte siehe https://github.com/mbostock/d3/wiki/Geo-Projections. Der Standardwert ist <tt>equirectangular</tt> für eine [[Rektangularprojektion]] (Plattkarte).

** '''colorScale''': zu verwendende Farbpalette. Das Format ist eine kommagetrennte Liste von Farbwerten. Die Farbwerte müssen entweder im Format <tt>#rgb</tt>/<tt>#rrggbb</tt> oder mit einem [[Webfarbe#Benannte Farben|CSS-Farbnamen]] erfolgen. Statt einer Liste können auch die eingebauten Farbpaletten [https://github.com/mbostock/d3/wiki/Ordinal-Scales#categorical-colors <tt>category10</tt> und <tt>category20</tt>] genutzt werden.

** '''scaleType''': mögliche Werte <tt>linear</tt> für eine lineare Abbildung zwischen den Datenwerten und der Farbskala, <tt>log</tt> für eine logarithmische, <tt>pow</tt> für eine exponentielle (der Exponent kann dahintergesetzt werden, z.B. <tt>pow 0.5</tt>), <tt>sqrt</tt> und <tt>quantize</tt> für eine quantisierte Skala, d.h. die Werte werden in soviele Klassen eingeteilt wie die Palette Farben hat und diese dann genutzt.

** '''domainMin''': Skalenminimum, d.h. Datenwerte unter dem Minimum werden diesem zugeordnet

** '''domainMax''': Skalenmaximum, d.h. Datenwerte über dem Maximum werden diesem zugeordnet

** '''legend''': Farblegende anzeigen (funktioniert nicht bei <tt>quantize</tt>)

* '''defaultValue''': Standardwert für unmarkierte geografische Objekte. Wenn die Datenwerte Farben sind, ist der Standandwert <tt>silver</tt>, bei Zahlen 0.

* '''formatjson''': JSON-Objekt für bessere Lesbarkeit formatieren

* '''width''': Breite des Diagramms

* '''height''': Höhe des Diagramms

* '''type''': Diagrammtyp: <tt>line</tt> für [[Liniendiagramm]]e, <tt>area</tt> für [[Flächendiagramm]]e, <tt>rect</tt> für [[Säulendiagramm]]e und <tt>pie</tt> für [[Kreisdiagramm]]e (Tortendiagramme). Mit dem Präfix <tt>stacked</tt> (z.B. <tt>stackedarea</tt>) können mehrere Serien gestapelt werden.

* '''interpolate''': [[Interpolation (Mathematik)|Interpolation]]s-Methode für Linien- und Flächendiagramme. Empfohlen ist <tt>monotone</tt> – weitere Werte lassen sich https://github.com/vega/vega/wiki/Marks#area entnehmen.

* '''colors''': Farbpalette des Diagramms als kommagetrennte Liste von Farbwerten. Farbwerte werden im Format <tt>#rgb</tt>/<tt>#rrggbb</tt>/<tt>#aarrggbb</tt> oder mit einem [[Webfarbe#Benannte Farben|CSS-Farbnamen]] angegeben. Bei <tt>#aarrggbb</tt> bezeichnet <tt>aa</tt> den [[Alphakanal]], d.h. FF=100% Deckkraft, 80=50% Deckkraft/halbdurchsichtig, usw. (Die Standardpalette ist [https://github.com/mbostock/d3/wiki/Ordinal-Scales#categorical-colors <tt>category10</tt>]).

* '''xAxisTitle''' und '''yAxisTitle''': Beschriftung der X- und Y-Achse

* '''xAxisMin''', '''xAxisMax''', '''yAxisMin''' und '''yAxisMax''': Ändert den Start- und Endwert der X- bzw. Y-Achse

* '''xAxisFormat''' und '''yAxisFormat''': Ändert die Formatierungen der Achsenbezeichnungen. Um beispielsweise Prozentzahlen auszugeben kann das Format <tt>%</tt> genutzt werden.

* '''xType''' und '''yType''': Datentypen der Werte, z.B. <tt>integer</tt> für Ganzzahlen, <tt>number</tt> für reelle Zahlen, <tt>date</tt> für Datumsangaben (z.B. im Format <tt>JJJJ/MM/TT</tt>) und <tt>string</tt> für beliebige Ordinalwerte.

* '''x''': X-Werte als kommagetrennte Liste

* '''y''' bzw. '''y1''', '''y2''', …: Y-Werte von einer bzw. mehreren Datenreihen. Bei Kreisdiagrammen gibt <tt>y2</tt> die Radien der entsprechenden Kreisstücke an.

* '''legend''': Legende anzeigen (funktioniert nur bei mehreren Datenreihen)

* '''y1Title''', '''y2Title''', …: Bezeichnung der jeweiligen Datenreihe in der Legende

* '''linewidth''': Liniendicke bei Liniendiagrammen bzw. Abstand zwischen den Kreisstücken bei Kreisdiagrammen

* '''showValues''': Gibt die Y-Werte zusätzlich als Text aus. (Wird momentan nur von (nicht gestapelten) Säulen- und Kreisdiagrammen unterstützt.) Die Ausgabe kann über folgende Parameter konfiguriert werden die angegeben werden als <tt>Name1:Wert1, Name2:Wert2</tt>:

** '''format''': Formatiert die Werteausgabe gemäß https://github.com/mbostock/d3/wiki/Formatting#numbers für Zahlen und https://github.com/mbostock/d3/wiki/Time-Formatting für Zeitangaben

** '''fontcolor''': Textfarbe

** '''fontsize''': Textgröße

** '''offset''': Verschiebt den Text gemäß dem angegebenen Offset. Bei Säulen- und Kreisdiagramme (mit <tt>midangle</tt>-Winkelwert) gibt dies auch an, ob der Text inner- oder außerhalb der Diagrammgrafiken geschrieben wird.

* '''innerRadius''': Innerer Radius um aus einem Kreisdiagramm ein ''Ringdiagramm'' zu erzeugen.

* '''formatjson''': JSON-Objekt für bessere Lesbarkeit formatieren

Die Funktionen <tt>mapWrapper</tt> und <tt>chartWrapper</tt>, dienen lediglich dazu alle Parameter einer aufrufenden Vorlage an die entsprechenden Funktionen <tt>map</tt> und <tt>chart</tt> durchzureichen, so dass die Vorlage selbst keine Parameterzuordnung vornehmen muss.