Neural Network Training Labs

🔀 Fusión de sensores

Fusión de sensores

Antes de tocar el código

Acelerómetro y giroscopio observan el mismo movimiento desde perspectivas distintas; perder uno revela cuánto dependía el modelo de cada sensor.

Pregunta esencial: ¿Las modalidades se complementan o una de ellas domina silenciosamente?

Haz una predicción antes de ejecutar el notebook. Al final volverás a ella y tendrás que decir qué evidencia la confirmó, la corrigió o la dejó abierta.

Dos señales, una decisión

Mapa de esta clase: Dos señales, una decisión. La figura no es decorativa; úsala para explicar el mecanismo con tus propias palabras.

🎯 Qué vas a aprender y construir

Fusionar acelerómetro y giroscopio de smartphones para reconocer actividades.

Práctica propia de esta clase: Comparar cada modalidad, fusión temprana y tardía, y simular la ausencia de un sensor.

Es la clase 13 de 31 del programa y pertenece a 🟣 el módulo 3, Familias especializadas: generar, decidir, relacionar. Llegas desde Transfer learning con mascotas y lo que hagas aquí lo da por supuesto Búsqueda de hiperparámetros.

Trabajarás con el dataset uci_har (UCI, licencia: CC BY 4.0), y tendrás que superar la línea base Acelerómetro solo, giroscopio solo y regresión logística, decidiendo con la métrica macro_f1 medida sobre validation. Nivel avanzado, unas 8 horas de dedicación.

Lo que conviene traer resuelto de las clases anteriores: PyTorch intermedio, optimización, lectura de artículos técnicos.

Al terminar deberías ser capaz de:

Una idea que conviene desmontar

Concatenar señales no garantiza fusión útil; el modelo puede ignorar una modalidad por completo.

🧠 Comprender antes de entrenar

Esta sección es la explicación completa del tema. No hace falta abrir otro archivo para entender lo que viene después: aquí está la idea, la matemática que la sostiene y sus límites. (El mismo texto vive en theory.md, que es la fuente desde la que se genera esta guía, junto con la bibliografía del final.)

De qué trata

Este laboratorio estudia fusión de ramas de sensores usando uci_har, un dataset público real procedente de UCI. La intuición es que cada sensor aporta una vista parcial y complementaria del mismo fenómeno físico: el acelerómetro captura la aceleración lineal (útil para distinguir estar de pie de caminar), mientras que el giroscopio mide la velocidad angular (útil para detectar giros y cambios de orientación). Ninguna modalidad basta por sí sola para separar todas las actividades, pero combinadas reducen la ambigüedad.

La fusión tardía (late fusion) que se practica aquí procesa cada modalidad con su propia rama (una red que aprende una representación específica del sensor) y luego concatena esas representaciones antes de la cabeza de clasificación. La alternativa de fusión temprana (early fusion) concatenaría las señales crudas desde el inicio. La fusión tardía suele ser más robusta cuando las modalidades tienen escalas, ruidos y estructuras temporales distintas, porque permite que cada rama normalice y abstraiga su señal antes de mezclarlas. El aprendizaje de estas representaciones intermedias es el mecanismo central del deep learning aplicado a datos heterogéneos.

El laboratorio también invita a comparar frente a líneas base de una sola modalidad y frente a un modelo lineal. Esto responde la pregunta de si la fusión realmente agrega valor o si una sola rama ya resuelve la tarea. Medir la ganancia marginal de cada sensor es tan importante como alcanzar buena exactitud global.

La matemática, paso a paso

La entrada se divide en dos vistas de la misma ventana temporal: x_acc (canales del acelerómetro) y x_gyro (canales del giroscopio). Cada rama aplica una función parametrizada que produce un vector de características (embedding):

h_acc = f_acc(x_acc; θ_acc), h_gyro = f_gyro(x_gyro; θ_gyro)

La fusión concatena ambas representaciones y la cabeza produce los logits de las K actividades:

f = [h_acc ; h_gyro], z = head(f; θ_head), ŷ = softmax(z)

donde la probabilidad de la clase k es ŷ_k = e^{z_k} / Σⱼ e^{z_j}. El entrenamiento minimiza la entropía cruzada sobre N ejemplos:

ℒ(θ) = −(1/N) Σᵢ Σₖ y_{i,k} · log ŷ_{i,k}

con y_{i,k} la codificación one-hot de la etiqueta verdadera. La actualización de todos los parámetros θ = {θ_acc, θ_gyro, θ_head} sigue el descenso de gradiente estocástico:

θ ← θ − η · ∇_θ ℒ

El gradiente ∇_θ ℒ se propaga por retropropagación a través de la cabeza y luego se reparte por las dos ramas. Aquí aparece la clave de la fusión: el error retrocede por ambos caminos simultáneamente, de modo que cada rama recibe una señal de aprendizaje condicionada por lo que la otra ya aporta. Por eso el modelo puede aprender a que el giroscopio se especialice en los patrones que el acelerómetro no discrimina bien. La formulación conecta cuatro elementos: representación de entrada (las dos vistas), función del modelo (ramas + cabeza), función de pérdida (entropía cruzada) y regla de actualización (SGD con ∇). El notebook muestra las dimensiones de los tensores y conserva la misma implementación que el script de terminal.

Dónde se juntan las señales: tres arquitecturas, tres supuestos

«Fusionar» no es una operación única. Hay tres puntos del recorrido donde se pueden unir dos sensores, y cada uno codifica un supuesto distinto sobre el problema.

La fusión temprana concatena las señales crudas antes de cualquier procesamiento: x = [x_acc, x_gyro], y a partir de ahí hay un solo modelo. Es la más simple y la que más libertad da al modelo para descubrir relaciones cruzadas desde el primer instante, pero supone que ambas señales están alineadas y en escalas comparables, y hace imposible saber qué aportó cada una.

La fusión tardía entrena un modelo por sensor y combina sus predicciones —promedio, voto o una capa que aprende los pesos—: ŷ = w_acc·ŷ_acc + w_gyro·ŷ_gyro. Es robusta —si un sensor falla, el otro sigue prediciendo—, permite entrenar cada rama por separado y es trivialmente interpretable. Su límite es serio: al combinar solo al final, no puede aprender interacciones entre modalidades. Si distinguir «subir escaleras» de «caminar» requiere cruzar una firma del acelerómetro con una del giroscopio, la fusión tardía nunca verá esa combinación.

La fusión intermedia —la de este laboratorio— es el punto medio: cada sensor tiene su propia rama que aprende una representación adaptada a su naturaleza, y esas representaciones se concatenan antes de la cabeza común, h = [h_acc, h_gyro]. Conserva la especialización por sensor y sí permite que la cabeza aprenda interacciones. Es la razón de que sea la opción por defecto en reconocimiento de actividad.

Un detalle del gradiente que conviene tener presente: al concatenar y pasar por una capa densa, cada rama recibe gradiente a través de su bloque de columnas de la matriz de la cabeza. Si una modalidad es mucho más informativa, la cabeza tiende a apoyarse en ella, sus gradientes dominan y la otra rama aprende poco —fenómeno conocido como modalidad perezosa—. Se detecta comparando el desempeño de cada rama por separado con el del modelo fusionado: si la fusión no supera a la mejor rama sola, no hubo fusión real, hubo una rama trabajando y otra decorando.

La ablación es el experimento, no un extra

La pregunta que da sentido al laboratorio no es «¿qué exactitud alcanza el modelo fusionado?» sino «¿cuánto aporta cada sensor?», y solo la ablación la responde. Se entrenan tres modelos con el mismo protocolo —solo acelerómetro, solo giroscopio, y ambos— y se comparan.

La lectura de los resultados es directa y admite tres desenlaces, todos informativos. Si la fusión supera claramente a las dos ramas individuales, las señales son complementarias: cada una aporta información que la otra no tiene. Si la fusión iguala a la mejor rama, son redundantes para esta tarea, y el segundo sensor es costo sin beneficio —una conclusión valiosa, porque cada sensor consume batería y ancho de banda—. Y si la fusión es peor que la mejor rama sola, el modelo está sobreajustando la dimensión añadida o una de las ramas está introduciendo ruido, lo que apunta a un problema de capacidad o de normalización.

Para que la comparación sea válida, las tres variantes deben compartir partición, semillas, presupuesto de épocas y criterio de parada. Cambiar el número de parámetros al quitar una rama es inevitable; lo que no puede cambiar es nada más.

El detalle que hace que este dataset se filtre

Aquí hay una trampa específica de las señales de sensores, y es la razón por la que este laboratorio insiste en la auditoría de particiones.

Las ventanas de UCI HAR se construyen con solapamiento —cada ventana comparte la mitad de sus muestras con la siguiente—. Si esas ventanas se reparten al azar entre train y test, dos ventanas casi idénticas acaban una en cada lado, y el modelo evalúa sobre datos que prácticamente ha visto. La exactitud sube varios puntos sin que nada falle a la vista, y el resultado no se sostiene con datos nuevos.

Peor aún: aunque las ventanas no se solaparan, repartir al azar mezcla al mismo sujeto entre entrenamiento y evaluación. Cada persona camina, se sienta y sube escaleras con una firma característica, así que el modelo puede reconocer al sujeto y usar eso para predecir su actividad. Lo que se mide entonces no es «reconocer actividades» sino «reconocer a estas doce personas», y el modelo se derrumba con un usuario nuevo. La partición correcta es por sujeto: unos sujetos completos para entrenar, otros distintos para evaluar. Es exactamente el escenario que explora la clase 16, y la razón de que ambos laboratorios usen el mismo dataset con particiones distintas.

Sobre el preprocesamiento, dos reglas que se derivan del mismo principio. La normalización se ajusta solo con train, y con las estadísticas de cada canal por separado: acelerómetro y giroscopio miden magnitudes físicas distintas —aceleración y velocidad angular— y en unidades distintas, así que estandarizarlos juntos deja a uno dominando la escala del otro. Y si los sensores tuvieran frecuencias de muestreo distintas, habría que remuestrearlos a una rejilla común antes de concatenar; asumir alineación sin comprobarla es una fuente silenciosa de degradación.

La pregunta que deberías poder responder al terminar: ¿Qué modalidad explica cada actividad?

Qué se mide y con qué se decide

La clase reporta accuracy, balanced_accuracy, macro_f1. De todas ellas, la que decide qué modelo se conserva es macro_f1, y se mide siempre sobre validation: es la única forma de que test siga siendo una estimación honesta de lo que pasará con datos nuevos.

📓 Los tres cuadernos

La clase se puede recorrer en Jupyter y trae tres cuadernos con papeles distintos. Los tres siguen el mismo camino —descargar el dataset real, auditar la partición, entrenar, sellar el experimento y evaluar test una vez—; lo que cambia es qué te toca escribir a ti:

Cuaderno Qué trae Cuándo usarlo
📓 notebook.ipynb El recorrido de referencia: 25 celdas (9 de código) con todo el código escrito y ejecutable, intercalado con las explicaciones. No trae ejercicios. Para leer y ejecutar de principio a fin.
✏️ notebook_student.ipynb El mismo recorrido más 5 ejercicios evaluables (40 celdas en total). Las celdas de ejercicio están marcadas con # YOUR CODE HERE y debajo de cada una hay una comprobación. Para practicar.
✅ notebook_solution.ipynb Los mismos ejercicios resueltos, marcados con # SOLUCIÓN DE REFERENCIA. Cada solución se ejecuta en la integración continua, así que se sabe que pasa. Para contrastar después de intentarlo.

Qué se practica en los ejercicios

Cinco de ellos cubren el contrato experimental común: auditar la partición, decidir con validation, compararse con la línea base, sellar antes de abrir test y dejar el plan por escrito. Se resuelven con Python estándar —sin descargar el dataset ni entrenar—, así que se corrigen en segundos y sin GPU, y cada uno está parametrizado con los valores de este laboratorio: su métrica de selección, su línea base y su experimento propio.

Cómo abrirlos

Los cuadernos necesitan el extra notebooks, que instala Jupyter junto con el paquete:

pip install -e ".[dev,notebooks]"
jupyter lab labs/12_multimodal_fusion/notebook.ipynb

También se abren desde VS Code —con la extensión de Jupyter— haciendo doble clic en el archivo, o desde la interfaz clásica con jupyter notebook. El primer arranque descarga el dataset real desde su proveedor, así que la primera ejecución tarda más y requiere conexión.

Si prefieres ejecutar sin abrir un cuaderno, train.py hace exactamente lo mismo desde la terminal, y la sección de comandos de arriba explica cada opción.

🖥️ Los comandos, explicados

Todo el laboratorio se maneja con una sola herramienta de terminal, neural-labs, que se instala junto con el paquete (pip install -e ".[dev,notebooks]"). Cada subcomando hace una cosa del protocolo, y por eso se pueden ejecutar por separado: preparar datos, auditar la partición, entrenar, repetir con varias semillas.

La forma general es siempre la misma:

neural-labs <subcomando> --lab <identificador> [opciones]
Opción Valor por defecto Valores Qué hace y cuándo cambiarla
--lab 12_multimodal_fusion obligatorio Qué laboratorio se ejecuta. Solo acepta los identificadores del catálogo.
--quick desactivado — Usa una fracción real del dataset y pocas épocas. Sirve para comprobar la instalación, no para concluir nada sobre el modelo.
--split-seed N 42 entero Semilla que decide qué ejemplo cae en qué partición. Se mantiene fija al comparar modelos.
--training-seed N 42 entero Semilla de la inicialización de pesos y del barajado de lotes. Es la que se varía para medir cuánta diferencia es simple azar.
--config baseline baseline · improved Cuál de las dos configuraciones del laboratorio se usa.
--device auto auto · cpu · cuda · mps Dónde entrenar. auto elige GPU si está disponible y cae a CPU si no.
--training-seeds A B C 41 42 43 enteros Solo en benchmark: la lista de semillas de entrenamiento que se repiten.
--output-dir runs ruta Dónde se escribe el directorio de la ejecución.

El script del laboratorio

labs/12_multimodal_fusion/train.py no es un programa distinto: fija el --lab y delega en la misma herramienta, de modo que estas dos líneas hacen exactamente lo mismo.

python labs/12_multimodal_fusion/train.py --quick
neural-labs train --lab 12_multimodal_fusion --quick

Lo mismo desde Python

Si prefieres trabajar en un cuaderno o llamar al laboratorio desde tu propio código, la misma ejecución se lanza así. La función devuelve un objeto con el directorio de la ejecución, las métricas y el historial ya cargados:

from neural_labs.experiments import run_lab

resultado = run_lab(
    "12_multimodal_fusion",
    quick=True,          # False para la ejecución completa
    config_name="baseline",
    split_seed=42,       # fija la partición
    training_seed=43,    # varía la inicialización
)

print(resultado.run_dir)   # dónde quedaron los archivos
print(resultado.metrics)   # el diccionario de métricas finales

Y para preparar el dataset sin entrenar —útil para inspeccionarlo antes—:

from neural_labs.datasets import prepare_dataset

datos = prepare_dataset("12_multimodal_fusion", quick=True, seed=42)
print(datos.summary)       # tamaño de cada partición y metadatos de la fuente

🪜 Laboratorio guiado

Cada paso dice qué ocurre por dentro, por qué se hace en ese orden y cómo comprobar que salió bien. El orden no es una convención de estilo: es el que ejecuta el código, y alterarlo invalida el resultado.

Paso 1 — Traer el dataset real y partirlo

Qué ocurre. Descarga uci_har desde su proveedor y construye las tres particiones —train, validation y test— con la semilla de partición que le pases.

Por qué. La partición se fija antes de entrenar y su semilla (--split-seed) es independiente de la del entrenamiento (--training-seed). Si ambas fueran la misma, no podrías distinguir si un cambio en el resultado viene de haber repartido los datos de otro modo o de haber inicializado los pesos de otro modo.

neural-labs dataset --lab 12_multimodal_fusion --quick --split-seed 42

Cómo sabes que salió bien. El comando termina sin error y deja el dataset en caché. Si no hay red, falla: no se rellena con datos inventados (data/dataset.yaml declara fallback_to_generated_data: false).

Paso 2 — Comprobar que las particiones no se tocan

Qué ocurre. Recorre los identificadores de las tres particiones y verifica que ninguno aparece en dos de ellas.

Por qué. Una sola fila compartida entre train y test basta para que la métrica final quede inflada. Es el error más caro del oficio porque no produce ningún síntoma visible: el modelo simplemente «parece» mejor de lo que es.

neural-labs audit --lab 12_multimodal_fusion --quick --split-seed 42

Cómo sabes que salió bien. La auditoría reporta cero solapamientos. Si reporta alguno, no sigas: el resto del laboratorio no significaría nada.

Paso 3 — Mirar los datos antes de modelarlos

Qué ocurre. Genera el informe de calidad (valores faltantes, balance de clases, rangos) y el de deriva entre particiones.

Por qué. Un desbalance fuerte o una diferencia de distribución entre train y test cambia qué métrica tiene sentido leer. Descubrirlo después de entrenar obliga a repetirlo todo.

neural-labs quality --lab 12_multimodal_fusion --quick --split-seed 42

Cómo sabes que salió bien. Obtienes data_quality.json y drift_report.json; ábrelos antes de decidir la configuración.

Paso 4 — Estudiar la teoría del laboratorio

Qué ocurre. Leer theory.md: la idea central, el desarrollo matemático, los riesgos de interpretación y la bibliografía de la que sale todo eso.

Por qué. Sin esto, el entrenamiento es una caja que devuelve números. La teoría es lo que te permite decidir qué mirar y reconocer cuándo un resultado es sospechoso.

Cómo sabes que salió bien. Puedes responder, con tus palabras, qué calcula el modelo y por qué esa arquitectura encaja con la tarea multiclass_classification.

Paso 5 — Entrenar y seleccionar con validation

Qué ocurre. El entrenamiento recorre las épocas midiendo en validation después de cada una, y conserva el checkpoint con el mejor valor de macro_f1.

Por qué. El conjunto de validación existe para tomar decisiones —arquitectura, hiperparámetros, cuándo parar—. Si esas decisiones se tomaran mirando test, test dejaría de ser una estimación de lo que pasará con datos nuevos y pasaría a ser parte del entrenamiento.

python labs/12_multimodal_fusion/train.py --quick
# o, con control explícito de las dos semillas:
neural-labs train --lab 12_multimodal_fusion --config baseline --split-seed 42 --training-seed 43

Cómo sabes que salió bien. En runs/12_multimodal_fusion/<ejecución>/ aparecen history.csv y best_model.pt; la métrica de validación mejora respecto de la primera época.

Paso 6 — Compararte con la línea base

Qué ocurre. El repositorio entrena por su cuenta Acelerómetro solo, giroscopio solo y regresión logística y guarda su resultado, primero sobre validation y —solo al final— sobre test.

Por qué. Una métrica sola no dice si el modelo aporta algo. Puede que un método mucho más simple llegue igual de lejos, y entonces la complejidad añadida no está justificada. Esta comparación es la que convierte un número en un argumento.

Cómo sabes que salió bien. Comparas metrics.json con baseline_metrics.json. Si tu modelo no supera la línea base, el resultado del laboratorio es exactamente ese, y hay que reportarlo.

Paso 7 — El sellado: experiment.lock.json

Qué ocurre. Antes de tocar test, el código escribe un archivo que fija el laboratorio, las dos semillas, la configuración, la métrica de selección, el checkpoint elegido y el hash del dataset.

Por qué. Es la frontera del experimento. A partir de ahí, cualquier ajuste que hagas mirando test queda a la vista: el sello dice qué habías decidido antes de ver el resultado final. Sin ese archivo, nadie —incluido tú dentro de un mes— puede distinguir una predicción de una racionalización.

Cómo sabes que salió bien. El archivo existe y su contenido coincide con lo que creías haber ejecutado.

Paso 8 — Evaluar test una sola vez y medir la incertidumbre

Qué ocurre. Con el checkpoint congelado se evalúa test, se calculan intervalos de confianza por bootstrap y se desglosan las métricas por subgrupo.

Por qué. Un número puntual esconde cuánto podría moverse. Los intervalos dicen si la diferencia con la línea base es real o cabe dentro del ruido; el desglose por subgrupo revela si el promedio está tapando un grupo donde el modelo funciona mucho peor.

Cómo sabes que salió bien. Tienes metrics.json, confidence_intervals.json y subgroup_metrics.json, y puedes decir la magnitud de la mejora y su incertidumbre.

Paso 9 — Repetir con varias semillas de entrenamiento

Qué ocurre. Se repite el entrenamiento manteniendo fija la partición y cambiando solo la semilla de entrenamiento.

Por qué. Dos ejecuciones idénticas salvo por la inicialización pueden diferir bastante. Si no mides esa dispersión, corres el riesgo de celebrar una mejora que era una semilla afortunada.

neural-labs benchmark --lab 12_multimodal_fusion --quick --split-seed 42 --training-seeds 41 42 43

Cómo sabes que salió bien. Obtienes media y dispersión entre semillas, no un único número.

Paso 10 — Documentar y cerrar

Qué ocurre. Cada ejecución deja model_card.md y report.md; el plan de experimentos vive en experiments.md y la rúbrica en assessment.md.

Por qué. Un resultado sin su contexto —qué datos, qué decisiones, qué límites— no es reutilizable. La model card es lo que permite que otra persona sepa cuándo no debería usar tu modelo.

Cómo sabes que salió bien. Completaste la tabla multi-semilla de experiments.md y respondiste las preguntas de assessment.md.

🔍 Cómo leer lo que produce la ejecución

Cada ejecución escribe su propio directorio con nombre único, de modo que dos corridas nunca se pisan. Esto es lo que encontrarás dentro:

Archivo Qué contiene y qué mirar
config.yaml · environment.json La configuración exacta y el entorno (versiones, dispositivo) de la ejecución.
dataset_manifest.json · dataset_card.md Procedencia, licencia, hash y tamaño de cada partición.
data_quality.json · drift_report.json Calidad de los datos y diferencias de distribución entre particiones.
baseline_validation_metrics.json La línea base medida en validation, antes de entrenar.
history.csv · history.png Pérdida y métricas época a época: aquí se ve si el entrenamiento converge o sobreajusta.
experiment.lock.json El sello del experimento, escrito antes de tocar test.
metrics.json El resultado final en test, más tiempo, dispositivo y número de parámetros.
baseline_metrics.json La línea base en test, calculada después de tu evaluación final.
best_model.pt · last_model.pt El checkpoint elegido por validación y el último, para poder compararlos.
confidence_intervals.json Intervalos por bootstrap: cuánto podría moverse cada métrica.
subgroup_metrics.json El mismo resultado desglosado por subgrupo, para ver qué esconde el promedio.
predictions.csv Predicción por ejemplo, para analizar los errores uno a uno.
confusion_matrix.png Qué clases se confunden entre sí.
model_spec.json · inference_contract.json Qué entrada espera el modelo y qué devuelve: lo que necesita quien lo despliegue.
model_card.md · report.md La ficha del modelo y el informe legible de la ejecución.

⚠️ Dónde suele perderse la gente

Riesgos al interpretar los resultados

Señales inerciales reales de 30 participantes.

El dataset refleja su proceso de recolección y no representa automáticamente otros períodos, países o poblaciones. Una asociación predictiva no demuestra causalidad.

✅ Antes de darlo por terminado

La clase está aprobada cuando se cumplen estos criterios:

Y cuando tienes estos entregables:

El plan experimental con la tabla que hay que completar está en experiments.md, y las preguntas con su rúbrica, en assessment.md. Ambos documentos se abren desde la barra de navegación de arriba.

Para ir más lejos

📚 Fuentes

La teoría de arriba no es original de este repositorio: se apoya en la literatura de referencia del área y en los papers originales de cada arquitectura. Estas son las obras concretas, y lo que aporta cada una:

Las referencias apuntan a las obras; no se reproduce su contenido, la redacción es original.

Los archivos de este laboratorio

Todo lo que necesitas está en esta carpeta. Cada enlace abre el archivo directamente:

Archivo Qué es
📄 README.md Esta guía.
🧠 theory.md La teoría completa con su bibliografía; es la fuente del apartado teórico de arriba.
🔬 experiments.md El plan experimental y la tabla multi-semilla que hay que completar.
📝 assessment.md Las preguntas de evaluación y la rúbrica con la que se corrigen.
🧑‍🏫 instructor-guide.md La apertura, los tiempos y las intervenciones sugeridas para facilitar esta clase.
📓 notebook.ipynb El recorrido completo con todo el código escrito y ejecutable.
✏️ notebook_student.ipynb El mismo recorrido con las celdas de ejercicio vacías.
✅ notebook_solution.ipynb Los ejercicios resueltos, para contrastar.
🖥️ train.py El mismo entrenamiento desde la terminal, sin abrir un cuaderno.
🎛️ configs/baseline.yaml Épocas, lote, tasa de aprendizaje y qué recorta --quick.
🎚️ configs/improved.yaml La configuración ampliada que se compara contra la base.
🗄️ data/dataset.yaml Fuente, licencia, política de partición y límites del dataset.
🧾 lesson.yaml Nivel, prerrequisitos, resultados de aprendizaje y criterios.
🖥️ index.html Esta misma clase como página autocontenida, para leerla sin conexión.

Y fuera de la carpeta, tres referencias que esta guía usa: el catálogo configs/labs.yaml —de donde salen el objetivo, la línea base y las métricas—, el código src/neural_labs/experiments.py —que define el orden de los pasos y los archivos que escribe cada ejecución— y docs/experiment-protocol.md, con la regla general del protocolo.

Los datasets se descargan de su proveedor original y conservan su licencia; este repositorio no los redistribuye ni sustituye una descarga fallida por datos generados.

🔬 Experimentos

Plan de experimentos — Fusión de sensores

Qué significa «experimentar» aquí

Entrenar un modelo y mirar el número que sale no es un experimento: es una observación. Un experimento empieza por una afirmación que podría resultar falsa, sigue fijando todo lo que no se está poniendo a prueba, y termina midiendo si la afirmación se sostiene cuando se repite.

La diferencia importa porque el entrenamiento de una red tiene azar por dentro: la inicialización de los pesos y el orden en que se barajan los lotes cambian el resultado aunque no cambies nada más. Si comparas una sola corrida contra otra sola corrida, no sabes si la diferencia viene de tu idea o de la semilla. Por eso todo lo que sigue está organizado para separar la señal (el efecto de lo que cambiaste) del ruido (la variabilidad propia del entrenamiento).

La hipótesis de este laboratorio

Fusionar acelerómetro y giroscopio de smartphones para reconocer actividades.

Formulada como algo que se puede refutar: el modelo de este laboratorio supera a Acelerómetro solo, giroscopio solo y regresión logística en macro_f1, y la diferencia es mayor que la dispersión entre semillas.

Qué la haría falsa —y esto también es un resultado que hay que reportar—:

El experimento propio de esta clase

Además de la comparación con la línea base, aquí interesa una pregunta específica: Ablacionar acelerómetro y giroscopio. Es la comparación que da sentido al tema de este laboratorio; la de la línea base solo dice si el modelo sirve, mientras que esta dice qué parte del diseño es la que aporta.

Qué se varía y qué se mantiene fijo

Un experimento es interpretable cuando cambia una cosa a la vez. Esta tabla dice qué papel juega cada elemento y, sobre todo, por qué:

Elemento En este experimento Por qué
Partición de los datos (--split-seed) Fija en 42 Si cambiara entre corridas, no podrías saber si la diferencia viene de tu modelo o de que le tocaron datos distintos.
Semilla de entrenamiento (--training-seed) Varía: 41, 42, 43 Es exactamente el ruido que quieres medir. Sin varias semillas no tienes con qué comparar la mejora.
Configuración (--config) Varía: baseline y improved Es la intervención bajo estudio: lo único que estás poniendo a prueba.
Dataset y preprocesamiento Fijos Ajustar la normalización o el vocabulario con otros datos cambiaría el problema, no el modelo.
Presupuesto de épocas y criterio de parada Fijos dentro de cada configuración Dar más épocas a una variante que a otra es comparar dos cosas distintas.
Hardware y versiones Registrados en environment.json No siempre se pueden fijar, pero sí dejar anotados: explican diferencias de tiempo y, a veces, de resultado.
El conjunto test Intacto hasta el final Se abre una sola vez, después de que macro_f1 sobre validation haya elegido al ganador.

Las dos configuraciones que vas a comparar

El laboratorio trae dos configuraciones ya escritas. Estos son los parámetros en los que difieren —el resto es idéntico, que es justamente lo que hace legible la comparación—:

Parámetro baseline.yaml improved.yaml Qué controla
Épocas 20 50 Cuántas pasadas completas sobre train.
Tasa de aprendizaje 0.001 0.0005 Cuánto se mueve cada peso en la dirección del gradiente.
Paciencia 5 8 Épocas sin mejorar en validation antes de detener el entrenamiento.
Precisión mixta no sí Usar float16 donde se puede: acelera en GPU, no cambia el protocolo.
Procesos de carga 0 2 Procesos que preparan los lotes en paralelo.

Elegir entre ellas es una decisión de validation. Si improved gana en validación, se queda; si no, la configuración base es la respuesta y hay que decirlo así.

Cómo ejecutar la serie

El comando benchmark hace exactamente esto: repite el entrenamiento manteniendo la partición fija y cambiando solo la semilla de entrenamiento.

neural-labs benchmark --lab 12_multimodal_fusion \
  --config baseline --split-seed 42 --training-seeds 41 42 43

neural-labs benchmark --lab 12_multimodal_fusion \
  --config improved --split-seed 42 --training-seeds 41 42 43

Por dentro, benchmark no hace magia: llama a run_lab una vez por semilla con la misma partición y resume los resultados. Desde Python es literalmente eso:

from neural_labs.experiments import run_lab
from neural_labs.benchmarking import summarize_benchmark

registros = []
for semilla in (41, 42, 43):
    resultado = run_lab(
        "12_multimodal_fusion",
        config_name="baseline",
        split_seed=42,          # la partición NO cambia
        training_seed=semilla,  # solo cambia la inicialización
    )
    registros.append({"training_seed": semilla, "metrics": resultado.metrics})

print(summarize_benchmark(registros))   # media y dispersión entre semillas

Empieza con --quick para comprobar que la serie corre entera; los números que se reportan salen de la ejecución completa.

La tabla que debes completar

Variante Semilla Métrica en validation Métrica en test Tiempo Parámetros Observación
baseline 41
baseline 42
baseline 43
improved 41
improved 42
improved 43

De dónde sale cada columna, para que no haya que adivinarlo:

Cómo decidir con esos números

  1. Compara medias, pero decide con la dispersión. Calcula media y desviación entre las tres semillas de cada variante. Una mejora de 0,3 puntos entre variantes cuya dispersión interna es de 1,2 puntos no es una mejora: es ruido con buena suerte.
  2. Si los rangos se solapan, dilo. «No se observó una diferencia distinguible del ruido con tres semillas» es una conclusión legítima y mucho más útil que un número inventado de confianza.
  3. Decide con validation. La columna de test sirve para reportar el resultado final una vez, no para elegir la variante ganadora.
  4. El costo forma parte del resultado. Si improved gana por poco y cuesta el triple de tiempo, la conclusión honesta menciona ambas cosas.
  5. Vuelve a la línea base. La comparación contra Acelerómetro solo, giroscopio solo y regresión logística es la que dice si todo el aparato de la red neuronal estaba justificado para este problema.

Qué debe decir tu conclusión

Una conclusión completa contiene cinco cosas, y se puede escribir en un párrafo:

Errores de diseño que invalidan el experimento

📝 Evaluación

Evaluación — Fusión de sensores

Cómo se evalúa esta clase

No se evalúa el número final. Un modelo con una métrica alta obtenida mirando test, o sin compararse con nada, vale menos que uno modesto cuyo resultado se puede auditar. Lo que se califica es el proceso: si las particiones están limpias, si la decisión se tomó donde debía, si la conclusión distingue lo que se midió de lo que se supone.

Evidencias que debes entregar

Evidencia Dónde vive Por qué se pide
Dataset preparado y auditado salida de neural-labs audit Es la única prueba de que el resultado no está contaminado por una fuga entre particiones.
Notebook ejecutado sin celdas omitidas notebook.ipynb Una celda saltada suele ser justo la que rompía el argumento.
Comparación contra Acelerómetro solo, giroscopio solo y regresión logística metrics.json y baseline_metrics.json Sin línea base, una métrica no dice si el modelo aporta algo.
Al menos tres semillas de entrenamiento, o la justificación de por qué no salida de benchmark Una sola corrida no permite separar mejora de azar.
Análisis de errores y limitaciones tu reporte Saber dónde falla vale más que saber cuánto acierta.
Model card actualizada model_card.md Es lo que permite a otra persona saber cuándo no debería usar tu modelo.

Las preguntas, y qué se busca en tu respuesta

No se corrige la longitud de la respuesta, sino si demuestra comprensión. Debajo de cada pregunta está lo que una buena respuesta debería contener.

1. ¿Las modalidades se complementan o una de ellas domina silenciosamente?

Qué se busca: Comienza con la predicción que hiciste al abrir la clase y contrástala con una gráfica, una medida o una observación concreta de tu ejecución.

2. Explica con tus palabras: f=[f_acc(x_acc); f_gyro(x_gyro)]; y=head(f).

Qué se busca: Una buena respuesta conecta cuatro cosas —cómo se representa la entrada, qué calcula el modelo, qué mide la función de pérdida y cómo se actualizan los pesos— en vez de repetir la definición del libro. Si puedes explicarlo sin la fórmula delante, lo entendiste.

3. ¿Qué información del dataset solo puede usarse durante el entrenamiento?

Qué se busca: Se espera que nombres casos concretos: las estadísticas de normalización, el vocabulario, la selección de variables, los umbrales. Todo eso se ajusta solo con train; calcularlo sobre el conjunto completo es una fuga silenciosa que infla el resultado sin dar ningún aviso.

4. ¿Por qué Acelerómetro solo, giroscopio solo y regresión logística es una comparación razonable para este problema?

Qué se busca: Una buena respuesta explica qué captura la línea base y qué no, y por qué superarla —o no superarla— es informativo aquí. Si la línea base ya resuelve el problema, la conclusión correcta es que la red no estaba justificada.

5. ¿Qué modalidad explica cada actividad?

Qué se busca: Esta es la pregunta propia del tema. Responde con evidencia de tu ejecución —predicciones, matriz de confusión, curvas, artefactos del directorio de la corrida—, no con una impresión general.

6. ¿Qué aprendiste al realizar esta práctica: Comparar cada modalidad, fusión temprana y tardía, y simular la ausencia de un sensor.?

Qué se busca: No basta con relatar los pasos. Explica qué cambió, por qué cambió y qué resultado te haría rechazar tu interpretación inicial.

7. Refuta con evidencia esta idea frecuente: «Concatenar señales no garantiza fusión útil; el modelo puede ignorar una modalidad por completo.»

Qué se busca: Se busca una refutación situada en esta materia, apoyada en el mecanismo estudiado y en los resultados obtenidos, no una negación genérica.

8. ¿Qué te dice macro_f1 que no te dirían las otras métricas?

Qué se busca: Cada métrica pondera distinto los errores. Se espera que expliques por qué esa es la que decide aquí y en qué situación sería una mala elección.

9. ¿Qué cambiarías antes de usar este modelo fuera del laboratorio?

Qué se busca: Aquí se evalúa el criterio, no la técnica: licencias y condiciones de uso de uci_har, representatividad de la población, calibración de las probabilidades, vigilancia de la deriva, desempeño por subgrupo y supervisión humana. Un «funcionaría bien» sin condiciones se corrige como respuesta incompleta.

La rúbrica, explicada

Criterio Insuficiente Adecuado Excelente Peso
Integridad de los datos mezcla particiones o no puede demostrar que no lo hizo las tres particiones están separadas y auditadas además documenta hashes, política de partición y justifica la estrategia elegida 20 %
Implementación no ejecuta o produce resultados irreproducibles entrena y evalúa siguiendo el protocolo código claro y reutilizable, con las decisiones explicadas 20 %
Diseño experimental un solo resultado aislado comparación controlada contra la línea base varias semillas, dispersión reportada y variables controladas explícitas 20 %
Análisis repite las métricas sin interpretarlas interpreta los errores y su distribución identifica sesgos, límites y costo, y distingue evidencia de suposición 25 %
Comunicación incompleta o sin contexto reporte entendible y model card presente conclusiones verificables por un tercero a partir de los artefactos 15 %

La diferencia entre adecuado y excelente casi nunca está en la métrica: está en si el trabajo permite que otra persona llegue a la misma conclusión con los artefactos que dejaste. Un resultado peor, bien medido y bien explicado, se califica por encima de uno mejor que no se puede auditar.

La aprobación exige al menos 70 % y cero errores críticos de fuga de datos. La fuga es eliminatoria por sí sola porque invalida todas las demás cifras del trabajo, por buenas que parezcan.

Autoevaluación antes de entregar

🧑‍🏫 Guía docente

Guía docente — Clase 13: Fusión de sensores

Módulo 3: Familias especializadas · Esta guía acompaña a quien facilita la clase; no es un guion que deba leerse literalmente.

La conversación que abre la clase

Acelerómetro y giroscopio observan el mismo movimiento desde perspectivas distintas; perder uno revela cuánto dependía el modelo de cada sensor.

Plantee primero esta pregunta y permita que el grupo formule una predicción antes de mostrar código:

¿Las modalidades se complementan o una de ellas domina silenciosamente?

Qué debe quedar comprendido

Secuencia sugerida

Momento Duración Acción docente Evidencia del estudiante
Activación 10 min Presentar el caso inicial y recoger predicciones. Explica qué espera observar y por qué.
Construcción 25 min Conectar intuición, representación y matemática. Dibuja o relata el mecanismo con sus propias palabras.
Demostración 25 min Recorrer el mapa visual y ejecutar el ejemplo mínimo. Interpreta cada transición sin limitarse a describir la figura.
Investigación 35 min Guiar la práctica propia de esta clase. Contrasta su predicción con una medida o gráfica.
Cierre 15 min Volver a la pregunta esencial y discutir límites. Entrega una conclusión breve con evidencia y una duda abierta.

Práctica propia de esta materia

Comparar cada modalidad, fusión temprana y tardía, y simular la ausencia de un sensor.

Dos señales, una decisión

La figura es un punto de entrada. Pida al estudiante que explique qué cambia entre los tres pasos y qué resultado observable invalidaría su explicación.

Dificultad conceptual que conviene provocar

Idea engañosa: Concatenar señales no garantiza fusión útil; el modelo puede ignorar una modalidad por completo.

No la corrija inmediatamente. Solicite un ejemplo o contraejemplo, ejecute una comparación y recién entonces reconstruya la explicación con el grupo.

Preguntas para acompañar sin resolver

Cierre verificable

La clase termina cuando el estudiante puede responder la pregunta esencial, interpretar su visualización y señalar al menos una limitación. Una métrica aislada no reemplaza ninguna de esas tres evidencias.