Cascada oncológica

Respuesta de cada paciente al tratamiento.

Definición

La cascada oncológica dibuja una barra por paciente con el cambio del tumor desde su propia basal, con el cero y los umbrales del criterio de respuesta marcados. Las barras se ordenan por su valor, así que la silueta de la hilera es el reparto de la cohorte. Es la figura habitual para enseñar la respuesta a un tratamiento en un ensayo.

Editar con tus datos SVG Spec JSON

Nueve barras cruzan el umbral y sólo ocho son respuesta

Datos: category · value · series
Buena para: Ver cuántos pacientes responden, cuánto, y cómo se reparte la respuesta en toda la cohorte.
Evítala cuando: Cuando necesitas saber cuánto dura la respuesta: la barra mide un cambio, no un tiempo.
Se lee bien: Entre 5 y 80 elementos; dibuja hasta 300
Datos que faltan: Se niega a dibujar y dice qué valor falta.
Accesibilidad: Lector de pantalla: tabla de datos · respeta «reducir movimiento»

Forma de los datos

Qué columnas pide

Columna	Tipo	Para qué
`category`	string	El identificador del paciente: una barra por valor distinto. NO se rotula en el eje —la posición de una barra es su rango en la cohorte, no una categoría con nombre— pero es lo que dice de quién es cada barra en el tooltip, y dos filas con el mismo identificador ABORTAN: la escala de banda las colapsaría en una y el lector contaría una barra menos de las que dice la tabla.
`value`	number	El cambio desde la basal, en puntos porcentuales y CON SIGNO: negativo cuando el tumor encoge. El ENCABEZADO de esta columna es lo que se escribe como título del eje Y, así que la unidad la declara el dato («Cambio desde la basal (%)»), no la pieza. Una celda vacía ABORTA: leerla como 0 diría «este paciente no se movió», que es un hallazgo y no un hueco. Y por debajo de −100 % ABORTA también: una suma de diámetros no puede encoger más que hasta desaparecer.
`series` · opcional	string	La categoría de respuesta confirmada: lo ÚNICO que esta forma codifica en color, con la paleta del tema activo y hasta siete valores distintos (el techo que certifica `core/theme/aptitudSeries.ts` en dicromacia). NO se deduce del cambio: depende de hechos que la barra no mide (lesiones nuevas, enfermedad no diana, confirmación en una segunda visita), así que sin esta columna todas las barras van del mismo color y la lámina lo escribe en su nota.

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 sus rótulos no caben sin pisarse o recortarse, y el motor no la publica así. 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

¿Importa ver a cada paciente por separado?

Si basta con resumir la distribución del cambio, un diagrama de caja la condensa.

Sí: quédate con cascada oncológica

No: usa Diagrama de caja

¿Basta con un cambio por paciente, sin su evolución?

Si importa cuándo responde cada paciente y cuánto le dura, el swimmer plot pone una barra de tiempo por paciente.

Sí: quédate con cascada oncológica

No: usa Swimmer plot

¿Mides el cambio del tumor y no el tiempo hasta un evento?

Si la pregunta es cuánto tarda cada grupo en progresar, la curva de supervivencia es la referencia.

Sí: quédate con cascada oncológica

No: usa Curva de Kaplan-Meier

Código

La misma pieza, con tus datos

import { getPreset, renderComposition } from 'visx-render/node';

const spec = await getPreset('oncology-waterfall');
spec.data.rows = misFilas; // category, value
const { svg, warnings } = await renderComposition(spec);

También en React con Chart y prepareComposition. Guía para desarrolladores →

Dudas

¿De qué depende el color de las barras?

De una columna con la categoría de respuesta confirmada. La pieza no la deduce de la altura, porque depende de hechos que la barra no mide, como una lesión nueva; sin esa columna, todas las barras van del mismo color.

¿Admite valores por debajo de −100 %?

No: un tumor no puede encoger más que hasta desaparecer, y un valor así detiene el dibujo. Tampoco admite dos filas con el mismo identificador de paciente.

¿Lleva el nombre de cada paciente en el eje?

No: la posición de una barra es su puesto en la cohorte. El identificador aparece al consultar la barra.

¿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»

Guía para elegir: cómo se reparten los valores →