Figuras y mapas de investigación
Una figura se gana su lugar cuando muestra algo que una tabla no puede (un patrón a lo largo del tiempo o caudal, una distribución, una disposición espacial) y se lee al tamaño de impresión en escala de grises. Cada figura programada lee sus datos de archivos, por lo que no puede desviarse de los números del texto.
Flujo de trabajo
- Decidir qué debe mostrar la figura en una oración y verificar que una tabla no lo haría mejor. Anotar la revista objetivo y sus anchos de columna.
- Elegir la forma de references/figure-guide.md: tipos de variable, ejes, transformaciones (log para caudal y cargas), y cómo se muestra la incertidumbre.
- Programarla con el módulo de estilo propio
scripts/zfig.py:use_style(),figure("single"|"onehalf"|"double", height_mm), y recetashydrograph_with_rain,flow_duration,load_duration,obs_vs_sim,scenario_bars. Un script por figura (figN_nombre_corto.py), datos leídos por ruta explícita, unidades en cada etiqueta de eje, y unassertpara cada número que el texto cita de la figura. Ejecutepython scripts/zfig.pyuna vez para autocomprobar en un entorno nuevo. - Mapas: seguir la lista de verificación de mapas en la guía (CRS indicado, barra de escala, flecha norte cuando la orientación no sea obvia, recuadro de localización, leyenda con unidades, fuentes de datos y créditos de licencia en el pie de figura). Para diseños finales, QGIS o ArcGIS Pro suele ser más rápido que matplotlib; programe la preparación de datos de cualquier forma.
- Mire el archivo renderizado a su tamaño final antes de darlo por terminado: etiquetas recortadas o superpuestas, leyenda cubriendo datos, marcas ilegibles, colores que se colapsan en escala de grises o para deficiencia de visión de color.
- Pie de figura: qué se muestra, luego cómo leerlo (símbolos, líneas, sombreado, unidades, período, n). Mantenga la interpretación en el texto.
Valores predeterminados importantes
- Paleta cualitativa Okabe‑Ito (integrada en
zfig); mapas de color científicos viridis, cividis o Crameri para datos continuos; mapas divergentes solo alrededor de un cero significativo (p. ej., cambio respecto a la línea base). Sin rainbow ni jet (Crameri et al. 2020). - Texto de 8 pt al tamaño final, mínimo 7 pt; anchos de línea 0.6–1.0 pt.
- Datos observados en negro o gris oscuro y simulaciones en color, de forma consistente entre figuras.
- Ejes logarítmicos para caudal, cargas y concentraciones que abarcan órdenes de magnitud; indíquelo en la etiqueta.
- Mostrar incertidumbre (bandas 95PPU, rangos entre escenarios o miembros climáticos, intervalos de confianza); una barra sin su dispersión sobreestima la certeza.
- No inventar datos, coordenadas ni etiquetas; si faltan datos, escriba el script con un claro
NotImplementedErrory enumere lo que se necesita.
Python primero y comentado; indique unidades, CRS y paso temporal en el docstring de cada script de figura.