Nivel 18 · Tutorial

El nivel 1, línea a línea: de la fórmula de la recta a la gráfica de barras

Idea: todo 01-barras.html se apoya en una sola fórmula, la de la recta que pasa por dos puntos. Aquí se explica cada línea del código con dos miradas: el razonamiento (qué problema resuelve) y las matemáticas (por qué la cuenta es esa). Todos los números son los reales del ejemplo (Ene … Jun).
  1. El lienzo SVG: dónde está el (0, 0)
  2. Los datos
  3. La fórmula de la recta
  4. map(): la recta como función
  5. crear(): un elemento SVG
  6. El rectángulo de dibujo: x0, x1, y0, y1
  7. n, max, hueco y ancho
  8. La x de cada barra
  9. La y y la altura de cada barra
  10. El rectángulo, la etiqueta y la base
  11. Todo junto, barra a barra
PASO 0 · EL LIENZO

Antes de nada: en SVG la y crece hacia abajo

El código dibuja en un <svg viewBox="0 0 600 300">. El viewBox dice: «dentro de este SVG hay 600 unidades de ancho y 300 de alto», ocupe lo que ocupe en pantalla.

Razonamiento

En matemáticas el origen está abajo a la izquierda y la y sube. En la pantalla el origen está arriba a la izquierda y la y baja (como se lee un texto: de arriba abajo). Una barra «alta» tiene que acabar cerca del borde de arriba, es decir, con una y pequeña. Esta es la única «rareza» de todo el ejemplo y la resolveremos con la misma fórmula, sin trucos.
PASO 1 · LOS DATOS

Dos arrays emparejados por la posición

var meses = ['Ene', 'Feb', 'Mar', 'Abr', 'May', 'Jun'];
var datos = [3200, 3500, 4100, 3900, 4400, 4800];

Razonamiento

El índice i une los dos arrays: meses[2] es «Mar» y datos[2] es 4100. Por eso el bucle de dibujo recibe (v, i): con v calcula la altura y con i la posición y el texto.

Matemáticas

Cada barra es un par (i, v): una variable categórica (el mes, que solo tiene orden) y una cuantitativa (el número). Por eso la escala horizontal reparte huecos iguales (el mes no tiene «tamaño») y la vertical es proporcional al valor.
PASO 2 · LA RECTA

Una recta queda fijada por dos puntos

Queremos convertir un número de un intervalo (por ejemplo, un dato entre 0 y 4800) en un número de otro intervalo (un píxel entre 260 y 40). Si la conversión es «justa» (el doble de dato da el doble de distancia), la relación entre las dos cosas es una recta.

Matemáticas · deducción en tres pasos

1. La pendiente. Entre los puntos (x0, y0) y (x1, y1), por cada unidad que avanza x, la y avanza siempre lo mismo:
m = (y1 − y0) / (x1 − x0) «lo que sube y» / «lo que avanza x»
2. La ecuación punto-pendiente. Desde el punto (x0, y0), si avanzamos x − x0, la y avanza m veces eso:
y − y0 = m · (x − x0)
3. Despejando y:
y = y0 + (x − x0) · (y1 − y0) / (x1 − x0)
Es exactamente lo que devuelve map().

Matemáticas · la misma fórmula leída como «regla de tres»

Agrupando de otra forma aparece la fracción t, «qué parte del camino llevo» (de 0 a 1):
t = (x − x0) / (x1 − x0) 0 al principio, 1 al final, 0,5 a la mitad y = y0 + t · (y1 − y0) avanzar esa misma fracción en el otro intervalo
Es la regla de tres de toda la vida: «si 4800 es todo el recorrido, 2400 es la mitad; la mitad de 260 → 40 es 150». En gráficos a esta forma se le llama interpolación lineal (lerp).

Muévelo: arriba, la regla de los datos; abajo, la de los píxeles. La recta une cada dato con su píxel.

2400

Razonamiento · comprobar los extremos

Una fórmula así se comprueba siempre en los dos extremos. Si x = x0, el paréntesis vale 0 y sale y0. Si x = x1, la fracción vale 1 y sale y0 + (y1 − y0) = y1. Si los dos extremos están bien, todo lo de en medio también, porque es una recta.
PASO 3 · map()

La recta convertida en función

// Recta que pasa por los puntos (x0, y0) y (x1, y1): dado un x, devuelve su y.
function map(x, x0, x1, y0, y1) {
    return y0 + (x - x0) * (y1 - y0) / (x1 - x0);
}

Razonamiento

map no sabe nada de barras ni de píxeles: recibe un valor y dos intervalos (el de origen x0 → x1 y el de destino y0 → y1) y traslada el valor de uno a otro. Por eso sirve para las dos escalas del ejemplo:
horizontal: map(i, 0, n, x0, x1) índice de barra → píxel x vertical: map(v, 0, max, y0, y1) dato → píxel y

Matemáticas · tres propiedades útiles

Invertir: si el intervalo de destino va «al revés» (260 → 40), la pendiente es negativa y el resultado baja cuando x sube. Así se resuelve la y hacia abajo del paso 0, sin ningún if.
Extrapolar: si x está fuera de x0…x1, la recta sigue: map(9600, 0, 4800, 260, 40) da −180 (fuera del lienzo). Las librerías lo llaman clamp cuando lo recortan.
Cuidado con x1 = x0: dividir entre 0 da Infinity o NaN. Pasaría si todos los datos fueran 0 (max = 0).
PASO 4 · crear()

Un ayudante para no repetir código SVG

var svg = document.getElementById('grafica');
function crear(tipo, atributos) {
    var el = document.createElementNS('http://www.w3.org/2000/svg', tipo);
    for (var nombre in atributos) el.setAttribute(nombre, atributos[nombre]);
    svg.appendChild(el);
    return el;
}

Razonamiento, línea a línea

createElementNS: los elementos SVG viven en otro «espacio de nombres» distinto del HTML. Con document.createElement('rect') el navegador crearía un elemento HTML desconocido llamado rect, que no se dibuja. La URL http://www.w3.org/2000/svg no se descarga: es solo el nombre oficial del SVG.
for … in: recorre las claves del objeto. { x: 53.5, y: 113.3, fill: '#005C84' } se convierte en tres setAttribute: un atributo por clave.
appendChild: lo añade al lienzo. El orden importa: lo último que se añade se pinta encima.
return el: devuelve el elemento para poder seguir usándolo. El ejemplo lo aprovecha para escribir el texto del mes: crear('text', {…}).textContent = meses[i].

Matemáticas

Aquí no hay cuentas: crear() solo traslada al SVG los números que calculan las escalas. Toda la geometría está en map().
PASO 5 · EL RECTÁNGULO DE DIBUJO

x0, x1, y0, y1: los cuatro bordes donde caben las barras

var x0 = 40,  x1 = 580;     // horizontal: de la izquierda (x0) a la derecha (x1)
var y0 = 260, y1 = 40;      // vertical: de la base (y0) hasta arriba (y1)

Razonamiento

Las barras no se pegan a los bordes del SVG: se deja margen para los textos de los meses (abajo, 40 unidades) y aire a los lados (40 y 20). El área útil va de 40 a 580 en horizontal (540 de ancho) y de 260 a 40 en vertical (220 de alto).

Matemáticas · por qué y0 = 260 y no 40

y0 es donde va el dato 0 (la base) e y1 donde va el dato máximo (arriba). Como en pantalla «arriba» es una y pequeña, el intervalo de destino va de mayor a menor: 260 → 40. La pendiente de la escala vertical sale negativa:
m = (y1 − y0) / (max − 0) = (40 − 260) / 4800 = −220 / 4800 ≈ −0,0458 píxeles por unidad
Cada unidad de dato sube la barra 0,0458 píxeles (el signo menos significa «hacia arriba» en pantalla).
PASO 6 · n, max, hueco, ancho

Cuatro números que se calculan una sola vez

var n = datos.length;                     // número de barras (6)
var max = Math.max.apply(null, datos);    // el dato más alto (4800)
var hueco = (x1 - x0) / n;                // espacio para cada barra (90)
var ancho = hueco * 0.7;                  // la barra ocupa el 70 % de su espacio

Razonamiento

n: cuántas barras. Si añades un mes, todo se recalcula solo.
max: el techo de la escala vertical. Math.max espera números sueltos (Math.max(3200, 3500…)); .apply(null, datos) «desempaqueta» el array. Hoy se escribe Math.max(...datos).
hueco: los 540 de ancho útil repartidos en 6 partes iguales. Cada mes tiene su «carril».
ancho: la barra no llena el carril entero; el 30 % restante es la separación.

Matemáticas · con los números del ejemplo

hueco = (580 − 40) / 6 = 540 / 6 = 90 ancho = 90 · 0,7 = 63 (en JavaScript: 62.99999999999999, decimales binarios) sobra = hueco − ancho = 27 → 13,5 a cada lado para centrar la barra

Cambia el porcentaje y mira un carril por dentro:

0.7
PASO 7 · LA x DE CADA BARRA

Escala horizontal: el índice i se convierte en píxel

var x = map(i, 0, n, x0, x1) + (hueco - ancho) / 2;

Razonamiento

map(i, 0, n, x0, x1) dice dónde empieza el carril de la barra i: la recta que pasa por (0 → 40) y (6 → 580). El índice 0 empieza en 40; el 6 (que no existe, es el «final») cae en 580. Luego + (hueco − ancho) / 2 desplaza la barra al centro de su carril.

Matemáticas · la recta horizontal simplificada

map(i, 0, 6, 40, 580) = 40 + (i − 0) · (580 − 40) / (6 − 0) = 40 + i · 90 x = 40 + i · 90 + 13,5
La pendiente es exactamente el hueco (90): cada barra está 90 píxeles más a la derecha que la anterior. Es una progresión aritmética.
PASO 8 · LA y Y LA ALTURA

Escala vertical: el dato se convierte en píxel

var y = map(v, 0, max, y0, y1);      // dónde acaba arriba la barra
height: y0 - y                       // desde ahí hasta la base

Razonamiento

Un <rect> de SVG se define por su esquina de arriba a la izquierda (x, y) y su tamaño (width, height), que crece hacia abajo. Así que primero calculamos dónde está el techo de la barra (y) y después cuánto hay que bajar hasta la base (y0 − y).

Matemáticas · por qué la altura es proporcional al dato

y = 260 + (v − 0) · (40 − 260) / (4800 − 0) = 260 − v · 220/4800 height = y0 − y = 260 − (260 − v · 220/4800) = v · 220/4800
La altura queda v multiplicado por una constante (220/4800 ≈ 0,0458). Proporcionalidad pura: el doble de dato, el doble de barra. Esto solo pasa porque la escala empieza en 0. Si empezara en 3000, la barra de 3200 parecería diminuta al lado de la de 4800: la gráfica «mentiría». Por eso las barras siempre arrancan de cero.
PASO 9 · RECTÁNGULO, ETIQUETA Y BASE

Los números calculados, convertidos en SVG

crear('rect', { x: x, y: y, width: ancho, height: y0 - y, fill: '#005C84' });

crear('text', { x: x + ancho / 2, y: y0 + 22, 'text-anchor': 'middle',
                'font-size': 13, fill: '#3D5C6C' }).textContent = meses[i];

crear('line', { x1: x0, y1: y0, x2: x1, y2: y0, stroke: '#7894A3' });

Razonamiento

La etiqueta: x + ancho / 2 es el centro de la barra (empieza en x y mide ancho). Con text-anchor: middle el texto se centra en ese punto en vez de empezar en él. y0 + 22 la coloca 22 unidades por debajo de la base.
La base: una línea de (x0, y0) a (x1, y0), con la misma y en los dos extremos, así que es horizontal.
Ojo con los nombres: en { x1: x0, y1: y0, x2: x1, y2: y0 } lo de la izquierda son los atributos de la <line> de SVG (sus dos extremos) y lo de la derecha son nuestras variables. Que se llamen igual es casualidad: x1: x0 significa «el primer extremo de la línea está en nuestro x0 (40)».

Matemáticas · el centro de un segmento

El centro de un segmento que empieza en a y mide L está en a + L/2. Para la barra de enero: 53,5 + 63/2 = 85. También es el centro del carril: 40 + 90/2 = 85, porque la barra está centrada en él.
PASO 10 · TODO JUNTO

El bucle, barra a barra

Pulsa Siguiente barra: se ejecuta una vuelta del forEach y aparecen las cuentas de esa barra. Las líneas discontinuas marcan el carril (hueco) y el rectángulo de dibujo.

Pulsa «Siguiente barra».
datos.forEach(function (v, i) {
    var x = map(i, 0, n, x0, x1) + (hueco - ancho) / 2;   // paso 7
    var y = map(v, 0, max, y0, y1);                       // paso 8
    crear('rect', { x: x, y: y, width: ancho, height: y0 - y, fill: '#005C84' });          // paso 9
    crear('text', { x: x + ancho / 2, y: y0 + 22, 'text-anchor': 'middle' }).textContent = meses[i];
});
crear('line', { x1: x0, y1: y0, x2: x1, y2: y0, stroke: '#7894A3' });

Resumen matemático

una fórmula: y = y0 + (x − x0) · (y1 − y0) / (x1 − x0) dos usos: x(i) = 40 + 90·i + 13,5 pendiente +90: carriles iguales y(v) = 260 − 0,0458·v pendiente −0,0458: sube en pantalla consecuencia: height(v) = 0,0458·v altura proporcional al dato

Prueba a cambiar (en 01-barras.html)

  1. Pon y1 = 140: la barra más alta acaba más abajo y todas se «aplastan» en la misma proporción. ¿Cuánto vale ahora la pendiente?
  2. Cambia la escala vertical a map(v, 3000, max, y0, y1) y fíjate cómo exagera las diferencias (paso 8).
  3. Intercambia y0 e y1 en map(v, 0, max, y1, y0): ¿por qué las barras «cuelgan» del techo?
  4. Sustituye Math.max.apply(null, datos) por Math.max(...datos): el resultado es el mismo.