Un nou paquet d’R facilita la generació de diagrames de flux per a estudis de recerca
Representar el recorregut dels participants en un estudi és un element clau en la recerca clínica i epidemiològica. Els diagrames de flux són l'eina estàndard per fer-ho, ja que permeten visualitzar de manera clara les diferents etapes del procés, des de la selecció inicial fins a l'anàlisi final, seguint guies internacionals com CONSORT o STROBE.
Tot i això, la seva elaboració acostuma a ser laboriosa. Normalment implica introduir dades manualment o programar estructures complexes, fet que en dificulta la reproductibilitat i pot augmentar el risc d'errors. Per donar resposta a aquest repte, la Unitat de Bioestadística de l'Institut de Recerca Germans Trias i Pujol (IGTP) ha desenvolupat flowchart, un paquet d'R que permet generar diagrames de flux de manera senzilla i automatitzada a partir de les dades de l'estudi.
El paquet, disponible al repositori CRAN, introdueix un enfocament diferent dels mètodes tradicionals: en lloc de construir el diagrama manualment, permet crear-lo directament a partir del conjunt de dades, integrant-se amb els principis de treball del tidyverse. Això fa possible generar diagrames clars i preparats per a publicació en pocs passos, dins d'un flux de treball completament reproduïble.
Els resultats d'aquest desenvolupament s'han publicat a la revista Journal of Open Research Software (JORS). L'article descriu la motivació del paquet, la seva arquitectura i funcionalitats principals, així com la documentació disponible. També inclou un exemple pràctic que mostra com generar un diagrama complet de flux de participants a partir d'un conjunt de dades, amb el càlcul automàtic dels nombres i percentatges en cada etapa del procés.
A nivell tècnic, flowchart s'estructura al voltant d'un conjunt de funcions que es poden combinar dins del flux de treball habitual del tidyverse en R mitjançant l'ús del pipe. Aquestes funcions permeten inicialitzar el diagrama, filtrar dades, dividir cohorts i personalitzar-ne el disseny, fins a obtenir una representació final exportable en diversos formats d'imatge. Aquesta flexibilitat facilita adaptar els diagrames a diferents dissenys d'estudi, des d'assaigs clínics fins a estudis observacionals.
Segons els autors, aquesta eina contribueix a millorar la qualitat dels informes científics, ja que facilita la creació de diagrames coherents, transparents i fàcilment reproduïbles. A més, tot i que s'ha desenvolupat principalment per a estudis clínics, el seu enfocament general la fa aplicable a una àmplia varietat d'àmbits de recerca basats en dades.
"Amb flowchart, volem simplificar un procés manual i repetitiu, i facilitar que els investigadors puguin generar diagrames de flux directament a partir de les seves dades, de manera ràpida, fiable i reproduïble" explica Pau Satorra, primer autor de l'estudi i investigador predoctoral a l'IGTP.
Referència
Satorra P, Carmezim J, Pallarès N, Taylor KA, Tebé C. flowchart: An R Package for Data Flowchart Generation. J Open Res Softw. 2026;14:20. Available from: https://openresearchsoftware.metajnl.com/articles/10.5334/jors.649