Figuras e mapas de pesquisa
Uma figura ganha seu lugar quando mostra algo que uma tabela não consegue (um padrão ao longo do tempo ou vazão, uma distribuição, uma disposição espacial) e é legível no tamanho impresso em escala de cinza. Toda figura programada lê seus dados de arquivos, portanto não pode se desviar dos números no texto.
Fluxo de trabalho
- Decida o que a figura deve mostrar em uma frase e verifique se uma tabela não faria melhor. Anote o periódico alvo e suas larguras de coluna.
- Escolha a forma a partir de references/figure-guide.md: tipos de variáveis, eixos, transformações (log para vazão e cargas) e como a incerteza é mostrada.
- Programe-a com o módulo de estilo da casa
scripts/zfig.py:use_style(),figure("single"|"onehalf"|"double", height_mm)e receitashydrograph_with_rain,flow_duration,load_duration,obs_vs_sim,scenario_bars. Um script por figura (figN_nome_curto.py), dados lidos por caminho explícito, unidades em cada rótulo de eixo e umassertpara cada número que o texto cita da figura. Executepython scripts/zfig.pyuma vez para autotestar em um novo ambiente. - Mapas: siga a lista de verificação de mapas no guia (CRS declarado, escala, seta norte quando a orientação não for óbvia, localizador de detalhe, legenda com unidades, fontes de dados e créditos de licença na legenda). Para layouts finais, QGIS ou ArcGIS Pro geralmente são mais rápidos que matplotlib; programe a preparação dos dados de qualquer forma.
- Olhe o arquivo renderizado no tamanho final antes de considerá-lo pronto: rótulos cortados ou sobrepostos, legenda cobrindo dados, ticks ilegíveis, cores colapsando em escala de cinza ou para deficiência de visão de cores.
- Legenda: o que é mostrado, depois como ler (símbolos, linhas, hachuras, unidades, período, n). Mantenha a interpretação no texto.
Padrões importantes
- Paleta qualitativa Okabe-Ito (embutida no
zfig); mapas de cores científicas viridis, cividis ou Crameri para dados contínuos; mapas divergentes apenas em torno de um zero significativo (ex.: mudança em relação à linha de base). Sem arco-íris ou jet (Crameri et al. 2020). - Texto de 8 pt no tamanho final, mínimo de 7 pt; larguras de linha de 0,6–1,0 pt.
- Dados observados em preto ou cinza escuro e simulações em cor, consistentemente entre figuras.
- Eixos log para vazão, cargas e concentrações que abrangem ordens de magnitude; diga isso no rótulo.
- Mostre incerteza (bandas 95PPU, intervalos entre cenários ou membros climáticos, intervalos de confiança); uma barra sem sua dispersão superestima a certeza.
- Não invente dados, coordenadas ou rótulos; se dados estiverem faltando, escreva o script com um
NotImplementedErrorclaro e liste o que é necessário.
Python primeiro e comentado; declare unidades, CRS e passo de tempo no docstring de cada script de figura.