Recursos do R Markdown
Informações:
Este item inclui conteúdo que ainda não foi traduzido para o idioma de sua preferência.
O R Markdown é uma ferramenta útil que permite salvar e executar códigos e gerar relatórios
compartilháveis para as partes interessadas. AS ao aprender mais sobre como usá-lo, pode ser útil
marcar alguns recursos para consultar mais tarde.
Esta leitura explora alguns recursos on-line excelentes que o ajudarão a saber mais sobre o R Markdown
e como usá-lo para documentar sua análise.
Documentação do R Markdown
A documentação do Documentação do R Markdown (R) inclui uma série de tutoriais que o ajudarão a
conhecer os principais recursos do R Markdown, incluindo blocos de código, formatos de saída,
notebooks, documentos interativos e muito mais. Os tutoriais incluem lições on-line que podem ser
concluídas diretamente em seu espaço de trabalho do RStudio Nuvem.
Materiais de referência do R Markdown
O RStudio desenvolveu um guia de referência e uma folha de dicas que você pode marcar e usar sempre
que praticar a escrita de arquivos R Markdown.
O Guia de referência do R Markdown (R) contém três seções: Sintaxe de Markdown, opções de
knitr chunk e opções de Pandoc. O guia é muito detalhado e inclui vários exemplos e explicações
para que você possa encontrar facilmente as informações exatas de que precisa para
personalizar seus documentos do R Markdown.
A Folha de dicas do R Markdown (R) é um resumo prático das diferentes etapas e dos processos
de fluxo de trabalho do R. Ela também inclui seções com explicações abreviadas das opções de
pedaços do knitr e do pandoc e outras informações úteis para revisar ou consultar enquanto
trabalha.
Livro R for Dados Science (R para ciência de dados)
Para uma introdução bem organizada aos conceitos básicos do R Markdown, confira o livro
Comunicação do livro R for Dados Science. Ela aborda os principais recursos e funções do R
Markdown, os vários formatos de saída e o Fluxo de trabalho para combinar texto e programação para
criar um notebook de análise.
R Markdown (R): O guia definitivo
Se você quiser realmente explorar os recursos do R Markdown de forma sistemática, R Markdown (R):
The Definitive Guide fornece um guia abrangente para o ecossistema do R Markdown. Este livro contém
quatro partes principais:
1. Parte I explica como instalar os pacotes relevantes e oferece uma visão geral do R Markdown,
incluindo a sintaxe do Markdown e os blocos de código.
2. A Parte II fornece documentação detalhada dos formatos de saída integrados incluídos no R
Markdown, como formatos de documento e formatos de apresentação.
3. Parte III compartilha vários pacotes de extensão do R Markdown que permitem criar aplicativos
diferentes ou gerar documentos de saída com estilos diferentes.
4. Parte IV aborda tópicos avançados do R Markdown.
Opcional: Notebooks Jupyter
Informações:
Este item inclui conteúdo que ainda não foi traduzido para o idioma de sua preferência.
Os notebooks Jupyter são documentos que contêm códigos de computador e elementos de texto
avançados, como comentários, links ou descrições de suas análises e resultados. Você os encontrará
usados em várias ferramentas on-line, incluindo o Projeto Jupyter, o Kaggle e o Google Colaboratory
("Colab"). Esses notebooks podem ser documentos executáveis que você pode executar para realizar
uma análise.
Os notebooks Jupyter podem ser úteis em tudo, desde a Limpeza de dados e Transformação de dados
até modelos e Visualizações de dados estatísticos. Eles são compatíveis com o R, portanto, você pode
considerá-los como uma alternativa ao R Markdown. E, assim como os documentos do R Markdown, é
possível compartilhar facilmente os notebooks Jupyter com membros da equipe e partes interessadas.
Notebooks Jupyter no Kaggle
Se estiver trabalhando no Kaggle, há dois tipos de notebooks disponíveis: Notebooks Jupyter e scripts
(incluindo scripts R Markdown). Para obter mais informações, consulte a página Como usar os
notebooks do Kaggle.
Notebooks Jupyter no Google Colab
O Google Colab é um produto do Google Research. O Colab é um serviço hospedado de notebooks
Jupyter que não requer configuração para ser usado. Para obter mais informações, consulte a página
Bem-vindo ao Colaboratory.
Recursos adicionais
Para saber mais sobre os notebooks Jupyter, confira estes recursos:
Projeto Jupyter: Este é o lar dos notebooks Jupyter, bem como do JupyterLab - o ambiente
de desenvolvimento interativo baseado na Web para notebooks Jupyter, códigos e dados.
Notebook Jupyter: An Introduction: Esta introdução detalhada dos notebooks
Jupyter foi feita pelo pessoal do Real Python, um site baseado em tutoriais dedicado a tudo
relacionado ao Python. Você pode fazer um curso em vídeo ou seguir o tutorial escrito para
começar a usar os notebooks Jupyter e aprender sobre seus recursos e capacidades.
E, assim como o R Markdown, os notebooks Jupyter incluem ferramentas e regras básicas de
formatação que o ajudarão a manter seu trabalho organizado e fácil de usar. De fato, o Jupyter usa o R
Markdown como sua linguagem para escrever e formatar texto em um Notebook.
Para saber mais sobre formatação básica em notebooks Jupyter, consulte estes Recursos:
The Jupyter Notebook: Esse recurso fornece uma visão geral dos notebooks Jupyter,
incluindo Informações sobre a estrutura da interface do usuário e do documento do notebook.
Você também aprenderá sobre o Fluxo de trabalho básico para usar um documento de notebook,
juntamente com Informações sobre atalhos de teclado e outros recursos que o ajudarão a
formatar seu trabalho.
Usando o Notebook Jupyter para escrever: Este recurso se concentra em como
usar o Markdown para formatar sua escrita em um Notebook Jupyter. Use-o como um guia para
gerenciar a sintaxe de sua redação, incluindo a criação de títulos e subtítulos e a adição de links.
Guia de formatação do Notebook Jupyter: Esse recurso inclui uma ampla variedade
de opções de formatação para notebooks Jupyter. Você aprenderá sobre o básico, bem como
algumas opções mais avançadas, como a Incorporação de documentos PDF e vídeos.
Depois de saber como aplicar a formatação básica aos seus notebooks, você poderá começar a explorar
opções mais avançadas.
Do início ao início com o R Markdown
O R Markdown é um formato de arquivo para criar documentos dinâmicos com o R. Esses documentos,
também conhecidos como notebooks, são registros de análise que ajudam você, os Membros da equipe
e as partes interessadas a entender o que você fez na análise para chegar às conclusões. É possível
publicar um notebook como um arquivo html, pdf ou Word ou em outro formato, como uma
apresentação de slides. A qualquer momento durante esta atividade, você pode consultar a Folha de
consulta do R Markdown (R). Esse recurso é um guia de referência para todos os aspectos do R
Markdown: desde a abertura de um arquivo até a publicação de um relatório final de sua análise.
Selecione e revise sua análise
Neste curso, você teve a oportunidade de praticar e salvar arquivos de sua análise no RStudio. Para
começar, abra uma análise que você salvou.
Você pode usar a opção Abertura de arquivo no menu Arquivo :
Agora, revise o arquivo que você abriu. Examine os dados que você extraiu e as Funções que usou para
analisá-los.
Ao criar um Notebook R Markdown, você quer poder compartilhá-lo com outras pessoas para que elas
possam entender seu processamento e suas conclusões. Também é possível que queira mantê-lo para
seus próprios registros como uma forma de acompanhar seu progresso usando o R para análise.
Abertura de um arquivo Rmd
Agora, você transferirá o Código do arquivo que abriu para um novo arquivo R Markdown (R) para que
possa escrever sua própria explicação das etapas realizadas. Ao fazer isso, poderá criar um registro mais
completo do seu processo geral de pensamento para que outras pessoas possam entendê-lo.
1. Abra um novo arquivo R Markdown (Rmd) para começar a criar a estrutura básica de seu Notebook.
Selecione Arquivo -> Novo arquivo -> R Markdown.
2. Na caixa de diálogo que se abre, adicione um título para seu Notebook. Dê a ele um nome que o ajude
a reconhecer facilmente o assunto da sua análise (por exemplo, "Penguins Plots").
3. Digite seu nome no campo Autoridade.
4. Por enquanto, deixe o arquivo no formato de saída html recomendado. Quando você renderizar o
arquivo mais tarde, ele aparecerá como um relatório em html. Você sempre poderá alterá-lo para um
arquivo PDF ou Word mais tarde.
5. Clique em OK. Um arquivo R Markdown aparecerá em uma nova guia no painel do visualizador de
script. Agora você deve ter duas guias: uma para o novo arquivo Rmd e outra para a sua análise. Você
pode alternar entre elas quando precisar, clicando na guia que deseja acessar.
Formatar seu Notebook
A primeira parte do seu notebook é a seção do Cabeçalho YAML. YAML é uma linguagem usada em
arquivos de dados para melhorar a legibilidade humana, e a seção de cabeçalho YAML existe para
fornecer Informações sobre um documento aos humanos que o leem. O RStudio popula
automaticamente essa seção com as informações fornecidas e outras informações gerais, como a data
de criação do arquivo.
É possível mudar as informações dessa seção a qualquer momento, adicionando texto ou digitando
sobre o texto atual. Observe que cada linha tem um número associado a ela. Isso facilita a referência a
um local no bloco de notas e também permite que você acompanhe onde fez mudanças no bloco de
notas.
A próxima seção com o fundo cinza é um Bloco de código. Você as encontrou sempre que executou um
Bloco de código durante as atividades deste curso.
Novamente, o RStudio popula automaticamente o bloco de código com esse bloco de código padrão
formatado. Esse bloco significa basicamente que seu código será mostrado no relatório final quando
estiver pronto para renderizá-lo.
Todos os blocos de código começam e terminam com delimitadores. Para iniciar um Bloco de código,
você pode digitar três marcas de escala seguidas de um "R" minúsculo entre colchetes: ```{r}
Para finalizá-lo, digite apenas os três sinais de escala: ```
Há dois atalhos para adicionar código. Em seu teclado, você pode pressionar Ctrl + Alt + I ( PC) ou
Cmd + Option + I (MAC). Ou você pode clicar no comando Add Chunk na barra de ferramentas do
editor:
Para adicionar um Bloco de código ao seu arquivo Rmd, siga estas etapas:
1. Clique no final da última linha de seu arquivo Rmd. Use um dos atalhos mencionados anteriormente
para criar um Bloco de código.
2. Pressione Enter (Windows) ou Return (MAC) duas ou três vezes após o Bloco de código padrão
para criar espaço entre o bloco de código existente e o próximo bloco de código que será adicionado.
3. Copy o código do arquivo de análise que você abriu anteriormente e cole-o na área cinza entre os
delimitadores de início e fim.
4. Selecione o restante do conteúdo do modelo no arquivo e exclua-o. Isso lhe dá um espaço em branco
para trabalhar e ajuda a evitar possíveis erros ao misturar seus próprios comentários e códigos com os
pré-existentes no modelo.
O fundo branco é onde você digitará o texto simples com a sintaxe markdown. AS como você aprendeu
anteriormente neste curso, markdown é uma sintaxe para formatação de arquivos de texto simples. O
uso do markdown facilita a escrita e a formatação de texto em seu Notebook.
Aqui estão algumas opções básicas de formatação:
Para iniciar um novo parágrafo, termine uma linha com dois espaços
Para aplicar itálico a uma palavra ou frase, coloque um asterisco no início e no final da palavra ou
frase, por exemplo, *itálico funciona*
Para aplicar negrito a uma palavra ou frase, coloque dois asteriscos no início e no final da palavra
ou frase, por exemplo, **negrito é útil**
Para criar um Cabeçalho, digite uma Hashtag (#) seguida de um espaço e seu texto, por exemplo:
# Getting Started with R Markdown
Ao criar Cabeçalhos, tenha em mente o seguinte:
Os Cabeçalhos aparecerão em azul
Uma única hashtag é o maior Cabeçalho
Quanto mais hashtags você adicionar (até seis), menor será o Cabeçalho
Para formatar comentários em seu Notebook, siga estas etapas:
1. Clique em uma linha acima do Bloco de código que adicionou, mas abaixo da seção YAML.
2. Digite um Cabeçalho principal para seu Relatório usando uma única Hashtag. Talvez você queira
reafirmar o título no YAML de uma maneira diferente ou adicioná-lo a uma breve descrição.
3. Adicione um Cabeçalho menor abaixo dele para rotular a primeira parte de sua programação.
Seguidor por uma descrição do Bloco de código que você adicionou.
As marcas de escala formatam o texto para que apareça como código, mesmo que o texto não esteja em
um Bloco de código. As marcas de escala no código acima criam um fundo cinza atrás de "tidyverse" e
"palmerpenguins"
Continuar a formatação
Continue trabalhando em sua formatação até ter pelo menos três níveis de Cabeçalhos e mais
descrições para sua análise. A qualquer momento, você pode clicar em Knit no painel de script para
renderizar o arquivo.
Ao renderizar o arquivo, você pode visualizar como ele ficará no formato selecionado ao abrir o arquivo.
Neste exemplo, você visualizará um arquivo HTML.
A renderização de um arquivo também executa automaticamente os blocos de código para mostrar a
saída. Neste exemplo, ele mostra que o tidyverse foi carregado usando a função bibliotecas().
Formatos de saída no R Markdown
Informações:
Este item inclui conteúdo que ainda não foi traduzido para o idioma de sua preferência.
Você pode salvar esta leitura para referência futura. Sinta-se à vontade para fazer o download de uma
versão em PDF desta leitura abaixo:
Esta leitura explorará os diferentes tipos de formatos de saída que você pode produzir com o R
Markdown.
Como definir a saída de um documento do R Markdown
Ao trabalhar no RStudio, você pode definir a saída de um documento no R Markdown mudando o
Cabeçalho YAML.
Por exemplo, o código a seguir cria um documento HTML:
---
title: "Demo"
output: html_document
---
E o código a seguir cria um documento PDF:
---
title: "Demo"
output: pdf_document
---
O botão Knit no editor de código-fonte do RStudio renderiza um arquivo no primeiro formato listado
em seu campo de saída (HTML é o padrão). Você pode renderizar um arquivo em formatos adicionais
clicando no menu suspenso ao lado do botão knit.
Saídas de documentos disponíveis
Além da saída HTML padrão(html_document), você pode criar outros tipos de documentos no R
Markdown usando as seguintes configurações de saída:
pdf_document - Cria um arquivo PDF com LaTeX (um sistema de layout de documentos de
código aberto). Se você ainda não tiver o LaTeX, o RStudio o comandará automaticamente para
instalá-lo.
word_document - Cria um documento do Microsoft Word (.docx).
odt_document - Cria um documento de texto OpenDocument (.odt).
rtf_document - Cria um documento no formato Rich Text (.rtf).
md_document - Cria um documento Markdown (que está estritamente em conformidade
com a especificação Markdown original)
github_document - Cria um documento GitHub, que é uma versão personalizada de um
documento Markdown projetado para compartilhamento no GitHub.
Para obter um guia detalhado sobre a criação de diferentes tipos de documentos do R Markdown,
consulte a seção Documentos em R Markdown (R): The Definitive Guide.
Notebooks
Um Notebook (html_notebook) é uma variação de um documento HTML (html_document). Em geral,
os formatos de saída são semelhantes; a principal diferença entre eles é que a saída renderizada de um
notebook sempre inclui uma cópia incorporada do código-fonte.
Os Notebooks e os documentos HTML também têm finalidades diferentes. Os documentos HTML são
bons para a comunicação com as partes interessadas. Os Notebooks são melhores para colaborar com
outros Analistas de dados ou cientistas de dados.
Para saber mais, consulte a seção sobre Notebooks na documentação do R Markdown (R).
Apresentadores
Você também pode usar o R Markdown para produzir apresentações. A inserção automática dos
resultados de sua programação R em uma apresentação pode economizar muito tempo.
O R Markdown renderiza arquivos em formatos de apresentação específicos quando você usa as
seguintes configurações de saída:
beamer_presentation - para apresentações em PDF com o beamer
ioslides_presentation - para apresentações em HTML com o ioslides
slidy_presentation - para apresentações em HTML com Slidy
powerpoint_presentation - para apresentações em PowerPoint
revealjs : : revealjs_presentation - para apresentações em HTML com [Link] (um
framework para criar apresentações em HTML que requer o pacote [Link])
para saber mais, confira a seção sobre Apresentações de slides na documentação do R Markdown (R).
Painéis
Os painéis são uma maneira útil de comunicar rapidamente muitas informações. O flexdashboard
permite que você publique um grupo de Visualizações de dados relacionadas como um Painel. O
Flexdashboard também fornece ferramentas para criar barras laterais, conjuntos de guias, caixas de
valores e medidores.
Para saber mais, visite o site flexdashboard para R e a página Painéis na documentação do R Markdown
(R).
Shiny
O Shiny (R) é um pacote R que permite criar aplicativos interativos da Web usando programação R. É
possível incorporar seus aplicativos em documentos do R Markdown ou hospedá-los em uma página da
Web.
Para chamar o código Shiny em um documento R Markdown, adicione runtime: shiny ao cabeçalho
YAML:
---
title: "Aplicativo Web Shiny"
saída: html_document
tempo de execução: shiny
---
Para saber mais sobre o Shiny (R) e como usar o código R para adicionar componentes de interação a
um documento R Markdown, confira o guia Shiny do RStudio.
Outros formatos
Outros pacotes oferecem ainda mais formatos de saída:
O pacote bookdown é útil para escrever livros e artigos longos.
O pacote prettydoc fornece uma série de temas atraentes para documentos do R Markdown.
O pacote rticles fornece modelos para vários periódicos e editoras.
visite a seção Formatos do RStudio na documentação do R Markdown para obter uma lista mais
abrangente de formatos e pacotes de saída.
Recursos adicionais
Para obter mais informações, consulte estes recursos adicionais:
A Galeria R Markdown (R) do RStudio tem vários exemplos das saídas que você pode criar com o R
Markdown.
Os Formatos do R Markdown (R) do livro R for Dados Science fornece mais detalhes sobre os
formatos de saída apresentados nesta leitura. Esta leitura foi compilada a partir das informações
contidas neste livro.