🔬 Guía de Uso — DOE Lab

Paso a paso para usar la plataforma de análisis estadístico en Replit

Q2003B — Diseño de Experimentos
← Volver a Recursos del Curso

¿Qué es DOE Lab?

DOE Lab es una aplicación web que te permite hacer análisis estadísticos de Diseño de Experimentos sin escribir código. Solo subes tu archivo CSV con datos y la app hace todo el trabajo: análisis, gráficas, interpretación y reporte en PDF.

📊ANOVA Básico
Análisis de varianza de un factor
🔬ANOVA Completo
Con verificación de supuestos y Tukey
⚡Pipeline ANOVA
Análisis automatizado completo
🧪Factorial 2k
Diseños factoriales completos
✂️Fraccionado 2k-p
Diseños factoriales fraccionados

Además incluye un chatbot con IA 🤖 que te puede ayudar a interpretar los resultados (usando Gemini de Google).

Antes de empezar

✓ Lo que necesitas
💡 Tip: Si ya tienes cuenta de Google, puedes usar "Continuar con Google" para registrarte en Replit más rápido.

Paso 1 — Importar el proyecto en Replit

⏱ ~3 minutos
1 Inicia sesión en Replit
  1. Ve a replit.com
  2. Inicia sesión con tu cuenta (o créala si aún no tienes)
  3. Llegarás a tu página de inicio (Home)
2 Crea un nuevo Repl
  1. Haz clic en el botón azul "+ Create Repl" (arriba a la izquierda o en el centro)
  2. En "Template", selecciona Python
  3. En "Title", escribe: DOE-Lab-A0XXXXXXX — reemplaza A0XXXXXXX con tu matrícula (ej. DOE-Lab-A01234567). Esto hace que tu URL incluya tu matrícula al publicar.
  4. Haz clic en "+ Create Repl"
3 Sube los archivos del ZIP
  1. Descomprime el archivo ZIP en tu computadora (doble clic en Mac, clic derecho → Extraer en Windows)
  2. En Replit, mira el panel de archivos a la izquierda
  3. Primero, elimina el archivo main.py que Replit creó automáticamente:
    • Clic derecho sobre main.py → Delete
  4. Ahora, haz clic en los tres puntos (⋮) en la parte superior del panel de archivos
  5. Selecciona "Upload folder"
  6. Navega hasta la carpeta descomprimida (doe-lab-replit) y selecciónala
⚠️ Importante: Debes subir el contenido de la carpeta, no la carpeta misma. Es decir, los archivos app.py, requirements.txt, etc. deben quedar en la raíz de tu Repl, no dentro de una subcarpeta.
💡 Alternativa más fácil: Si "Upload folder" no funciona bien, puedes arrastrar y soltar los archivos directamente desde tu explorador de archivos hacia el panel de archivos de Replit.
4 Verifica que los archivos estén en su lugar

Tu panel de archivos debe verse así:

📁 Tu Repl
├── 📄 app.py               ← Este es el más importante
├── 📄 config.py
├── 📄 modules.json
├── 📄 requirements.txt
├── 📄 .replit
├── 📄 activate.py
├── 📄 README.md
├── 📁 chatbot/
├── 📁 modules/
├── 📁 static/
├── 📁 templates/
├── 📁 logs/
├── 📁 uploads/
└── 📁 outputs/
🚨 ¿Los archivos están dentro de una carpeta doe-lab-replit/?
Si ves algo como doe-lab-replit/app.py en lugar de solo app.py, necesitas moverlos a la raíz. Haz clic en cada archivo → "Move" o arrastra los archivos fuera de la subcarpeta. El archivo app.py DEBE estar en la raíz.

Paso 2 — Configurar el Chatbot (opcional pero recomendado)

⏱ ~2 minutos
5 Obtén tu API key de Gemini (gratis)
  1. Ve a aistudio.google.com/apikey
  2. Inicia sesión con tu cuenta de Google
  3. Haz clic en "Create API Key"
  4. Selecciona cualquier proyecto (o crea uno nuevo)
  5. Copia la API key — es un texto largo que empieza con AIza...
💡 Tip: Guarda tu API key en un lugar seguro (bloc de notas, por ejemplo). La necesitarás si creas otro Repl después.
6 Agrega la API key en Replit
  1. En Replit, busca el ícono de 🔒 "Secrets" en el panel izquierdo (o en el menú Tools)
  2. Haz clic en "+ New Secret"
  3. En Key, escribe exactamente: GEMINI_API_KEY
  4. En Value, pega tu API key (el texto AIza...)
  5. Haz clic en "Add Secret"
⚠️ El nombre DEBE ser exactamente GEMINI_API_KEY — en mayúsculas, con guiones bajos. Si lo escribes diferente, el chatbot no funcionará.
💡 ¿No quieres configurar el chatbot? No pasa nada. La app funciona perfectamente sin él — solo no podrás usar el asistente de IA. Todos los análisis estadísticos funcionan sin API key.

Paso 3 — ¡Ejecutar la app!

⏱ ~1 minuto (primera vez ~2-3 min)
7 Dale Run ▶️
  1. Haz clic en el botón verde "Run ▶️" en la parte superior
  2. La primera vez tardará 2-3 minutos porque Replit instala las dependencias (pandas, scipy, matplotlib, etc.)
  3. Verás mensajes en la consola (panel inferior). Espera hasta ver:
============================================================
  🔬 DOE Lab — Q2003B Design of Experiments
============================================================
  🌐 URL: http://0.0.0.0:5000
  📦 Módulos habilitados:
     ✅ ANOVA Básico
     ✅ ANOVA Completo
     ...
============================================================
  1. Cuando aparezca ese mensaje, la app está lista. Ahora abre la pestaña "Webview" (también puede llamarse "Output" o "Browser") para verla:
    • Busca las pestañas en la parte superior del panel derecho (o inferior)
    • Si no la ves, haz clic en el ícono de monitor 🖥️ o busca el botón "Open Webview"
    • También puedes ir al menú Tools → Webview
⚠️ La pestaña Webview no siempre se abre sola. Si ves que la consola dice que la app está corriendo pero no aparece nada, es normal — solo necesitas abrir el Webview manualmente siguiendo los pasos de arriba.
💡 Tip: Si quieres ver la app en pantalla completa, haz clic en el ícono de "abrir en nueva pestaña" (↗️) en la esquina superior derecha del Webview.
🚨 ¿Ves un error rojo en la consola? Ve a la sección de Solución de Problemas al final de esta guía.

Paso 4 — Cómo usar DOE Lab

🏠 Pantalla de inicio

Al abrir la app verás las tarjetas de módulos disponibles. Cada tarjeta tiene:

📊 Hacer un análisis (ejemplo: ANOVA Básico)

A Selecciona un módulo

Haz clic en "ANOVA Básico" en el menú de la izquierda o en la tarjeta del dashboard.

B Sube tu archivo CSV
  1. Haz clic en "Seleccionar archivo CSV" o arrastra tu archivo al área de carga
  2. Tu CSV debe tener al menos dos columnas:
    • factor — el grupo o tratamiento (texto)
    • respuesta — el valor medido (número)
  3. Verás una vista previa de tus datos si la carga fue exitosa
💡 ¿No tienes un CSV? Usa los archivos de ejemplo que vienen incluidos. Haz clic en "Descargar ejemplo" dentro del módulo, o búscalos en la carpeta static/ejemplos/.
⚠️ Si tu CSV viene de Excel en español: No te preocupes — la app detecta automáticamente si tu archivo usa coma (,) o punto y coma (;) como separador. ¡Ambos funcionan!
C Ejecuta el análisis
  1. Haz clic en "Analizar"
  2. Espera unos segundos — la app procesa tus datos
  3. Verás los resultados: estadísticos, tabla ANOVA, gráficas y la interpretación
D Descarga tu reporte PDF
  1. Después de ver los resultados, haz clic en "Descargar Reporte PDF"
  2. Se descarga un PDF con todos los resultados, tablas y gráficas
  3. Puedes usar este PDF para tu entrega o como referencia

🤖 Chatbot de IA

El panel derecho tiene un chatbot con Gemini que te puede ayudar:

💡 Tip: El chatbot es más útil después de correr un análisis — porque ya conoce tus resultados y puede explicarlos.

Paso 5 — Publicar y compartir tu proyecto

⏱ ~2 minutos
E Verifica que tu app esté corriendo

Antes de publicar, asegúrate de que la app está activa: haz clic en Run ▶️ si no lo has hecho. Debes ver el mensaje de inicio en la consola.

F Publica tu Repl (Deploy)
  1. En la barra superior de Replit, busca el botón Deploy (a veces aparece como ☁️ o con un ícono de cohete 🚀)
  2. Haz clic en Deploy
  3. Selecciona la opción Autoscale o Static — para esta app usa Autoscale
  4. Haz clic en Deploy nuevamente para confirmar
  5. Espera ~1 minuto mientras Replit construye y despliega tu app
💡 ¿No ves el botón Deploy? También puedes ir al menú de la izquierda → ícono de cohete 🚀 → New Deployment.
⚠️ Replit puede pedirte verificar tu cuenta (número de teléfono) para poder publicar. Si te lo pide, completa la verificación — solo es necesaria una vez.
G Copia tu URL pública
  1. Cuando termine el deploy, Replit te mostrará tu URL pública. Tiene este formato:
    https://DOE-Lab-A01234567.tuusuario.repl.co
  2. Copia esa URL — verás que incluye el nombre del proyecto (DOE-Lab-TuMatricula) que pusiste al crearlo
  3. Pega esa URL en el formulario de registro de la Tab S5 en el sitio del curso:
💡 Tu URL es permanente. Una vez desplegada, tu app estará disponible siempre que alguien visite esa dirección — aunque cierres Replit.
H Verifica que funciona desde la URL pública
  1. Abre la URL en una pestaña nueva (o en tu celular)
  2. Deberías ver la pantalla de inicio de DOE Lab
  3. Si funciona — ¡listo! Comparte esa URL con el profesor
🚨 ¿La URL da error 502 o Loading...?
El deploy puede tardar unos minutos extra la primera vez. Espera 2-3 minutos y recarga la página. Si persiste, regresa al editor de Replit y haz clic en Run ▶️ nuevamente, luego vuelve a intentar el deploy.

📋 Formato de archivos CSV

Para ANOVA (Básico, Completo, Pipeline)

Dos columnas: factor y respuesta

factor,respuesta
NP-10nm,12.5
NP-10nm,13.2
NP-50nm,8.1
NP-50nm,7.9
NP-100nm,4.3
NP-100nm,5.1

Para Factorial 2k

Una columna por factor + columna respuesta

temperatura,presion,respuesta
50,1,12.3
50,1,11.8
50,3,15.6
100,1,18.2
100,3,22.1

Para Fraccionado 2k-p

Mismo formato que factorial (múltiples factores + respuesta)

temperatura,concentracion,tiempo,pH,respuesta
50,0.1,30,5,72.3
50,0.1,60,9,68.1
100,0.5,30,9,81.5
100,0.5,60,5,77.2
⚠️ Reglas del CSV:

🔧 Solución de Problemas

❌ Replit no encuentra el archivo al hacer Run (error con ".main")

Replit intenta correr un archivo llamado .main que no existe. Hay que indicarle que use app.py. Para eso necesitas editar el archivo .replit:

  1. Busca el archivo .replit en el panel de archivos (izquierda)
    • Si no lo ves, los archivos ocultos no están activados — búscalo en las pestañas superiores del editor (arriba, junto a los archivos que tienes abiertos)
    • También puedes ir a Tools → Config files para que aparezca
  2. Abre el archivo .replit
  3. Busca la línea que dice entrypoint = ".main"
  4. Cámbiala por: entrypoint = "app.py"
  5. Guarda el archivo (Ctrl+S o Cmd+S)
  6. Haz clic en Run ▶️ de nuevo
💡 Tip: Si no ves los archivos que empiezan con punto (.replit, .gitignore), son archivos ocultos. En Replit puedes mostrarlos con el botón de los tres puntos ⋯ en el panel de archivos → "Show hidden files".
❌ "ModuleNotFoundError: No module named 'flask'"

Replit no instaló las dependencias. Solución:

  1. En la consola (Shell), escribe: pip install -r requirements.txt
  2. Espera a que termine la instalación
  3. Haz clic en Run ▶️ de nuevo
❌ Los archivos quedaron dentro de una subcarpeta

Si ves doe-lab-replit/app.py en vez de solo app.py:

  1. Abre la carpeta doe-lab-replit en el panel de archivos
  2. Selecciona todos los archivos (Ctrl+A o Cmd+A)
  3. Arrástralos a la raíz del proyecto (fuera de la carpeta)
  4. Elimina la carpeta vacía doe-lab-replit
  5. Haz clic en Run ▶️
❌ "Address already in use" (Puerto ocupado)

El servidor anterior no se cerró bien. Solución:

  1. En la consola, escribe: kill 1 y presiona Enter
  2. Espera 2 segundos
  3. Haz clic en Run ▶️ de nuevo
❌ El chatbot dice "API key no configurada"

No has configurado la API key de Gemini, o el nombre es incorrecto.

  1. Ve a Tools → Secrets
  2. Verifica que exista un secret con el nombre exacto GEMINI_API_KEY
  3. Si no existe, créalo siguiendo el Paso 2 de esta guía
  4. Después de agregar el secret, detén y vuelve a ejecutar la app (Stop → Run)
❌ "Error al procesar el archivo" al subir CSV

Tu archivo puede tener un formato incorrecto. Verifica:

  • ¿Tu archivo es realmente un CSV? (no un .xlsx de Excel)
  • ¿La primera fila tiene los nombres de las columnas?
  • ¿Los números usan punto decimal? (12.5, no 12,5)
  • ¿No hay filas completamente vacías?

Tip: Prueba primero con un archivo de ejemplo (están en la carpeta static/ejemplos/) para verificar que la app funciona bien.

❌ La app se ve rara / no carga estilos

Posibles soluciones:

  • Haz hard refresh: Ctrl+Shift+R (Windows) o Cmd+Shift+R (Mac)
  • Abre la app en una nueva pestaña (botón ↗️ en el Webview)
  • Verifica que la carpeta static/ esté en la raíz del proyecto
❌ Replit dice "This Repl is out of resources"

El plan gratuito de Replit tiene límites. Si te sale este error:

  • Espera unos minutos e intenta de nuevo
  • Cierra otras pestañas de Replit que tengas abiertas
  • Si persiste, puedes crear un Repl nuevo e importar los archivos de nuevo
💡 ¿Cómo exporto un CSV desde Excel?
  1. En Excel, ve a Archivo → Guardar como
  2. En el tipo de archivo, selecciona "CSV UTF-8 (delimitado por comas)"
  3. Si tu Excel está en español y solo te da opción de "CSV (delimitado por comas)" — eso también funciona, la app detecta el separador automáticamente
  4. Guarda el archivo y úsalo en DOE Lab
💡 Tip: Si usas Google Sheets, descarga como CSV: Archivo → Descargar → Valores separados por comas (.csv)

📚 Extras

Archivos de ejemplo incluidos

Dentro de static/ejemplos/ encontrarás 5 archivos CSV listos para probar:

Personalizar el chatbot

Puedes editar el archivo chatbot/prompt_system.txt para cambiar cómo se comporta el asistente de IA. Por ejemplo, puedes pedirle que: