Diseño de protocolos, códigos y datos abiertos

Workshop Abre tu Ciencia

23 de enero de 2026

📲 Accede a las diapositivas en línea

Parte 1 · Marco y diagnóstico

1.1 Principios FAIR

Principio Qué significa En la práctica
F – Findable Los datos pueden localizarse fácilmente Identificador persistente (DOI), metadatos claros, repositorios indexados
A – Accessible Los datos se pueden descargar o consultar Enlace funcional, permisos explícitos, acceso estable
I – Interoperable Los datos pueden combinarse con otros Formatos abiertos y legibles por máquina (CSV, JSON), vocabularios estándar
R – Reusable Los datos pueden reutilizarse Licencia clara (p. ej., CC-BY), documentación suficiente

👉 https://www.go-fair.org/fair-principles/

1.2 Principios FAIR: beneficios científicos y técnicos

1.3 Principios FAIR: beneficios organizacionales y estratégicos

1.4 La situación: Datos abiertos

Tabla 1

1.5 La situación: Cumplimiento FAIR reciente por área

Tabla 2

1.6 El problema

El problema no es la “falta de apertura”, sino que muchos datos de investigación son:

1.6 El problema

El problema no es la “falta de apertura”, sino que muchos datos de investigación son:

1.6 El problema

Además, gran parte del ecosistema de investigación está marcado por:

Parte 2 · Diseño y aplicación práctica

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

Ejemplo: estructura de proyecto FAIR

project/
├─ README.md
├─ LICENSE
├─ metadata/
├─ data_raw/
├─ data_processed/
├─ code/
├─ results/
└─ docs/

Referencias
Estructura y reproducibilidad: Wilson et al., 2016; Noble, 2009; Klein et al., 2018
Licencias y gobernanza del proyecto: Klein et al., 2018
Metadatos y datos (documentación, trazabilidad y preservación): Spreckelsen et al., 2020; Pacharra et al., 2025; Engstfeld et al., 2025; Wilkinson et al., 2016; Fouad et al., 2024
Código, resultados y protocolos reproducibles: Wilson et al., 2016; Noble, 2009; Visentin et al., 2024; Cunha-Oliveira et al., 2024; Kanza et al., 2022; Klein et al., 2018

2.1 Lista de chequeo FAIR con ejemplos prácticos

Ejemplo: convenciones para nombrar archivos

sub-001_session-01_task-rest_bold.nii.gz en vez de final2.nii

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

  • Descripción y propósito del proyecto → Qué hace y qué problema resuelve.
    Muchos READMEs explican el qué y el cómo, pero omiten el propósito y el estado del proyecto (Prana et al., 2019)
  • Instalación y primer uso → Pasos claros de instalación + ejemplo mínimo funcional.
    READMEs con instrucciones de instalación y uso se asocian con proyectos más populares (Liu et al., 2022).
  • Estructura del repositorio y enlaces clave → Mapa básico de carpetas/archivos importantes y enlaces a documentación externa.
    Incluir fragmentos de código y enlaces a recursos visuales se relaciona con más visibilidad (Liu et al., 2022).
  • Estado, mantenimiento y licencia → Indicar licencia y si el proyecto está activo.
    La información de licencia es uno de los contenidos más frecuentes y valorados en software (Ikeda et al., 2018).
  • Cómo contribuir o pedir ayuda → Pautas mínimas para contribuciones y canales de soporte (issues, email, foro).
    Directrices de contribución y referencias se asocian con mayor popularidad del proyecto (Venigalla et al., 2022).

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

Excel vs CSV

Excel permite:

  • Celdas fusionadas
  • Múltiples encabezados
  • Formato visual
  • Ambigüedad estructural

2.1 Lista de chequeo FAIR con ejemplos prácticos

Excel vs CSV

Excel permite:

  • Celdas fusionadas
  • Múltiples encabezados
  • Formato visual
  • Ambigüedad estructural

CSV es:

  • Formato abierto
  • Sin elementos visuales
  • Estructura tabular explícita
  • Previene errores antes de que ocurran

2.1 Lista de chequeo FAIR con ejemplos prácticos

Excel vs CSV

CSV es:

  • Formato abierto
  • Sin elementos visuales
  • Estructura tabular explícita
  • Previene errores antes de que ocurran

2.1 Lista de chequeo FAIR con ejemplos prácticos

Excel vs CSV

CSV es:

  • Estructura tabular explícita
    • Una fila = una observación
    • Una columna = una variable
    • Sin notas mezcladas con los datos

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.1 Lista de chequeo FAIR con ejemplos prácticos

2.2 Reproducibilidad computacional: dos enfoques

Documentos reproducibles

       

  • texto, código y resultados integrados
  • análisis ejecutable de principio a fin
  • tablas y figuras se regeneran automáticamente

Lenguajes:
       

Sin necesidad de programar

   

  • interfaz gráfica
  • ejecutan R en segundo plano
  • datos, análisis y resultados en un solo archivo

Lenguaje (de fondo):

2.3 Proceedings B como ejemplo

  • Datos, código y README son evaluables
  • Reproducibilidad computacional mínima

El rol del README

  • Más importante que el archivo de datos
  • Conecta:
    • protocolo / datos / código
  • Permite reutilización real

Reproducibilidad razonable

  • El código corre
  • Los datos cargan
  • El flujo tiene sentido

2.4 Recomendaciones generales

Código y datos reproducibles

El código se abre para correrlo, no para leerlo

  • Sin pasos manuales ocultos
  • Rutas relativas
    • /home/juan/proyectos/project/data/datos.csv
    • /data/datos.csv
  • Automatización mínima reproducible

Datos abiertos sin dañar

  • Privacidad y consentimiento
  • Poblaciones vulnerables

Datos machine-readable

  • Interpretables automáticamente
  • Sin decisiones humanas implícitas
  • Estructura clara:
    • filas = observaciones
    • columnas = variables
  • Formato abierto (e.g., CSV)

FAIR no es intuición personal

  • Accessible ≠ “abre en mi computador”
  • Interoperable ≠ “yo sé cómo leerlo”
  • Reusable requiere:
    • estructura
    • documentación

2.5 Ejemplos de repositorios FAIR

Este repositorio aplica lo que predica 😇 (como ejemplo y de manera exagerada)
(https://github.com/JDLeongomez/protocolos_codigo_y_datos_abiertos)

  • GitHub no asigna DOIs
  • Zenodo / OSF permiten archivar versiones y asignar DOI

Otros ejemplos:

¡Gracias!

Juan David Leongómez PhD, MSc
jleongomez@unbosque.edu.co