R Markdown no VSCode

Introdução

O R Markdown no Visual Studio Code (VSCode) oferece um ambiente robusto para gerar relatórios dinâmicos e reproduzíveis. Integre perfeitamente o código R, o texto narrativo e as visualizações em documentos de qualidade profissional.

Este guia o ajudará a dominar a criação, a execução e a personalização de relatórios R Markdown diretamente no VSCode.

Pré-requisitos para o R Markdown no VSCode

Antes de começar, certifique-se de que seu ambiente R no VSCode esteja configurado corretamente:

• Siga Configurando seu ambiente R no VSCode.
• Instalar os pacotes necessários:
  • Pacote R: rmarkdown
  • Extensão VSCode: vscode-R
• Instale o Pandoc para conversão de documentos, caso ainda não esteja instalado.

Criando seu primeiro documento R Markdown no VSCode

Siga estas etapas para criar um novo arquivo .Rmd no VSCode:

1. Criação de novo arquivo:

   • Clique em File > New File.
   • Salve o arquivo como report.Rmd.

2. Adicionar cabeçalho YAML:

   O cabeçalho YAML define os metadados do relatório e o formato de saída:

   ---
   title: "My Analysis Report"
   author: "Your Name"
   date: "`r Sys.Date()`"
   output: html_document
   ---

3. Escrever conteúdo:

   Inserir facilmente trechos narrativos e de código R:

   ## Introdução
   
   Este é um exemplo introdutório:
   
   ```{r}
   summary(cars)
   ```

Execução de blocos de código R

Execute o código R diretamente em seu documento R Markdown:

• Run Current Chunk: Ctrl + Shift + Enter (Windows/Linux) ou Cmd + Shift + Enter (Mac).
• Executar linha ou seleção: Realce o código, pressione Ctrl + Enter (Windows/Linux) ou 8ddd97ddddce99c5a989bf55e72303f7e (Mac).

Os resultados são exibidos em linha abaixo dos blocos de código para visualização e validação imediatas.

Execução do documento do R Markdown no VSCode

Geração de relatórios dinâmicos com o R Markdown

Gerar saídas reproduzíveis, como HTML, PDF ou Word:

1. Renderizar documento:
   • Abra a Paleta de Comandos (Ctrl + Shift + P), selecione RMarkdown: Render.
   • Escolha o formato desejado (HTML, PDF, Word).
2. Exibir documento gerado:
   • O arquivo renderizado aparece no diretório do seu projeto.
   • A saída HTML pode ser visualizada diretamente no navegador ou por meio da extensão de visualização ao vivo do VSCode.

Personalização da saída do R Markdown

Personalize facilmente os resultados de seus relatórios no cabeçalho YAML:

• Temas e estilos personalizados:

  output:
    html_document:
      theme: cosmo
      highlight: haddock

• Relatórios parametrizados:

  Use parâmetros para personalizar relatórios dinamicamente:

  params:
    data_file: "data.csv"

  Referencie parâmetros em seu código usando params$data_file.

Código R em linha para conteúdo dinâmico

Inclua conteúdo dinâmico e atualizado automaticamente diretamente no texto narrativo:

A partir de `r Sys.Date()`, há `r nrow(cars)` observações no conjunto de dados.

Isso permite atualizações automáticas de seu relatório com base em alterações de dados subjacentes.

Práticas recomendadas para criar relatórios do R Markdown

Melhore a legibilidade, o desempenho e a reprodutibilidade:

• Organização do código:

  Rotular e organizar os blocos de forma lógica:

  ```{r data-import, echo=FALSE}
  data <- read.csv("data.csv")
  ```

• Use o cache para obter desempenho:

  Evite executar novamente cálculos caros:

  ```{r expensive-model, cache=TRUE}
  model <- lm(mpg ~ wt + hp, data = mtcars)
  ```

• Gerenciar a visibilidade:

  Controle a visibilidade do código e dos resultados:

  ```{r plot-results, echo=FALSE}
  plot(mtcars$wt, mtcars$mpg)
  ```

Dicas para o R Markdown aprimorado no VSCode

• Live Preview: Instale Live Preview para obter feedback instantâneo ao editar o R Markdown.
• Code Folding: Navegue com eficiência em documentos grandes usando os recursos integrados de code-folding do VSCode.
• Linting e formatação: mantenha arquivos R Markdown limpos e consistentes com os pacotes lintr e styler.

Exemplo completo de documento R Markdown

Aqui está um exemplo completo que demonstra os principais recursos do R Markdown:

---
title: 'Example Analysis with R Markdown'
author: 'Datanovia'
date: '`r Sys.Date()`'
output: html_document
---

## Introdução

Um exemplo que mostra os recursos do R Markdown.

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
```

## Resumo dos dados

Visão geral do conjunto de dados `cars` incorporado:

```{r}
summary(cars)
```

## Gráfico de dispersão: velocidade vs. distância

Representação visual dos dados:

```{r}
plot(cars$speed, cars$dist,
     xlab = "Speed (mph)",
     ylab = "Stopping Distance (ft)",
     main = "Speed vs. Stopping Distance")
```

## Conclusão

O R Markdown simplifica os relatórios dinâmicos e reproduzíveis, integrando análise, narrativa e recursos visuais.

Exemplo de saída de execução:

Execução do documento do R Markdown no VSCode

Conclusão

O domínio do R Markdown no VSCode permite a criação eficiente de relatórios dinâmicos, profissionais e reproduzíveis. Integre narrativas, códigos e visualizações sem esforço, simplificando seu fluxo de trabalho analítico.

Referências e leituras adicionais

• Configurando seu ambiente R no VSCode
• Configurações recomendadas do VSCode para programação em R
• Programação interativa em R e execução de código em VSCode
• Documentação oficial do R Markdown
• Guia de instalação do Pandoc

Explore mais artigos

Nota

Aqui estão mais artigos da mesma categoria para ajudá-lo a se aprofundar no tópico.