Visualização Científica

Crie figuras que preservem o significado científico antes de otimizar a aparência. Separe princípios universais de regras datadas de editoras, preserve dados brutos e transformações, use cores de forma redundante e inspecione arquivos entregues em vez de confiar nos padrões de plotagem.

Diretrizes inegociáveis

• Nunca altere, oculte, invente ou aprimore seletivamente dados para melhorar uma figura.
• Preserve tabelas/imagens brutas, exclusões, códigos de valores ausentes, código de análise, normalização, discretização, ajustes de imagem e sementes aleatórias.
• Não infira requisitos de revista. Identifique a revista exata, o tipo de artigo, o tipo de figura e a fase de submissão; verifique suas orientações oficiais ativas.
• Não afirme que uma paleta, valor de DPI, formato ou relatório automatizado torna uma figura acessível ou compatível com a revista.
• Não conecte silenciosamente observações ausentes, suprima pontos inconvenientes, aumente a amostragem de imagens como se o detalhe tivesse aumentado ou ajuste eixos/eixos duplos para exagerar uma conclusão.
• Mantenha saídas interativas e estáticas como entregas distintas. O hover interativo não substitui rótulos, texto alternativo, acesso por teclado, uma tabela de dados acessível ou um fallback estático.

Leia references/publication_guidelines.md para codificação enganosa e verificações de integridade. Leia references/journal_requirements.md somente após o destino e a fase serem conhecidos.

Fluxo de trabalho

1. Defina a evidência e o destino

Registre:

• público e meio: manuscrito, web, slide, pôster, suplemento;
• editora/revista exata, tipo de artigo, fase de submissão e largura final pretendida;
• semântica da variável, unidades, estrutura de amostra/réplica, valores ausentes/censurados;
• estimador e definição de incerteza;
• transformações: filtragem, agregação, normalização, suavização, discretização, processamento de imagem;
• caminhos/identificadores de dados de origem e proveniência da saída.

Se os requisitos não forem conhecidos, crie uma figura geral provisória e rotule todas as escolhas da editora como pendentes de verificação.

2. Escolha uma codificação honesta

Prefira a posição em uma escala comum. Antes de codificar, verifique:

• Barras/áreas: normalmente incluem zero porque o comprimento/área é medido a partir de uma linha de base.
• Pontos/linhas: limites diferentes de zero podem ser válidos; mostre o contexto e divulgue quebras.
• Incerteza: nomeie DP, EP, IC, percentil, posterior ou outro intervalo; declare n e a unidade de replicação.
• Observações brutas: mostre-as quando viável; não deixe o jitter obscurecer categorias/valores.
• Dados ausentes: distinga ausente, zero, censurado e excluído; use lacunas ou estilo de modelo/interpolação explícito.
• Área/volume: escale área/volume, não raio/diâmetro; evite 3D decorativo.
• Eixos logarítmicos: rotule a base/transformação e declare como valores zero/negativos são tratados.
• Discretização/suavização: registre limites, largura/janela, método e sensibilidade.
• Normalização: declare a fórmula/referência e mantenha os limites consistentes entre os painéis comparados.
• Eixos duplos: prefira painéis alinhados; se inevitável, justifique as unidades e não crie correlação aparente.
• Imagens: preserve originais, divulgue ajustes de imagem inteira, mostre barras de escala e evite fundos cortados/apagados.

3. Projete a acessibilidade desde o início, não depois

• Use cor mais marcador, estilo de linha, hachura, rótulo direto ou separação de painel.
• Escolha cor qualitativa, sequencial, divergente ou cíclica de acordo com a semântica dos dados.
• Audite o contraste de primeiro plano/fundo no tamanho renderizado.
• Torne explícitos os valores ausentes e fora do intervalo.
• Forneça texto alternativo, uma descrição mais longa para figuras complexas e dados subjacentes para entrega na web.
• Trate o WCAG 2.2 como orientação para a web: 4,5:1 para texto normal, 3:1 para texto grande e 3:1 para objetos gráficos necessários para a compreensão; a cor não pode ser a única pista. Aplicabilidade e exceções importam.

Veja references/color_palettes.md. Uma tela em tons de cinza é útil, mas não é um teste completo de visão de cores ou acessibilidade.

4. Implemente com estilos com escopo

Execute exemplos de shell deste diretório de habilidades. Para seu próprio script de figura, adicione scripts/ e assets/ ao caminho de importação (veja o bootstrap em references/matplotlib_examples.md) e crie o diretório de saída. Use a API orientada a objetos do Matplotlib e contextos de estilo temporários:

import matplotlib.pyplot as plt

from style_presets import style_context

with style_context("default", palette_name="okabe_ito_on_white"):
    fig, ax = plt.subplots(
        figsize=(89 / 25.4, 60 / 25.4),
        layout="constrained",
    )

…