--- title: "Relatórios em R Markdown" output: html_document --- ```{r setup, include=FALSE} knitr::opts_chunk$set(echo = TRUE) ``` ## O que é o R Markdown? O **R Markdown** é uma ferramenta para criação de relatórios automatizados utilizando as linguagem R e Markdown. A linguagem de marcação Markdown serve para construirmos e formatarmos diversos formatos de arquivos (PDF, HTML, Word, entre outros) a partir de um arquivo de texto com regras bem simples. O R Markdown é uma extensão de Markdown que nos permite colocar código de R. Linguagens de marcação utilizam marcadores (símbolos, tags, funções) para formatar um arquivo de texto simples. Os exemplos mais famosos de linguagem de marcação são o HTML e LaTeX. Após a construção do documento, para gerarmos o relatório na extensão desejada, precisamos *renderizá-lo*, isto é, transformar o arquivo R Markdown em um PDF, HTML ou Word. Isso pode ser feito no RStudio a partir do botão `knit`, que fica logo acima do script, ou pelo atalho `CTRL + SHIFT + K`. ## Regras simples de formatação Usando o R Markdown, podemos criar arquivos HTML, PDF e Word sem precisar sair do R. A grande vantagem é poder de automatização. Construindo um relatório em R Markdown, com exceção das interpretações e conclusões, só precisamos montá-lo uma vez. A partir daí, com apenas um clique podemos: - replicar o relatório para diversas versões da base de dados (modificações, correções, processos periódicos); - replicar o relatório para diversas variáveis. ## Marcadores A seguir, apresentamos uma lista dos principais marcadores utilizados para formatar texto: - uma palavra entre asteriscos fica em itálico: `*texto*` é transformado em *texto* - uma palavra entre dois asteríscos fica em negrito: `**texto**` é transformado em **texto** - um ou mais hashtags viram títulos: `# Título muito grande`, `## Título grande`, `### Título médio`, `#### Título pequeno`, `##### Título muito pequeno` - hiperlinks podem ser criados com a estrutura `[texto](link)`: `[link para o site da Curso-R](https://curso-r.com)` é transformado em [link para o site da Curso-R](https://curso-r.com). - para deixar o texto com `esse formato` (formato de código), apenas coloque o texto entre duas crases. ## Chunks: escrevendo nosso código de R Em um arquivo R Markdown, precisamos escrever nossos códigos dentro dos *chunks*. Para inserir um chunk, utilize o atalho `CTRL + ALT + I`. ```{r} x <- 1 + 1 ``` ```{r} x * 2 ``` Dentro dos chunks você poderá escrever códigos em R como se fosse o nosso script .R tradicional. Por padrão, o código dentro do chunk será colocado no relatório, assim como o resultado da execução desse código (i.e., tudo que seria). Veja o exemplo abaixo: ```{r} meu_vetor <- c(1, 2, 3) meu_vetor + 1 ``` Não é apenas o resultado da última linha que é colocada no relatório. Todo resultado que seria imprimido na tela (Console) também vai para o relatório. Repare que objetos criados em um chunk ficam disponíveis para todos os chunks abaixo dele. ```{r} meu_vetor + 1 meu_vetor - 1 meu_vetor * 10 ``` Para alterar esses comportamentos padrões, utilizamos os parâmetros do chunk. Os parêmetros são colocados dentro das chaves, na linha que define o começo do chunk. Esse `r` que aparece em todos os chunks representa que o código dentro dele é um código de R. Para impedir que o código de um chunk apareça no relatório, basta usar o parâmetro `echo = FALSE`. As chaves neste caso ficaria `{r, echo = FALSE}`. Quando fazemos isso, apenas o resultado é mostrado no relatório. ```{r, echo = FALSE} meu_vetor + 1 ``` - Outra forma: ```{r} #| echo = FALSE meu_vetor + 1 ``` Também podemos impedir que um chunk seja avaliado, mostrando apenas o código no relatório, usando o argumento `eval = FALSE`. ```{r, eval = FALSE} meu_vetor + 1 ``` ```r meu_vetor + 1 ``` Por fim, podemos rodar o chunk sem colocar nem o código nem o resultado no relatório usando o arqumento `include = FALSE`. Isso pode ser utilizado para carregar pacotes, definir funções ou fazer qualquer tipo de operação auxiliar que o leitor do relatório não precisa saber. ```{r, include = FALSE} # Esse código é rodado apenas internamente meu_vetor + 1 ``` Para saber mais sobre os parâmetros dos chunks, consulte [este guia](https://www.rstudio.com/wp-content/uploads/2015/03/rmarkdown-reference.pdf) (inglês). ## Importanto dados Você pode carregar pacotes e dados normalmente dentro de um script R Markdown. ```{r message=FALSE, warning=FALSE} library(tidyverse) imdb <- read_rds("../dados/imdb.rds") getwd() "../dados/imdb.rds" caminho_com_here <- here::here("dados", "imdb.rds") imdb2 <- read_rds(caminho_com_here) ``` ```{r} imdb %>% glimpse() ``` Veja que as mensagens e warnings dos nossos códigos também são colocadas no relatório. Para evitar isso, basta usarmos os parâmetros `message=FALSE` e `warning=FALSE`. Você precisa carregar o pacote apenas uma vez em cada documento. Uma vez carregado um pacote, suas funçõe estarão disponíveis para todo código em R abaixo, no mesmo ou em outros chunks. ## Incluindo tabelas A função `knitr::kable()` é muito útil para gerar tabelas bem formatadas. A seguir, mostramos os 10 filmes com maior lucro na base. ```{r} imdb %>% mutate(lucro = receita - orcamento) %>% slice_max(lucro, n = 10) %>% arrange(lucro) %>% mutate( pos = 10:1, lucro = scales::dollar(lucro) ) %>% select(`Posição` = pos, Filme = titulo, Lucro = lucro) %>% knitr::kable() ``` ## Incluindo gráficos Para construir gráficos, não há segredos. O mesmo gráfico que apareceria na aba **Plots** do RStudio aparecerá no relatório. ```{r grafico_nota_media_por_ano} #| fig.align = "center", #| out.width = "90%", #| warning = FALSE, #| fig.cap="Figura 1. Nota média ao longo dos anos." imdb %>% group_by(ano) %>% summarise(nota_media = mean(nota_imdb, na.rm = TRUE)) %>% ggplot() + geom_line(aes(x = ano, y = nota_media)) + theme_minimal() + labs(y = "Nota média \n", x = "\n Ano") ``` Para centralizar o gráfico no documento, você pode usar o parâmetro `fig.align = "center"` no chunk. Para alterar o tamanho da figura, existem os parâmetros `fig.width` (comprimento) e `fig.height` (altura). O parâmetro `fig.cap` coloca legendas.