© Ricardo Solar/UFMG - compartilhamento e utilização não-comercial livres. Não reproduzir sem autorização > http://doi.org/10.5281/zenodo.7392285

É possível fazermos as análises direto no R e guardar os resultados obtidos de diversas formas. Podemos desde copiar e colar os resultados que aparecem no console até gerar outputs mais elaborados. Apesar de querermos em última instância ter os resultados para utilizar nos artigos, torna-se cada vez mais importante guardá-los e apresentá-los de maneira organizada. O script já é um grande avanço, mas para obter os resultados preciso toda vez rodar e olhar os resultados, de maneira pouco amigável.

O R é bastante capaz de integrar com outras formas de exportação de texto, como \(\LaTeX\) e outros. É aí que entram as funcionalidades do pacote knitr, através do arcabouço conhecido como RMarkdown. As funcionalidades dessa ferramenta são muitas, mas para nosso consumo, uma breve introdução pode ajudar muito na melhoria de apresentação dos dados. Caso deseje aprofundar nesta ferramenta, há várias referências gratuitas, algumas abaixo:

A maior vantagem do RMarkdown é que ela permite que você faça uma mistura de texto e códigos de R dentro de um mesmo documento. Abaixo, irei detalhar algumas possibilidades de uso da ferramenta, passando inicialmente pela formatação do documento e depois passando pelo uso de algumas ferramentas para melhorar a visualização do documento.

1 Preparando o seu documento - cabeçalho e formatos de output

1.1 Cabeçalho YAML

Esse cabeçalho irá conter as informações mais básicas que determinarão o seu documento dele por diante. Esse cabeçalho pode conter muitas informações, mas basicamente você pode utilizar o modelo abaixo, substituindo apenas o título e o autor por seus nomes:

---
title: "Título do trabalho"
author: "Autor do trabalho"
data: "`r format(Sys.time(), '%M, %B, %Y')`"
output: html_document
---

Nesse caso, teremos um documento que será exportado como HTML, que é um dos formatos mais simples de exportação, exigindo apenas a instalação dos pacotes básicos library(rmarkdown) e library(knitr). Naturalmente, há muitras outras opções, e sua curiosidade é o limite.

Caso você use o output como pdf_document, precisará ter instalado no computador algum módulo de \(\LaTeX\).

2 Elementos de texto

2.1 Utilização de seções, subseções e outras diviões no texto.

A primeira coisa que devemos saber é que no RMarkdown podemos separar o texto por blocos, como seção, subseção e assim por diante. Antes de cada bloco desses, utilizamos um sequência hierárquica de hashtags (#). Não confunda com a hashtag usada para comentário dentro de comandos do R, essa continua valendo quando tivermos os blocos de código.

Então, vamos ver como fica a utilização das hashtags para blocos de texto. Dentro de cada uma das seções, você pode escrever seu texto ou bloco de código.

# Seção 1
## Seção 1.1
### Seção 1.1.1

Seção 1

Seção 1.1

Seção 1.1.1

2.2 Modificação de elementos de texto (itálico, negrito e monospace)

Você pode utilizar modificações no texto para chamar atenção a algumas partes, ou ressaltar coisas importantes, como comandos. As formas possíveis são as seguintes:

  • *itálico* ou _itálico_ para itálico
  • **negrito** ou __negrito__ para negrito
  • `monospace` para monospace
  • ~~cortado~~ para cortado

2.3 Criação de listas numeradas e bullet points

2.3.1 Listas numeradas

Muitas vezes queremos listar algumas condições ou listas ordenadas, com números e letras.

1. elemento 1
    a. elemento 1.a
    b. elemento 1.b
2. elemento 2
3. elemento 3

O resultado fica assim:

  1. elemento 1
    1. elemento 1.a
    2. elemento 1.b
  2. elemento 2
  3. elemento 3

2.3.2 Lista não numerada

As listas não numeradas podem ser feitas com * ou -, vamos lá:

* item
    * subitem
        * subitem 2
* item
* item

ou

- item
    - subitem
        - subitem 2
- item
- item
  • item
    • subitem
      • subitem 2
  • item
  • item

3 Elementos de R

3.1 Blocos de código e código em linha com o texto

Toda vez que você quiser incluir um bloco de código de R em seu documento, basta utilizar a sintaxe abaixo:

Para blocos de código:

```{r}
1 + 1
tabela <- read.table("exemplo.txt", h=T)
```

Ou dessa forma para que não se tenha um bloco, mas colocar o comando em linha com o texto:

Colocando assim, `r (9*5)^2` terá o resultado da expressão no output. Esse valor seria 2025

Ou seja, basta adicionar a sequência de ```{r} para iniciar um bloco e a sequência ``` para fechar o bloco. Caso queria somente um comando que resulte em alguma coisa em linha com o texto (como o valor de alguma operação), basta adicionar a sequência `r comando` no seu texto para que o programa entenda como um comando de R. Além de colocar o {r}, dentro das chaves você pode adicionar algumas outras opções, colocando depois da letra r, mais ou menos assim {r, opção=??}. Vou mostrar o que acontece se você modificar a opção padrão, ou seja, se não colocar nada, o R segue seu padrão e não modifica esses parâmetros:

  • error=TRUE - executa o comando com erro e mostra, de propósito, o mesmo no output
  • echo=FALSE - o código utilizado para gerar o resultado não é mostrado
  • message=FALSE - caso a função gere alguma mensagem, ela não será mostrada.
  • warning=FALSE - caso haja algum alerta (warning), ele não será mostrado.

Muitas outras opções são possíveis, mas aí irá da curiosidade :)