Título de la Tarea

Práctica 1: Patrimonio Hidráulico y Programación - El Caudal de la “Pluma” 💧💻

Instrucciones

¡Hola, futuros ingenieros!

En esta actividad, conectaremos el patrimonio cultural de nuestro Caribe colombiano con la lógica de programación y la física de fluidos. El cálculo de caudales y volúmenes es una competencia técnica fundamental, ya sea para el diseño de acueductos en Ingeniería Civil, sistemas de riego en Ingeniería Agrícola, o plantas de procesamiento en Ingeniería Agroindustrial.

A partir del relato histórico sobre por qué en la costa le llamamos “pluma” a la llave del agua, deberán resolver un algoritmo en Python y gestionar el código utilizando control de versiones.

¡Con gusto! Estructurar estos elementos es fundamental para el diseño pedagógico de la asignatura, ya que le da claridad a los estudiantes sobre qué se espera de ellos y cómo esta actividad aporta a su perfil profesional.

Aquí tienes la propuesta de los objetivos, las competencias y los resultados de aprendizaje, redactados bajo el enfoque de la educación en ingeniería. Puedes integrarlos directamente en la guía de la asignatura o en la descripción de la tarea.

Objetivos de la Tarea

Objetivo General

Aplicar la lógica de programación en Python para la resolución de un problema matemático de caudales y volúmenes, utilizando un contexto histórico regional y gestionando el código a través de herramientas de control de versiones.

Objetivos Específicos

  • Traducir un problema de cálculo de fluidos (conversión de litros por segundo a metros cúbicos diarios) en un algoritmo funcional.
  • Implementar el estándar de estilo PEP 8 para la documentación y legibilidad del código mediante el uso guiado de Inteligencia Artificial.
  • Gestionar el ciclo de vida básico de un proyecto de software utilizando entornos interactivos en la nube (Google Colab) y repositorios de control de versiones (Git y GitHub).

Competencias a Desarrollar

Competencias Específicas (Técnicas)

  • Pensamiento Computacional: Diseña y estructura secuencias lógicas en Python para resolver problemas de ingeniería aplicada (cálculo de requerimientos hídricos para proyectos civiles, agrícolas o agroindustriales).
  • Gestión de Entornos de Desarrollo: Utiliza con destreza cuadernos interactivos en la nube y terminales de comandos locales para la clonación y actualización de repositorios.

Competencias Transversales (Blandas y Digitales)

  • Integración Cultural y Tecnológica: Relaciona el patrimonio inmaterial y la historia técnica de los sistemas hidráulicos con los fundamentos matemáticos modernos.
  • Apropiación de Inteligencia Artificial: Interactúa de manera efectiva con herramientas de IA generativa para optimizar, comentar y mejorar la calidad de sus entregables, pasando de ser un consumidor de código a un editor crítico.

Resultados de Aprendizaje (RA)

Al finalizar esta actividad, el estudiante será capaz de:

  • RA1: Escribir un script en Python que calcule correctamente el consumo hídrico diario en metros cúbicos, empleando variables, operadores matemáticos y funciones de entrada/salida de datos.
  • RA2: Documentar un algoritmo computacional siguiendo las convenciones de la industria, evidenciando un uso adecuado de docstrings y comentarios de línea.
  • RA3: Ejecutar correctamente el flujo de trabajo de control de versiones, evidenciado en la creación de un commit en la nube y la clonación exitosa del repositorio en un entorno local.

Pasos para completar la actividad:

  1. Lectura y Resolución: Abran el cuaderno interactivo de Google Colab asignado para esta tarea [(Profe: Inserta aquí el enlace de Colab)]. Lean el relato histórico y completen el algoritmo en la Celda 3 para calcular los caudales y volúmenes requeridos. Verifiquen que el código se ejecute sin errores.
  2. Primer Commit en la Nube: Desde Google Colab, vayan a Archivo > Guardar una copia en GitHub. Guarden el avance en su repositorio de la asignatura con un mensaje claro (ej. “Solución inicial del algoritmo de caudales”).
  3. Documentación con Inteligencia Artificial: Copien su código funcional y utilicen un asistente de IA (como Gemini o ChatGPT). Pídanle que añada docstrings y comentarios explicativos siguiendo las buenas prácticas de PEP 8.
  4. Actualización del Repositorio: Reemplacen el código de Colab con la versión documentada por la IA y vuelvan a guardar los cambios en GitHub (Archivo > Guardar una copia en GitHub).
  5. Clonación Local: Vayan a su repositorio en GitHub, copien la URL del proyecto, abran la terminal de su equipo (Símbolo del sistema, Git Bash o la terminal de VS Code) y clonen el repositorio en su disco duro local (unidad C:\) utilizando el comando git clone [URL].

Entregables a subir en esta tarea de Teams:

Para que la tarea sea calificada, debes adjuntar lo siguiente en esta entrega:

  • Enlace (URL): El link directo a tu archivo .ipynb alojado en tu repositorio de GitHub. CON NOMBRES COMPLETOS Y CÓDIGO

  • Captura de pantalla: Una imagen de la terminal de tu computadora donde se evidencie que el comando git clone se ejecutó correctamente en tu disco duro local.

Criterios de Evaluación:

  • Lógica matemática y correcto funcionamiento del algoritmo en Python.
  • Calidad de la documentación del código (uso de buenas prácticas).
  • Uso correcto del flujo de trabajo con Git y GitHub (commits y clonación).

Propuesta de Rúbrica:

  1. Lógica Matemática y Algoritmo (40%): Evalúa si el código resuelve correctamente el problema. ¿Se definieron bien las constantes? ¿Se calcularon correctamente las conversiones de tiempo y volumen (litros a metros cúbicos)? ¿El script se ejecuta sin errores y arroja los resultados esperados para el sistema de riego?
  2. Documentación y Buenas Prácticas - PEP 8 (40%): Evalúa la claridad del código. ¿El estudiante incluyó docstrings y comentarios explicativos claros, demostrando un buen uso de la asistencia de la IA? ¿Las variables tienen nombres descriptivos y el formato es ordenado?
  3. Flujo de Trabajo y Formato (20%): Evalúa si el entregable cumple con la estructura del notebook solicitada. (Nota: Para evaluar la clonación en el disco duro local C:\, necesitaría que me confirmes si en la entrega en Teams adjuntaron la captura de pantalla de la terminal correcta, ya que eso no podré verlo en el notebook).