Perfil de elevación
Desnivel a lo largo de un recorrido.
Definición
El perfil de elevación dibuja la cota de un recorrido frente a la distancia acumulada desde el inicio, con las pendientes calculadas tramo a tramo. Un tramo corto y duro ocupa lo poco que ocupa y se ve empinado, y la lámina escribe su exageración vertical. Se usa para etapas ciclistas, carreras de montaña, rutas de senderismo o trazados de obra lineal.
- Datos
- x · y · label
- Buena para
- Ver dónde caen las rampas de un recorrido y cuánto aprietan.
- Evítala cuando
- Cuando quieres comparar varios recorridos en la misma tabla: cada perfil es uno solo.
- Se lee bien
- Entre 4 y 690 elementos; dibuja hasta 1400
- Datos que faltan
- Se niega a dibujar y dice qué valor falta.
- Accesibilidad
- Lector de pantalla: resumen en texto · respeta «reducir movimiento»
Forma de los datos
Qué columnas pide
| Columna | Tipo | Para qué |
|---|---|---|
x | number | La DISTANCIA ACUMULADA desde el inicio del recorrido, en kilómetros salvo que el spec declare otra unidad en `style.perfil.metrosPorUnidadX`. Estrictamente creciente: dos puntos a la misma distancia son un muro vertical y un retroceso son dos recorridos pegados, y las dos cosas se rechazan nombrando las filas. No es opcional ni se sustituye por el orden de la tabla — sin ella lo que queda es una serie ordenada, y repartir las filas a partes iguales le pondría a cada rampa una inclinación que el terreno no tiene. |
y | number | La COTA de cada punto, en metros salvo que el spec declare otra unidad en `style.perfil.metrosPorUnidadY`. De ella salen, CALCULADOS y nunca leídos de una columna, la pendiente de cada tramo y el desnivel acumulado; los dos dependen de lo denso que sea el muestreo, y por eso la lámina escribe al lado cuántos puntos hay y cuál es el paso mediano. |
label · opcional | string | El nombre del hito de esa fila —un collado, una cima, un avituallamiento— o vacío, que es lo que trae la inmensa mayoría de los puntos de muestreo. OPCIONAL de verdad: sin esta columna el perfil se dibuja igual y no rotula ninguno. Los nombres se escriben en vertical de izquierda a derecha mientras quepan; el que no cabe conserva su punto y su guía, y la nota de cabecera dice cuántos se rotularon de cuántos hay. |
Tamaños
Ancha por necesidad
Esta pieza necesita anchura para que cada rótulo quepa entero. El motor prefiere decirlo a apretarla.
A menos de 480 px el motor se niega y explica por qué: elevation-profile: quedan 384.0 px de ancho útil (480 px de lienzo menos 76 px de rótulos de cota y 20 px de margen) y la fila de la leyenda necesita 353 px par
. En el móvil se ve la versión ancha, a tamaño legible y sin recortar, dentro de un marco que se desliza.
Cuándo usarla
Tres preguntas antes de elegirla
¿El eje horizontal es distancia y no tiempo?
Si las cotas están fechadas y lo que importa es su evolución, una línea temporal lo enseña.
Sí: quédate con perfil de elevación
No: usa Gráfico de líneas¿Es un solo recorrido?
Si hay que comparar varios recorridos, unos pequeños múltiplos ponen la cota de cada uno en su panel con la misma escala, aunque sin pendientes calculadas ni exageración escrita.
Sí: quédate con perfil de elevación
No: usa Pequeños múltiplos¿Importa dónde caen las rampas y no solo el desnivel total?
Si basta con comparar el desnivel acumulado de varias rutas, unas barras horizontales lo ordenan.
Sí: quédate con perfil de elevación
No: usa Gráfico de barras horizontalesCódigo
La misma pieza, con tus datos
import { getPreset, renderComposition } from 'visx-render/node';
const spec = await getPreset('elevation-profile');
spec.data.rows = misFilas; // x, y
const { svg, warnings } = await renderComposition(spec);También en React con Chart y prepareComposition. Guía para desarrolladores →
Dudas
¿Por qué escribe la exageración vertical?
Porque los dos ejes miden longitudes con escalas distintas; sin ese factor el dibujo afirmaría inclinaciones que el terreno no tiene.
¿Puede repetirse una distancia?
No. Tiene que ser estrictamente creciente: dos puntos a la misma distancia serían un muro y un retroceso, dos recorridos pegados. Las dos cosas se rechazan nombrando las filas.
¿Calcula la pendiente?
Sí, a partir de las cotas, igual que el desnivel acumulado. Como dependen de lo denso que sea el muestreo, la lámina escribe cuántos puntos hay y el paso mediano.
¿Qué hace si faltan datos?
Se niega a dibujar y dice qué valor falta.
¿Cómo se ve en el móvil?
A menos de 480 px el motor no la compone sin pisar o cortar rótulos, y lo dice. En el móvil se ve la versión ancha, a tamaño legible, dentro de un marco que se desliza.
Relacionadas
Otras formas de responder «cómo se reparten los valores»
Código de barras de eventoscuándo ocurren los eventos en un intervalo
Beeswarmcada individuo de una distribución, sin solaparse
Diagrama de cajamediana, cuartiles y atípicos de una distribución
Gráfico de contornodónde se concentran los puntos
Gráfico de densidadforma suavizada de una distribución
Franja de puntosrespuesta individual de cada caso