Vés al contingut

Mòdul:Graph/ús

Afegeix enllaços
De la Viquipèdia, l'enciclopèdia lliure

Mòdul amb funcions auxiliars per a l'extensió Graph. De de:Modul:Graph.

Funcions per a plantilles

map

Crea un objecte JSON perquè <graph> mostri un mapa polític amb colors ressaltats. A l'espai de noms de l'article s'hauria d'utilitzar la plantilla {{Graph:Map}}. Consulteu la seva pàgina per veure casos d'ús.

Els mapes es poden trobar a Special:Prefixindex/Template:Graph:Map/Inner/ (per exemple Worldmap2c-json amb fronteres de país) i els mapes nous també s'han de desar al Module:Graph/.

Paràmetres:

  • basemap: estableix el mapa base. Les definicions del mapa han de seguir el format TopoJSON i, si estan desades a la Viquipèdia, estan disponibles per a aquest mòdul. Els mapes al directori per defecte Special:Prefixindex/Template:Graph:Map/Inner/ com Worldmap2c-json només s'ha de fer referència amb el seu nom mentre s'omet el prefix del Modul:Graph/ per permetre una millor portabilitat. El paràmetre també accepta URL, p. Ex. mapes d'altres versions de Viquipèdia (l'enllaç hauria de seguir l'esquema de //en.wikipedia.org/w/index.php?title=mapname&action=raw, és a dir, relatiu al protocol sense dirigir http/s i una action=raw final a buscar només el contingut en brut).S'han d'evitar les adreces URL de mapes de llocs externs per motius d'estabilitat, rendiment i seguretat de l'enllaç, i el programari o el navegador haurien de bloquejar-la de totes maneres.
  • scale: el factor d'escala del mapa (per defecte: 100)
  • projection: la projecció del mapa a utilitzar. El valor per defecte és equirectangular per a una projecció equirectangular. Algun altre tipus, i escrit en minúscules, potser funcioni (vegeu aquí), com el desaconsellable mercator.
  • center: centre del mapa (correspon a les dades del mapa als dos valors separats per comes del camp d'scale)
  • feature: quins objectes geogràfics s'han de mostrar (correspon a les dades del mapa al nom del camp situat sota el camp d'objects). El valor per defecte és el valor countries.
  • ids of geographic entities: els noms dels paràmetres reals depenen del mapa base i de la característica seleccionada. Per exemple, per al mapa del món esmentat anteriorment, els identificadors són codis de país ISO. Els valors poden ser colors o nombres en cas que les entitats geogràfiques s'hagin d'associar a dades numèriques: DE=lightblue marca Alemanya en color blau clar i DE=80.6 assigna a Alemanya el valor 80,6 (població en milions). En aquest últim cas, el color real depèn dels paràmetres següents.
  • colorScale: la paleta de colors que s'utilitzarà per a l'escala de colors. La paleta s'ha de proporcionar com una llista de valors de color separats per comes. Els valors de color s'han de donar com a #rgb/#rrggbb o bé amb un nom de color CSS. En lloc d'una llista, també es poden utilitzar les paletes de colors integrades category10 i category20.
  • scaleType: els valors admesos són linear per a una agrupació de valors ("mapatge") amb una diferència entre els marges de cada grup iguals, log per a un escala logarítmica, pow per a un mapatge de potència (l'exponent es pot proporcionar com a pow 0.5), sqrt per a un mapatge d'arrel quadrada i quantize per a un mapatge quantificada, és a dir, les dades s'agrupen en tantes classes com nombre de colors que té la paleta de colors.
  • domainMin: límit inferior dels valors de les dades, és a dir, valors de dades més petits s'assignen al límit inferior
  • domainMax: límit superior dels valors de les dades, és a dir, valors de dades més grans s'assignen al límit superior
  • legend: mostra la llegenda de colors (no funciona amb quantize)
  • defaultValue: valor per defecte per a les entitats geogràfiques no utilitzades. En cas que els valors de l'identificador siguin de colors, el valor per defecte és la plata, en el cas dels números és 0.
  • formatjson: format de l'objecte JSON per a una millor llegibilitat

chart

Crea un objecte JSON per a <graph> per mostrar diagrames. A l'espai de noms de l'article s'hauria d'utilitzar la plantilla Template:Graph:Chart. Consulteu la seva pàgina per a casos d'ús.

Paràmetres:

  • width: amplada del diagrama
  • height: alçada del diagrama
  • type: tipus de diagrama: line per diagrama de punts i línies, area per diagrama d'àrees, rect per a diagrama de barres verticals, i pie per diagrama de sectors. Les sèries múltiples es poden apilar amb el prefix stacked per exemple stackedarea.
  • interpolate: mètode d'interpolació per a diagrames de línies i àrees. Es recomana fer servir monotone per a la interpolació cúbica monòtona.
  • colors: paleta de colors del diagrama com a llista de colors separada per comes. Els valors de color han de ser donats com #rgb/#rrggbb/#aarrggbb o per un color web. Per #aarrggbb el component aa denota el canal alfa, per exemple FF=100% opacitat, 80=50% opacitat/transparència, etc. (La paleta de colors predeterminada si n <= 10 és Category10:                                         sinó és Category20:                                                                                ).
  • xAxisTitle i yAxisTitle: subtítols dels eixos x i y
  • xAxisMin, xAxisMax, yAxisMin, i yAxisMax: valors mínims i màxims dels eixos x i y (encara no s'admeten per a la barra gràfics). Aquests paràmetres es poden utilitzar per invertir l'escala d'un eix numèric establint el valor més baix a Max i el valor més alt a Min.
  • xAxisFormat i yAxisFormat: canvia la formatació de les etiquetes de l'eix. Els valors admesos es troben a https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#numbers per a números ihttps://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md per a la data/hora. Per exemple, el format % es pot utilitzar per produir percentatges.
  • xAxisAngle: gira les etiquetes de l'eix x per l'angle especificat. Els valors recomanats són: -45, +45, -90, +90
  • xType i yType: Tipus de dades dels valors, p. ex. integer pels números enters, number per a números reals, date per a dates (e.g. YYYY/MM/DD), i string per a valors ordinals (utilitzeu string per evitar que es repeteixin valors d'eix quan només hi ha uns quants valors).
  • x: els valors x com a llista separada per comes
  • y o y1, y2, …: els valors y d'una o diverses sèries de dades, respectivament. Per a diagrames de sectors y2 indiquen els radis dels sectors corresponents.
  • legend: mostra la llegenda (només funciona en cas de diverses sèries de dades)
  • y1Title, y2Title, …: defineix l'etiqueta de les sèries de dades respectives a la llegenda
  • linewidth: amplada de línia per a gràfics de línia o distància entre els sectors dels diagrames de sectors
  • showValues: A més, mostra els valors y com a text. (Actualment, només s'admeten pels gràfics de barres i de sectors (no pels apilats). La sortida es pot configurar utilitzant els paràmetres següents proporcionats com a name1:value1, name2:value2:
  • showSymbols: Per a diagrames de línies: mostra un símbol (cercle) a cada punt de dades. (ús: showSymbols=true)
  • innerRadius: Per a diagrames de sectors: defineix el radi interior per crear un diagrama donut.
  • formatjson: format JSON object for better legibility

Empaquetadors de plantilles

Les funcions mapWrapper i chartWrapper són embolcalls per passar tots els paràmetres de la plantilla de crides a les respectivess funcions map i chart.

Nota: En la vista prèvia de l'editor, l'extensió del gràfic crea un element canvas amb gràfics vectorials. Tanmateix, en desar la pàgina es genera un gràfic ràster PNG. {{#invoke:Graph


Obtingut de «https://ca.wikipedia.org/w/index.php?title=Mòdul:Graph/ús&oldid=26780205»