es M%C3%B3dulo:Diagrama

Uso

Cómo trazar un diagrama de barras: la plantilla "bar chart"

Parámetros

Nombre del parámetro	Explicación
delimiter	Signo que sirve para separar diversos valores. Por defecto, se utilizan los dos puntos (:). No se suele cambiar, a menos que se desee utilizar los dos puntos como parte del valor de un parámetro.
width	Anchura del diagrama. Valor numérico opcional. Debe valer como mínimo 200. El valor por defecto es 500.
height	Altura del diagrama. Valor numérico opcional. Debe valer como mínimo 200. El valor por defecto es 350.
ancho escala	Ancho de la escala (o de cada una de ellas, si hay más de una), en píxeles. El valor por omisión es 100 si hay una sola, 80 si hay varias.
alto leyendas	Alto en píxeles del espacio inferior, donde aparecen los valores del eje X. El valor por omisión es 80.
group n	«n» es un valor numérico. Se utiliza para nombrar los distintos tipos de datos del gráfico: «group 1», «group 2», etc., tantos tipos de datos como contenga el diagrama. Se le asignan tantos valores como posiciones en el eje X se deseen mostrar. Cada conjunto de columnas reunidas en en torno a un valor del eje X utiliza un dato de cada grupo definido.
tooltip n	Valor asociado a cada barra del diagrama, que aparece cuando se coloca el ratón sobre el extremo de una barra. Si no se asigna un valor pero la barra tiene un enlace, se mostrará el enlace. Si se le asigna un valor, lo que se muestre será la combinación del nombre del grupo, el valor de este parámetro y, si se definen también, los valores de los parámetros «units prefix» y »units suffix».
links n	Enlaces a artículos de la Wikipedia. Se asocian a cada barra de un grupo, el que tenga el mismo número.
stack	Parámetro utilizado para solapar las barras de cada posición del eje X en vez de mostrarlas yuxtapuestas. Si se desea mostrarlas yuxtapuestas, no debe usarse este parámetro. Cualquier valor asignado al parámetro lo activa (mostrando las barras solapadas en cada posición del eje X para la que haya datos). Para desactivarlo y mostrar así las barras yuxtapuestas, bien no debe incluirse el parámetro o bien, si está presente en el código del diagrama, no se le ha de asignar ningún valor.
tooltip value accumulation	Se utiliza únicamente junto con el parámetro stack: cuando se le da el valor true, tooltip muestra el valor acumulado por la suma de todas las barras solapadas en una posición determinada del diagrama.
colors	Colores utilizados para distinguir cada grupo del diagrama. Debe haber tantos colores como grupos. Se pueden definir utilizando los nombres reglados en la normativa de HMTL, o bien utilizar la notación #xxx o #xxxxxx.
x legends	Valores para el eje X del diagrama. Se puede utilizar código wikipédico, como enlaces internos o plantillas.
hide group legends	Si se activa, la leyenda no aparece bajo el diagrama. Cualquier valor que se le asigne al parámetro lo activa. Para desactivarlo, bien se omite el parámetro o, si se incluye, no ha de dársele ningún valor.
scale per group	Se utiliza para emplear escalas diferentes en el eje Y para los distintos grupos del diagrama. Si no se le da valor alguno, se utiliza la misma escala para todos los grupos. No se puede utilizar con el parámetro «stack». Adviértase que, cuando se activa, cada escala se mostrará por separado, incluso si es igual a otras del diagrama. Cualquier valor que se le asigne activa el parámetro. Para desactivarlo, bien se omite el parámetro o, si se incluye, no ha de dársele ningún valor.
units prefix	Prefijo que se utiliza junto con los valores definidos en el parámetro tooltip. Por ejemplo, si se fija el valor del parámetro a «$», en el extremo de la barra se mostraría «$500» en vez de simplemente «500».
units suffix	Lo mismo que el parámetro anterior, solo que en vez de ser un prefijo es un sufijo al valor de tooltip. Por ejemplo, si se fija el valor del parámetro a «Kg», el valor de la barra mostrará 88Kg en vez de simplemente 88. Si se desea colocar un espacio entre el valor de la columna que proviene de tooltip y la unidad que lo sigue, se ha de utilizar un guion bajo (_) en el código del diagrama.
group names	Nombres de los distintos grupos del diagrama.

Ejemplos

Diagramas sencillos

En el siguiente diagrama se muestran las poblaciones de 3 tipos de rana (3 grupos: group 1, etc.) en 4 países (4 valores del eje X). Al haber 4 valores en el eje X, cada grupo tiene 4 valores (4 barras, una en cada valor del eje X, todas con el mismo color).

Para cada grupo se definen enlaces («links»): el grupo 1 (Rana verde) tiene enlaces al artículo Rana verde en sus 4 barras; el grupo 2 (rana roja) tiene enlaces al artículo correspondiente de la Wikipedia solo en las dos primeras barras, el grupo 3 (rana arbórea), solo en la barra 1 y la 3.

El grupo 2 tiene etiquetas («tooltip») en cada una de sus 4 barras: al colocar el ratón sobre la barra, aparece el texto de la etiqueta. Los enlaces definidos siguen funcionando para este grupo como si no hubiese etiquetas definidas.

En las barras para las que no se define un enlace o una etiqueta, al colocar en el extremo de ella el ratón aparece el nombre del grupo segurido de dos puntos y el valor de la columna (Rana arbórea: 14).

Cada tipo de datos (grupo) tiene un color asignado («colors», en este caso usando nombres regulados por la normativa de HTML) y un nombre («group_names»). Las posiciones del eje X en torno a las que se reunen las barras se definen al final del código del diagrama («x legends»).


{{ #invoke:Diagrama | bar chart
| group 1 = 40 : 50 : 60 : 20
| group 2 = 20 : 60 : 12 : 44
| group 3 = 55 : 14 : 33 : 5
| links 1 = Rana verde : Rana verde : Rana verde : Rana verde
| links 2 = Rana roja : Rana roja 
| links 3 = Rana arbórea : : Rana arbórea
| tooltip 2 = etiqueta 1 : etiqueta 2 : etiqueta 3 : etiqueta 4
| colors = green : yellow : orange
| group names = Rana verde : Rana roja : Rana arbórea
| x legends = Senegal : Vietnam : Paraguay : Luxemburgo
}}

10

20

30

40

50

60

Senegal

Vietnam

Paraguay

Luxemburgo

Rana verde
Rana roja
Rana arbórea

Diagramas con barras solapadas

A continuación, se muestra un ejemplo de diagrama con barras solapadas. Se utilizan también parámetros para fijar la altura («height») y la anchura («width») del diagrama y los parámetros «stack» (para apilar las barras) y «units suffix» (para indicar una unidad junto a los valores). Aquí las barras se muestran solapas en vez de yuxtapuestas como en el ejemplo anterior.

El gráfico muestra el consumo anual por persona de 3 tipos de fruta (3 grupos) en 4 países (4 valores del eje X). Como los valores se miden en kilogramos, se ha añadido el parámetro «units suffix» para que aparezca esta unidad junto a cada valor.

{{ #invoke:Diagrama | bar chart
| height = 250
| width = 400
| stack = 1
| group 1 = 40 : 50 : 60 : 20
| group 2 = 20 : 60 : 12 : 44
| group 3 = 55 : 14 : 33 : 5
| colors = green : yellow : orange
| group names = Manzanas : Plátanos : Naranjas
| units suffix = Kg
| x legends = Senegal : Vietnam : Paraguay : Luxemburgo
}}

25

50

75

100

125

150

Senegal

Vietnam

Paraguay

Luxemburgo

Manzanas
Plátanos
Naranjas

Escalas específicas para cada grupo

Se pueden utilizar distintas escalas y unidades para los diferentes grupos de barras que componen el diagrama:

{{ #invoke:Diagrama | bar chart
| width = 800
| group 1 = 1500000 : 2500000 : 3500000
| group 2 = 200 : 5000 : 45000
| group 3 = 2000 : 5000 : 20000
| colors = red : blue : green
| group names = Personas : Automóviles : Precio medio del automóvil
| x legends = 1920 : 1965 : 2002
| tooltip 2 = : No existen datos fiables del número de automóviles en 1965. Se utiliza el valor aproximado de 5 000.
| units prefix = : : $
| scale per group = 1
}}

Obsérvese el dato "units prefix": como no necesitamos un prefijo en los dos primeros grupos, utilizamos los dos puntos sin valores entre ellos. También se podría haber usado la notación "::$" en vez de " : : $", con el mismo resultado.

Apréciese también el valor especial que tiene tooltip para la barra de «Automóviles» en la posición de 1965 en el eje X.

1 000 000

2 000 000

3 000 000

4 000 000

10 000

20 000

30 000

40 000

50 000

5000

10 000

15 000

20 000

1920

1965

2002

Personas
Automóviles
Precio medio del automóvil

{{ #invoke:Diagrama | bar chart
| width = 800
| group 1 = 1500000 : 2500000 : 3500000
| group 2 = 200 : 5000 : 45000
| group 3 = 2000 : 5000 : 20000
| colors = red : blue : green
| group names = Personas : Automóviles : Precio medio del automóvil
| x legends = 1920 : 1965 : 2002
| tooltip 2 = : No existen datos fiables del número de automóviles en 1965. Se utiliza el valor aproximado de 5 000.
| units prefix = : : $
| scale per group = 1
}}

Obsérvese el dato "units prefix": como no necesitamos un prefijo en los dos primeros grupos, utilizamos los dos puntos sin valores entre ellos. También se podría haber usado la notación "::$" en vez de " : : $", con el mismo resultado.

Apréciese también el valor especial que tiene tooltip para la barra de «Automóviles» en la posición de 1965 en el eje X. De esta manera se pueden poner comentarios en las barras.

A continuación se muestra un ejemplo de diagrama con gran cantidad de grupos (para ilustrar cómo se comporta la plantilla cuando la leyenda tiene muchos elementos, distribuyéndolos en varias columnas):

25

50

75

100

125

150

1920

1930

1940

1950

1960

1970

1990

2000

2010

Alabama
Alaska
Arizona
Arkansas
California
Colorado
Connecticut
Delaware
Florida
Georgia
Hawaii
Idaho
Illinois
Indiana
Iowa
Kansas
Kentucky
Louisiana
Maine
Maryland
Massachusetts

Si hay muchos valores, los datos del eje X se pueden separar utilizando una serie de de separadores (:) sin valores entre ellos. De esta manera, solo se muestran algunos valores del eje para no saturarlo:

{{ #invoke:Diagrama | bar chart
| group 1 = 1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23:24:25:26:27:28:29:30
:31:32:33:34:35:36:37:38:39:40:41:42:43:44:45:46:47:48:49:50:51:52:53:54:55:56:57:58:59
| units suffix = _Things
| group names = Some
| x legends = ::::1940::::::::::1950::::::::::1960::::::::::1970::::::::::1980::::::::::1990::::
}}

10

20

30

40

50

60