10. Reproducibilidad, revisión de pares y presentación#
Note
Duración: 2 horas. Producto final del curso: Repositorio en
GitHub con script reproducible .py y figura cartográfica de alta
esolución del área de tesis.
10.1. De cuaderno exploratorio a script .py modular#
Los cuadernos Jupyter son ideales para experimentación interactiva, pero los flujos reproducibles requieren scripts estructurados y ejecutables desde la terminal de forma no interactiva.
10.1.1. Estructura de carpetas del repositorio#
tesis-cartografia-marina/
├── .gitignore
├── README.md
├── environment.yml
├── data/
│ ├── raw/ # Datos crudos inmutables
│ └── processed/ # Capas recortadas o reclasificadas
├── src/
│ ├── __init__.py
│ ├── procesamiento.py
│ └── generar_mapa.py
└── figures/
├── figura1_mapa_estudio.pdf
└── figura1_mapa_estudio.tif
10.1.2. Manejo de Rutas Relativas con pathlib#
from pathlib import Path
import geopandas as gpd
# Definir rutas relativas a la ubicacion del script
BASE_DIR = Path(__file__).resolve().parent.parent
DATA_DIR = BASE_DIR / "data" / "processed"
OUT_DIR = BASE_DIR / "figures"
OUT_DIR.mkdir(exist_ok=True)
# Cargar capa espacial de forma 100% reproducible
gdf = gpd.read_file(DATA_DIR / "estaciones.gpkg")
10.2. Rúbrica de evaluación del proyecto final#
El proyecto final representa el 40 % de la calificación total del curso:
Rigor y exactitud científica (30 %):
Sistema de Referencia de Coordenadas (CRS) pertinente para la región marina.
Fuentes de datos oficiales citadas explícitamente en el mapa o metadatos (GEBCO, Natural Earth, Copernicus).
Diseño y calidad cartográfica (30 %):
Jerarquía visual clara: los datos del estudio destacan sobre el mapa base.
Elementos presentes: escala gráfica métrica, flecha de norte, cuadrícula rotulada y leyenda legible.
Paleta de color perceptualmente uniforme (
cmocean) y apta para personas con daltonismo.
Calidad editorial para publicación (20 %):
Dimensiones ajustadas a las normas de una revista científica internacional (1 o 2 columnas).
Tipografía legible (entre 7 y 10 puntos).
Exportación a 300+ DPI en formato vectorial (PDF) y matricial (TIFF).
Reproducibilidad y código en GitHub (20 %):
Repositorio limpio con
README.md,environment.ymly.gitignore.Script ejecutable de inicio a fin que genera la figura final sin intervención manual.
10.3. Taller de revision cruzada entre pares#
Durante la última hora de la sesión, los estudiantes intercambian sus mapas y repositorios para verificar:
¿El script se ejecuta sin errores en la máquina del compañero utilizando el entorno
geo-marinas?¿La proyección elegida distorsiona indebidamente las áreas o distancias marítimas?
¿Se leen con facilidad todos los rótulos a escala de impresión del artículo?