La siguiente es una guía lista para compartir con los
estudiantes de la asignatura Diseño
Experimental. Está adaptada para Windows, clonando el
repositorio en el disco C:\, trabajando desde
Visual Studio Code y publicando una copia personal del
proyecto en la cuenta de GitHub de cada estudiante o grupo.
La idea central es que cada estudiante o grupo:
El repositorio base de la aplicación se encuentra en:
https://github.com/justorfc/design.gitLa aplicación corresponde a una app multipágina desarrollada con
Python y Streamlit, con archivos
principales como app.py, requirements.txt, la
carpeta pages/ y la carpeta utils/.
Esta actividad tiene un propósito que va más allá de ejecutar una aplicación existente. Se espera que cada estudiante o grupo pueda apropiarse del aplicativo, estudiarlo, modificarlo y proyectarlo hacia su uso profesional.
En la práctica profesional, un ingeniero puede necesitar adaptar herramientas computacionales para resolver problemas concretos de análisis de datos, diseño experimental, modelación, visualización e interpretación de resultados. Por esa razón, este ejercicio busca que el estudiante:
Antes de iniciar, cada estudiante debe tener instalado o creado lo siguiente:
Git
Permite clonar repositorios, guardar cambios y subirlos a
GitHub.
Visual Studio Code
Será el editor de código utilizado para abrir, modificar y ejecutar el
proyecto.
Python 3.10 o superior
Se recomienda usar Python 3.10 o una versión posterior compatible con
las librerías del proyecto.
Extensión de Python en VSCode
Desde VSCode, ir a Extensions y buscar:
PythonInstalar la extensión oficial de Microsoft.
Cuenta personal en GitHub
Cada estudiante o grupo debe tener una cuenta activa en GitHub.
Conexión a internet
Será necesaria para clonar el repositorio, instalar dependencias y subir
el proyecto a GitHub.
Abrir PowerShell o la terminal integrada de VSCode y escribir:
git --versionDebe aparecer algo similar a:
git version 2.x.xLuego verificar Python:
python --versionSi el comando anterior no funciona, probar con:
py --versionDebe aparecer algo similar a:
Python 3.10.xC:\Se recomienda no clonar directamente dentro de carpetas del sistema
como C:\Windows o C:\Program Files.
En PowerShell, ejecutar:
cd C:\
mkdir Proyectos
cd ProyectosCon esto se crea la carpeta:
C:\ProyectosDentro de C:\Proyectos, ejecutar:
git clone https://github.com/justorfc/design.gitAl finalizar, se habrá creado la carpeta:
C:\Proyectos\designIngresar a esa carpeta:
cd designVerificar que el proyecto fue clonado correctamente:
dirDeben observarse archivos y carpetas como:
app.py
requirements.txt
pages
utilsDesde la misma terminal, escribir:
code .Si el comando code . no funciona, abrir VSCode
manualmente y hacer:
File → Open Folder → C:\Proyectos\designDentro de VSCode, abrir la terminal integrada:
Terminal → New TerminalVerificar que la terminal esté ubicada en:
C:\Proyectos\designCrear el entorno virtual:
python -m venv .venvSi el comando anterior no funciona, intentar:
py -m venv .venvEsto crea una carpeta llamada .venv, donde quedarán
instaladas las librerías del proyecto.
En PowerShell, ejecutar:
.\.venv\Scripts\Activate.ps1Cuando el entorno virtual esté activo, la terminal mostrará algo parecido a:
(.venv) PS C:\Proyectos\design>Si PowerShell bloquea la activación, ejecutar una sola vez:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserLuego cerrar y abrir de nuevo la terminal de VSCode, y volver a activar:
.\.venv\Scripts\Activate.ps1En VSCode:
Ctrl + Shift + PBuscar:
Python: Select InterpreterSeleccionar el intérprete que esté dentro de:
C:\Proyectos\design\.venv\Scripts\python.exeCon el entorno virtual activo, ejecutar:
python -m pip install --upgrade pipLuego instalar las librerías del proyecto:
pip install -r requirements.txtO, de forma equivalente:
python -m pip install -r requirements.txtCon el entorno virtual activo y estando dentro de la carpeta del proyecto, ejecutar:
streamlit run app.pyLa aplicación se abrirá en el navegador. Normalmente aparecerá en una dirección local como:
http://localhost:8501Si la aplicación abre correctamente, significa que el estudiante ya tiene una copia funcional del aplicativo Design en su computador.
Después de verificar que la aplicación funciona, cada estudiante o grupo debe crear su propio repositorio en GitHub.
Ingresar a:
https://github.comIniciar sesión con la cuenta personal o con la cuenta del grupo.
En GitHub, hacer clic en:
New repositoryO también:
+ → New repositorySe recomienda usar un nombre claro. Por ejemplo:
design-mi-versionTambién se puede usar un nombre con el programa, grupo o apellido:
design-agroindustrial-grupo-03design-experimental-apellido1-apellido2Al crear el repositorio, seleccionar:
Public o
Private, según indique el profesor.Es decir, se recomienda no agregar inicialmente:
README.md.gitignorelicenseEsto evita conflictos al subir el proyecto local que ya fue clonado desde el repositorio del profesor.
Al finalizar, hacer clic en:
Create repositoryGitHub mostrará una URL parecida a esta:
https://github.com/USUARIO/design-mi-version.gitEsa URL será necesaria para conectar el proyecto local con el repositorio propio.
Cuando se clona el repositorio del profesor, Git configura
automáticamente un remoto llamado origin apuntando al
repositorio original.
Desde la terminal de VSCode, dentro de:
C:\Proyectos\designEjecutar:
git remote -vDebe aparecer algo parecido a:
origin https://github.com/justorfc/design.git (fetch)
origin https://github.com/justorfc/design.git (push)Esto significa que, por ahora, el proyecto local está conectado al repositorio del profesor.
Sin embargo, el estudiante normalmente no tiene permiso para subir cambios al repositorio del profesor. Por tanto, se debe cambiar la configuración para que el proyecto suba a su propio repositorio.
upstreamSe recomienda no perder la conexión con el repositorio del profesor.
Para eso, cambiaremos el nombre del remoto actual de origin
a upstream.
Ejecutar:
git remote rename origin upstreamLuego verificar:
git remote -vDebe aparecer algo parecido a:
upstream https://github.com/justorfc/design.git (fetch)
upstream https://github.com/justorfc/design.git (push)upstream?En este contexto, upstream será el nombre del
repositorio original del profesor. Así, si el profesor hace mejoras
futuras, el estudiante podrá traer esos cambios a su proyecto local.
Ahora se agregará un nuevo remoto llamado origin, pero
esta vez apuntando al repositorio personal del estudiante o grupo.
La forma general del comando es:
git remote add origin https://github.com/USUARIO/NOMBRE-DEL-REPOSITORIO.gitPor ejemplo, si el usuario de GitHub es maria123 y el
repositorio se llama design-mi-version, el comando
sería:
git remote add origin https://github.com/maria123/design-mi-version.gitCada estudiante debe reemplazar:
USUARIOpor su nombre de usuario en GitHub, y:
NOMBRE-DEL-REPOSITORIOpor el nombre real del repositorio que creó.
Luego verificar los remotos:
git remote -vDebe aparecer algo parecido a:
origin https://github.com/maria123/design-mi-version.git (fetch)
origin https://github.com/maria123/design-mi-version.git (push)
upstream https://github.com/justorfc/design.git (fetch)
upstream https://github.com/justorfc/design.git (push)En esta configuración:
origin apunta al repositorio propio del
estudiante.upstream apunta al repositorio original del
profesor.Antes de subir el proyecto, verificar el estado de Git:
git statusSi no se han hecho cambios, Git puede mostrar algo parecido a:
nothing to commit, working tree cleanAun así, se puede subir el proyecto clonado al repositorio propio con:
git branch -M main
git push -u origin mainLa primera vez, GitHub puede solicitar autenticación. En algunos equipos se abrirá una ventana del navegador para iniciar sesión. En otros casos, GitHub puede solicitar autenticación mediante Git Credential Manager o un token personal.
Si el proceso fue exitoso, al actualizar la página del repositorio propio en GitHub deberán aparecer los archivos del proyecto:
app.py
requirements.txt
pages/
utils/Después de tener el repositorio propio en GitHub, cada estudiante o grupo debe trabajar siguiendo este ciclo:
git statusEste comando muestra qué archivos fueron modificados, agregados o eliminados.
git add .Este comando prepara todos los cambios para ser guardados en Git.
git commit -m "Mejoras iniciales de la App Design"El mensaje del commit debe describir claramente qué se modificó.
Ejemplos de buenos mensajes:
Agrega explicación teórica del DCACorrige visualización de gráficos RSMAgrega página para diseño factorial 2^3git pushSi es la primera vez que se sube la rama, usar:
git push -u origin mainUna ventaja de conservar el remoto upstream es que el
estudiante puede traer cambios futuros del repositorio original del
profesor.
Para revisar si hay cambios en el repositorio del profesor, ejecutar:
git fetch upstreamLuego integrar esos cambios a la rama local main:
git merge upstream/mainDespués de integrar los cambios, subirlos al repositorio propio:
git push origin mainTambién puede usarse:
git pull upstream main
git push origin mainSi el estudiante modificó archivos que el profesor también modificó, Git puede mostrar conflictos. En ese caso, se deben revisar los archivos marcados por Git, decidir qué versión conservar, guardar los cambios y luego ejecutar:
git add .
git commit -m "Resuelve conflictos con cambios del repositorio base"
git push origin main.venvEl entorno virtual .venv no debe subirse a GitHub porque
puede ocupar mucho espacio y depende del computador de cada
estudiante.
Verificar si existe un archivo .gitignore:
dir .gitignoreSi existe, abrirlo y comprobar que incluya al menos:
.venv/
__pycache__/
*.pycSi no existe, crear un archivo llamado .gitignore en la
raíz del proyecto y agregar:
.venv/
__pycache__/
*.pyc
.ipynb_checkpoints/
.envDespués de crear o modificar .gitignore, guardar el
cambio:
git add .gitignore
git commit -m "Agrega archivo gitignore para entorno virtual"
git pushcd C:\
mkdir Proyectos
cd Proyectos
git clone https://github.com/justorfc/design.git
cd design
code .
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
streamlit run app.pygit remote -v
git remote rename origin upstream
git remote add origin https://github.com/USUARIO/NOMBRE-DEL-REPOSITORIO.git
git remote -v
git branch -M main
git push -u origin maingit status
git add .
git commit -m "Describe aquí los cambios realizados"
git pushgit fetch upstream
git merge upstream/main
git push origin mainCada estudiante o grupo puede continuar la aplicación siguiendo una estructura como esta:
Página de inicio
Presentación general del aplicativo, autores, asignatura, programa y
propósito.
Diseños completamente al azar
Fundamento teórico, fórmulas, ejemplo, análisis en Python e
interpretación.
Diseños en bloques completos al azar
Explicación del bloqueo, tabla ANOVA, supuestos y ejemplo
aplicado.
Diseños factoriales
Efectos principales, interacciones, gráficos e interpretación.
Superficie de respuesta
Modelo de primer orden, trayectoria de máximo ascenso, modelo de segundo
orden, punto estacionario, superficie 3D y curvas de nivel.
Exportación de resultados
Guardar tablas, figuras o reportes en formatos útiles para informes
profesionales.
Aplicación a un caso real
Incorporar un ejemplo propio de Ingeniería Agrícola, Agroindustrial o
Civil.
push..venv.upstream para poder recibir
actualizaciones del repositorio base.Cada estudiante o grupo deberá entregar: