ipeaplot: criando graficos no padrão editorial do Ipea

O ipeaplot é um pacote em R desenvolvido para facilitar a padronização de gráficos e figuras seguindo a política editorial do Instituto de Pesquisa Econômica Aplicada (Ipea). O pacote traz algumas funções que facilitam o ajuste de formatação e de cores de gráficos criados com o pacote ggplot2, garantindo a conformidade com boa parte das diretrizes das publicações do Instituto.

Instalação

Você pode instalar o ipeaplot direto CRAN:

# CRAN
install.packages("ipeaplot")

A versão em desenvolvimento está disponível no GitHub:

# Versão em desenvolvimento (0.4.1.9000)
utils::remove.packages("ipeaplot")
remotes::install_github("ipeadata-lab/ipeaplot")

Visão geral do pacote

O pacote ipeaplot foi desenhado para ser usado em conjunto com o pacote ggplot2, a biblioteca mais popular de visualização de dados em R. Atualmente, o ipeaplot inclui quatro funções principais:

1. theme_ipea() - para formatação de elementos estilísticos da figura (eixos, fontes, linhas, grid, etc.);
2. scale_color_ipea() e scale_fill_ipea()- selecionam paleta de cores dentro de um conjunto de opções utilizadas pelo Ipea;
3. save_ipeaplot() - uma função unificada para salvar gráficos em múltiplos formatos (vetoriais como .eps e .pdf, e raster como .png e .jpg), com padrões que facilitam o uso.

Demonstração do pacote

# Carregue os pacotes
library(ipeaplot)
library(ggplot2)

No painel abaixo, à direita, temos a representação de um gráfico no formato padrão do ggplot2. Já à esquerda, destacamos o resultado obtido após a aplicação de linhas de código com as funções theme_ipea() e scale_color_ipea().

# Figura ggplot original
fig_raw <- ggplot(data = mtcars, aes(x = hp , y = mpg, color = cyl)) +
              geom_point() +
              labs(y='Consumo de Combustível',
                   x ='Potência (Número de cavalos)',
                   color='Cilindradas')

# Adicionando os padrões do Ipea
fig_ipea <- fig_raw +
      scale_color_ipea() +
      theme_ipea()

# Salvando o gráfico em múltiplos formatos com a nova função
save_ipeaplot(fig_ipea, file.name = "meu_grafico_ipea", format = c("png", "pdf"))

Mais detalhes sobre a utilização do ipeaplot nas vinhetas:

• Introdução ao ipeaplot

• Cookbook ipeaplot

Fontes

Por limitações de licenciamento, o ipeaplot utiliza, em títulos e rótulos das figuras, a fonte sem serifa padrão do sistema operacional do usuário e não a tipografia recomendada pelo Editorial do Ipea (Frutiger). Se as figuras forem salvas em formatos vetoriais editáveis (como pdf ou eps), usando a função save_ipeaplot(), a equipe editorial poderá alterar a fonte no momento da edição de uma publicação.

Equipe

O pacote ipeaplot é desenvolvido pela equipe da Coordenação-Geral de Ciência de Dados e Tecnologia da Informação (CGDTI) do Instituto de Pesquisa Econômica Aplicada (Ipea).

Outros pacotes semelhantes

• UNHCR's unhcrthemes
• BBC's bbplot