Instalar o R

Programação
Introdução
Instalação do R e escolha dum editor ou IDE antes do primeiro tutorial.

0 Instalar o R

Para seguir os tutoriais, precisa primeiro do R. O R é a linguagem em que escrevemos o código e inclui o interpretador que o lê e executa. Instale-o seguindo a secção do seu sistema operativo. No fim, faremos um teste que demora menos de um minuto.

O RStudio não é o R. É um ambiente de desenvolvimento integrado (IDE), ou seja, um programa que reúne num só lugar o editor de código, a consola do R, a ajuda e outras ferramentas. Pode ser uma boa opção para começar. Primeiro instalaremos o R e depois decidiremos se queremos usar um IDE.

Linux

Em Linux, a instalação costuma ser feita pelo gestor de pacotes da distribuição. Abra um terminal e use as instruções correspondentes.

Em Ubuntu ou Debian, a opção mais simples é instalar a versão mantida pela própria distribuição:

sudo apt update
sudo apt install r-base

Em Fedora, instale o meta-pacote R:

sudo dnf install R

Em Arch Linux, o pacote r está nos repositórios oficiais. Actualize o sistema e instale-o com privilégios de administrador (por exemplo, usando sudo):

sudo pacman -Syu r

O CRAN mantém instruções para Linux e páginas próprias para Ubuntu, Debian e Fedora. Consulte-as se usar outra distribuição ou se precisar duma versão mais recente do que a incluída nos repositórios da sua distribuição. Não copie comandos destinados a uma distribuição diferente.

macOS

  1. Abra a página oficial do R para macOS.
  2. Em Acerca deste Mac, confirme se o computador tem um processador Apple (M1, M2, M3, etc.) ou Intel. Descarregue o ficheiro .pkg da versão actual para essa arquitectura e para a sua versão do macOS.
  3. Abra o ficheiro e siga o instalador. Para estes primeiros tutoriais, as opções predefinidas são suficientes.

A página do CRAN indica os requisitos da versão actual. Consulte-a em vez de escolher um instalador apenas pelo número da versão.

Windows

  1. Abra a página oficial do R para Windows.
  2. Seleccione o download da versão actual do R para Windows.
  3. Abra o ficheiro .exe e siga o instalador. Para estes primeiros tutoriais, pode conservar as opções predefinidas.
  4. No fim, abra o R a partir do menu Iniciar.

A mesma página indica quais as versões de Windows suportadas pela edição actual do R.

Confirmar a Instalação

Em Linux ou macOS, abra um terminal e escreva:

R

Em Windows, abra o R pelo menu Iniciar. Nos três sistemas deverá aparecer a consola e um sinal > à espera dum comando. Escreva:

1 + 1

Se aparecer [1] 2, o R está a executar código. Para sair da consola, escreva q(). Quando o R perguntar se quer guardar a área de trabalho, pode responder n neste teste.

Se o terminal disser que não encontra R, feche-o, volte a abri-lo e repita o teste. Se continuar a falhar, confirme os passos na página oficial do seu sistema operativo antes de instalar outro programa por cima.

1 Escolher um Editor ou IDE

Pode escrever código num editor e enviá-lo para o R, ou usar apenas a consola. Se nunca trabalhou com um editor de programação, o RStudio Desktop é uma escolha prática: instale a edição open source depois do R.

Os Painéis do RStudio

Na imagem da documentação da Posit, identifique os quatro painéis principais:

  • Source: o editor onde escrevemos e alteramos scripts. Aparece quando abrimos um script ou criamos um novo.
  • Console: a consola onde o R executa os comandos e mostra os resultados.
  • Environment: permite consultar os objectos criados na sessão.
  • Output: reúne separadores para ficheiros, gráficos, pacotes e ajuda.

A disposição pode variar, e os painéis podem ser reorganizados. A imagem e a explicação completa pertencem à Posit: documentação oficial, «Pane Layout». Procure aí os nomes dos painéis e compare-os com a sua janela do RStudio.

Criar, Guardar e Executar um Script

No RStudio, faça este pequeno teste antes do primeiro tutorial:

  1. Escolha File → New File → R Script. No painel Source, escreva 1 + 1 numa linha.
  2. Escolha File → Save As… e guarde o ficheiro como primeiro.R numa pasta que consiga voltar a encontrar. O ficheiro guarda o código, não os objectos da sessão.
  3. Com o cursor nessa linha, carregue em Run ou use Ctrl+Enter (Cmd+Enter no macOS). O comando e o resultado [1] 2 aparecem na consola. Uma selecção de várias linhas permite executá-las juntas. Nas demonstrações de erros dos primeiros tutoriais, execute uma expressão de cada vez.
  4. Para executar o ficheiro todo de cima para baixo, use Source, no topo do editor. Para este teste, escreva print(1 + 1) em vez de 1 + 1, para mostrar o resultado também ao executar com Source, e volte a guardar.
  5. Escolha Session → Restart R e execute novamente com Source. Assim confirma que o script funciona numa sessão nova, sem depender de comandos anteriores na consola.

À medida que acrescentar código, volte a guardar o ficheiro. Se trabalhar noutro editor, a mesma rotina aplica-se: guardar um ficheiro .R e executá-lo numa sessão nova. Na consola do R pode usar source("primeiro.R"), indicando no caminho a pasta onde guardou o ficheiro.

R Commander

O R Commander é uma interface gráfica para o R que permite escolher análises através de menus. As escolhas geram comandos R, que ficam visíveis no separador R Script. Os resultados aparecem em Output e os avisos e erros em Messages. É um programa diferente do RStudio. Estes tutoriais ensinam a executar comandos em R, pelo que não precisa do R Commander.

O manual de John Fox, Getting Started With the R Commander, mostra a janela na figura 2 (página 3). Compare os menus e as áreas de comandos, resultados e mensagens. As capturas são de versões anteriores. A aparência pode variar com a versão e o sistema operativo. O documento é disponibilizado pelo projecto R Commander no CRAN.

Se algum dos documentos não aparecer aqui, abra a ligação respectiva acima.

VSCodium

Se já usa o VSCodium, pode continuar com ele. Para editar um ficheiro .R, guardá-lo e executá-lo com source("primeiro.R") numa consola de R, não precisa de extensões. Se quiser enviar linhas directamente do editor e ter sugestões de código, a configuração mínima é esta:

  1. Instale a extensão R, de REditorSupport (Open VSX).
  2. Na consola de R, instale uma vez install.packages("languageserver"). É preparação do editor; não acrescente esta linha ao script de análise.
  3. Abra primeiro.R. Na paleta de comandos, procure R: Create R terminal e execute 1 + 1 com o comando R: Run Selection/Line. Aceite o pedido para instalar o pacote de comunicação com a sessão, se aparecer. Se a extensão não encontrar o R, indique o caminho nas suas definições, seguindo o guia da extensão R.

Para trabalhar também com documentos .qmd, instale a extensão Quarto, de quarto (Open VSX). A documentação da extensão Quarto explica a edição de texto e blocos de código, e a pré-visualização. Para produzir o documento final, prepare também o Quarto como indicado abaixo.

Neovim

Se já conhece o Neovim, comece pela instalação habitual, sem transformar já o editor num IDE. Abra um .R, escreva e guarde o código. Pode executá-lo numa consola de R separada com source("primeiro.R"). A detecção do tipo de ficheiro orienta a sintaxe e as opções do editor; confirme-a com :set filetype?. Numa versão actual, deverá obter r para .R e quarto para .qmd. Se isso não acontecer, consulte a documentação de tipos de ficheiro e confirme a versão e a configuração que está a usar.

Um .qmd pode ser editado como texto e pré-visualizado no navegador com o comando da secção seguinte. Para começar, isto basta. Quando fizer falta integração com a sessão de R, o R.nvim permite enviar código e consultar objectos, incluindo em documentos Quarto. O quarto-nvim acrescenta ferramentas para editar e pré-visualizar .qmd. Siga as dependências indicadas por cada projecto quando decidir instalá-los; não precisa de adoptar uma configuração completa de plugins para acompanhar os primeiros tutoriais.

Documentos .qmd Fora do RStudio

Os scripts .R contêm código R. Os documentos .qmd combinam texto, configuração e blocos de código, como os usados para construir este site. Só precisa de preparar esta parte se quiser produzir documentos Quarto.

No VSCodium ou no Neovim, instale também o Quarto CLI, o programa que transforma um .qmd num documento final. Depois, na consola de R, instale uma vez:

# Preparação do ambiente, não uma linha do script de análise.
install.packages("rmarkdown")

Esta instalação inclui knitr, que executa os blocos de R. A documentação do Quarto para R explica esta preparação. Num terminal, dentro da pasta onde guardou o ficheiro, pode pré-visualizar um documento chamado primeiro.qmd com:

quarto preview primeiro.qmd

O navegador mostra o resultado e actualiza-o quando guarda alterações. Este comando é independente do editor; as extensões apenas tornam o trabalho mais cómodo. Os pacotes usados no próprio documento também têm de estar instalados.

Outros Editores

Não é preciso mudar de editor para acompanhar estes materiais. Há também Vim-R para Vim, ESS para Emacs e R no VS Code. Se está a começar com o RStudio, pode deixar estas integrações para mais tarde.

Com o R a funcionar, avance para Aprender a Falar R. Nesse tutorial começamos logo a escrever e a ler código.