Depois de aprender como usar Rmarkdown, o próximo passo para cientistas de dados com interesses acadêmicos é aprender o Latex para ganhar mais controle sobre os nossos documentos.
Latex é uma linguagem de preparação de documentos que podemos acessar direitamente usando, por exemplo, o aplicativo ‘tekmaker’ ou ‘texworks’. Assim, podemos produzir documentos ‘státicos’ sem código ou análise de R e apenas escrevendo a gramática de Latex. Contudo, o jeito mas sofisticado e flexível para usar Latex é dentro de Rstudio, juntando o conteúdo do seu documento com o análise e outputs do R, exatamento usando o mesmo modelo de Rmarkdown.
Todas as tarefas abaixo precisam que o Latex completo seja instalado localmente.
Knitr é Latex + R. Um documento de knitr, .Rnw, é o equivalente que o documento de Rmarkdown, .Rmd. Primeiro, abrimos um novo documento onde podemos digitar a gramática de Latex com File -> New File -> R Sweave (Sweave é basicamento o nome velho de Knitr). O documento abre com três linhas de texto; os mínimos necesários para um documento de Latex:
\documentclass{article} - O tipo de documento que queremos gerar, o mais comum é um article. Vamos ver embaixo como a gerar apresentações.
\begin{document} - um indicador da começa do conteúdo a ser inserido no documento final. Antes disso podemos inserir pacotes e parâmetros. Depois, digite direitamento o seu texto na gramática de latex.
\end{document} - um indicador do fim do documento. Texto depois será ignorado.
Inserir um texto simples “Relatório sobre Latex e Knitr” entre o ‘begin{document}’ e ‘end{document}’. Para gerar o documento final o equivalente a ‘knit’ é ‘Compile PDF’. Deve abrir um PDF, e será salvo na mesma pasta do seu script.
Latex é mais preciso e controlado do que Rmarkdown. Mas a formatação precisa um pouco mais de esforço. O padrão para formatar é \comando{texto}, onde o ‘texto’ é imprimido no documento, e ‘comando’ significa o tipo de formatação desejado.
Para gerar listas não ordenadas: \begin{itemize}
\item Texto 1
\item Texto 2
\end{itemize}
Para gerar listas ordenadas:
\begin{enumerate}
\item Texto 1
\item Texto 2
\end{enumerate}
Títulos e Secões numerados:
\section{Titulo 1}
\subsection{Subtitulo 1}
\subsubsection{Subsubtitulo 1}
Títulos e Secões não numerados:
\section*{Titulo 1}
\subsection*{Subtitulo 1}
\subsubsection*{Subsubtitulo 1}
O mesmo formato de Rmarkdown. Na verdade, o Rmarkdown usa o formato de Latex.
$$\alpha^2 + \beta^2 = \chi^2$$ \[\alpha^2 + \beta^2 = \chi^2\]
$$\frac{\sqrt{1}}{2} * \frac{a}{2b} = \frac{a}{4b}$$ \[\frac{\sqrt{1}}{2} * \frac{a}{2b} = \frac{a}{4b}\] $$\sum_0^{10} x = ...$$ \[\sum_0^{10} x = ...\]
Mais detalhes aqui.
Para inserir acentos, temos duas opções. Primeira opção, abrir um pacote antes de begin{document} e digitar como normal:
\usepackage[latin1]{inputenc}
Segunda opção é usar a formatação especifíca para cada acento, ex:
O nosso típo de documento ‘article’ nos permitem especificar um título e vários outros característicos antes de \begin{document}.
\title{Relatório}
\author{My Name}
\date{Maio 2019}
Se compilar o seu PDF agora, não veja nenhuma diferença. Por que? Porque não tem nada diferente entre begin{document} e end{document}. Para estes característicos aparecem em nosso documento, precisamos inserir o seguinte depois de \begin{document}:
\begin{document}
\maketitle
Agora, deve compilar um documento muito profissional.
Crie um PDF com ao menos cinco das formatações acima e a famosa equação de Pythagoras.
Latex é muito útil para apresentações profissionais. Tem vários opções, mas o mais comum é o estilo ‘beamer’. Começa no início com:
\documentclass{beamer}
Para definir cada ‘slide’ de nossa apresentação, use o seguinte formato:
\begin{frame}
\frametitle{Título do Slide}
Texto, conteúdo normal
Mais texto
\end{frame}
Para incluir imagens de um arquivo local na mesma pasta do seu script .Rnw coloca:
\usepackage{graphicx} - antes de begin{document}
\includegraphics[width=\linewidth]{image.png} - na página/slide onde o imagem deve aparecer
Crie uma Apresentação em PDF com três slides diferentes.
As tabelas e os gráficos que você quer mostrar no seu documento/apresentação podem ser gerados no mesmo documento em ‘chunks’ do mesmo tipo que encontramos em Rmarkdown. A lógica é identical, com apenas uma pequena mudança de estilo da demarcação do chunk. Para inserir um novo chunk, use a opção ’+ C’em Rstudio. Ele aparece um pouco diferente:
<<>>=
x <- 1+1
@Mas significa exatamente o mesmo que o seguinte em Rmarkdown:
```r
x <- 1 + 1
```Podemos também inserir os resultados do nosso chunk dentro do parágrafo usando \Sexpr{x}
Como em Rmarkdown, podemos especificar parâmetros dos chunks entre <<>>.
<<echo=F, eval=T, warning=F, message=F>>
Latex tem uma gramática de tabelas chato de preparar. Mas nunca precisamos digitar ele direitamente. Como em Rmarkdown, o jeito mais fácil de gerar uma tabela é criar um data.frame em R e passar para a função kable. O código embaixo é identical que o código que usamos para gerar uma tabela em Rmarkdown. Insere-lo dentro de um chunk no seu documento .Rnw e precisamos fazer apenas mais uma coisa para que ele aperece bonito: adicionar o parâmetro results=‘asis’ no header do chunk.
<<results='asis'>>=
library(tidyverse)
library(knitr)
file1 <- "https://raw.githubusercontent.com/leobarone/ifch_intro_r/master/data/bf_amostra_hv.csv"
dados <- read.table(file1, header = T, sep = ",")
dados %>% group_by(uf) %>%
summarize(mean_valor=mean(valor)) %>%
kable()
@Para inserir gráficos gerados por seu código, é a mesma lógica. Crie o gráfico em ggplot dentro de um chunk em seu documento de .Rnw. Não precisamos ajustar nenhum parâmetro do chunk, mas existem várias opções úteis para figuras para controlar o título, tamanho etc.
<<fig.cap="Titulo de Figura", fig.height=4, fig.width=4>>=
library(tidyverse)
library(knitr)
file1 <- "https://raw.githubusercontent.com/leobarone/ifch_intro_r/master/data/bf_amostra_hv.csv"
dados <- read.table(file1, header = T, sep = ",")
dados %>% group_by(uf) %>%
summarize(mean_valor=mean(valor)) %>%
ggplot() +
geom_col(aes(x=uf, y=mean_valor))
@Para aprender mais sobre Latex, pode explorar as guias aqui, aqui e aqui. Sobre Knitr, aqui.
Usando os dados do mtcars (disponível automaticamente como mtcars em R), gere uma tabela e uma figura dentro de um PDF criado usando Knitr.
mtcars