Q
QUIÉN
Unidad de análisis
Paciente, ingreso, procedimiento, muestra o medición. Una fila debe representar una unidad definida.
Las cuatro preguntas
Contrato antes del código
R no corrige una base que ya perdió el significado clínico.
Antes del script, cierre unidad de análisis, nombres, ventanas temporales, missing, variables derivadas y outputs esperados. El objetivo es que otra persona pueda auditar cómo cada número llegó a la tabla final.
V
QUÉ
Variable
Un atributo con significado clínico claro: no “valor1”, sino lactato basal, muerte 28 días, exposición 0–24 h.
T
CUÁNDO
Ventana
Ingreso, 24 h, 48 h, egreso. El mismo valor en otro momento puede responder otra pregunta.
R
CÓMO
Regla
Unidad, fuente, valores permitidos, codificación y qué hacer si el dato no existe.
Database contract
Una base auditable tiene reglas antes de datos.
| campo | rol | tipo | ventana | valores | regla de missing |
|---|---|---|---|---|---|
| id | identificador analítico | texto | — | único | nunca missing |
| lactato_0h | predictor/exposición | continua | 0–2 h | mmol/L | NA si no medido |
| muerte_28d | outcome | binaria | día 28 | 0/1 | NA si estado vital desconocido |
Regla que evita errores: cero es un valor; missing es ausencia de información. Nunca convierta NA en 0 por defecto.6
R workflow
No descargue 400 líneas. Trabaje por módulos.
Un script reproducible debe seguir la arquitectura del estudio, no mezclar limpieza, análisis y figuras en un bloque imposible de auditar.
01
setuppaquetes, rutas, opciones02
import_qctipos, duplicados, rangos, missing03
derivevariables derivadas prespecificadas04
analysisoutcome primario y sensibilidades05
outputstablas, figuras, logs, sessionInfoAuditoría antes de R
Diez checks que una IA suele saltarse si no se los exige.
- ¿La unidad de análisis coincide con el protocolo?
- ¿Hay duplicados reales o episodios repetidos?
- ¿Los nombres y tipos coinciden con el diccionario?
- ¿Las unidades son consistentes?
- ¿Hay valores fisiológicamente imposibles?
- ¿El outcome primario puede construirse sin ambigüedad?
- ¿Alguna variable ocurre después del outcome?
- ¿El patrón de missing puede ser informativo?
- ¿Las variables derivadas tienen fórmula trazable?
- ¿Cada output corresponde a un objetivo?