[2]{.chapter-number}  [Software]{.chapter-title}

2 Software

Neste capítulo vamos guiá-lo através da instalação do R, do RStudio e dos pacotes necessários para estas aulas.

O R e o RStudio são softwares que necessitam de download e instalação separados.

2.1 R

O R ou R stats (como também é conhecido) é uma linguagem de programação e um ambiente de software livre para computação estatística e gráficos apoiado pela R Foundation for Statistical Computing.

Os links para download estão no The Comprehensive R Archive Network (aka CRAN). A versão mais recente é a 4.4.2, mas pode usar >= 4.1.x se já a tiver instalada.

Windows
Mac

Download R-4.4.2 para Windows e correr o ficheiro executável.

Importante

Deverá também instalar o Rtools, que é uma coleção de ferramentas necessárias para construir pacotes R no Windows.
Escolha o segundo link para processador ARM (mais recente), e o primeiro link caso contrário.

Download R-4.4.2 para MacOX. Terá de escolher entre a versão arm64 ou a versão x86-64.

Transfira o ficheiro .pkg e instale-o como habitualmente.

Após esta instalação, não é necessário abrir o R. Prossiga com a instalação do RStudio.

2.2 RStudio

O RStudio Desktop é um ambiente de desenvolvimento integrado (IDE) para o R. Inclui uma consola, um editor de código com realce para as funções de bases, bem como ferramentas para fazer gráficos, e análises estatísticas.

O RStudio está disponível para descarregamento gratuito em Posit RStudio.

Windows 10/11
MacOS

Download RStudio 2024.09 e correr o ficheiro executável.

Download RStudio 2024.09 e instale-o como habitualmente.

2.3 Pacotes de R

Terá de instalar alguns pacotes para trabalhar com os dados e os scripts destas aulas.

Pode instalá-los no RStudio procurando por eles no separador Packages:

ou executando o seguinte código (um a um) na consola:

install.packages("tidyverse")
install.packages("readxl")

install.packages("sf")
install.packages("mapview")
install.packages("tidytransit")
install.packages("gtfsrouter") # opcional

install.packages("r5r")
install.packages("interp")
install.packages("rJavaEnv")

install.packages("rmarkdown") # opcional
install.packages("osmextract") # opcional
install.packages("stplanr") # opcional

2.4 Java Development Kit

Para utilizar o pacote {r5r} é necessário ter o Java Development Kit (JDK) 21 instalado no computador. Existem inúmeras implementações de código aberto do JDK. A maneira mais fácil de instalar o JDK é usando o novo pacote {rJavaEnv} no R.

# verificar a versão de Java atualmente instalada (se existir) 
rJavaEnv::java_check_version_rjava()

## se esta for a primeira vez que utiliza {rJavaEnv}, poderá ter de executar
## este código abaixo para consentir a instalação de Java
rJavaEnv::rje_consent(provided = TRUE)

# instalar Java 21
rJavaEnv::java_quick_install(
  version = 21,
  distribution = 'Corretto')

# verificar se o Java foi instalado com sucesso
rJavaEnv::java_check_version_rjava()

Em alternativa, pode transferir e instalar manualmente o JDK 21.

Windows e MacOS

Aceda a Java Development Kit 21, transfira a última versão 21 correspondente ao seu sistema operativo e execute o ficheiro executável.

--- eval: false code-fold: false engine: knitr --- # Software Neste capítulo vamos guiá-lo através da instalação do R, do RStudio e dos pacotes necessários para estas aulas. O **R** e o **RStudio** são softwares que necessitam de download e instalação separados. ## R O **R** ou **R stats** (como também é conhecido) é uma linguagem de programação e um ambiente de software livre para computação estatística e gráficos apoiado pela R Foundation for Statistical Computing. Os links para download estão no [The Comprehensive R Archive Network](https://cran.r-project.org/) (aka CRAN). A versão mais recente é a `4.4.2`, mas pode usar `>= 4.1.x` se já a tiver instalada. :::: {.panel-tabset .nav-pills} ### Windows [Download R-4.4.2 para Windows](https://cran.r-project.org/bin/windows/base/R-4.4.2-win.exe) e correr o ficheiro executável. ::: {.callout-important icon="false"} Deverá também instalar o [Rtools](https://cran.r-project.org/bin/windows/Rtools/rtools44/rtools.html), que é uma coleção de ferramentas necessárias para construir pacotes R no Windows.\ Escolha o segundo link para processador ARM (mais recente), e o primeiro link caso contrário. ::: ### Mac [Download R-4.4.2 para MacOX](https://cran.r-project.org/bin/macosx/). Terá de escolher entre a versão *arm64* ou a versão *x86-64*. Transfira o ficheiro `.pkg` e instale-o como habitualmente. :::: Após esta instalação, não é necessário abrir o R. Prossiga com a instalação do RStudio. ## RStudio O RStudio Desktop é um ambiente de desenvolvimento integrado (IDE) para o **R**. Inclui uma consola, um editor de código com realce para as funções de bases, bem como ferramentas para fazer gráficos, e análises estatísticas. O RStudio está disponível para descarregamento gratuito em [Posit RStudio](https://posit.co/download/rstudio-desktop/). ::: {.panel-tabset .nav-pills} ### Windows 10/11 [Download RStudio 2024.09](https://download1.rstudio.org/electron/windows/RStudio-2024.09.1-394.exe) e correr o ficheiro executável. ### MacOS [Download RStudio 2024.09](https://download1.rstudio.org/electron/macos/RStudio-2024.09.1-394.dmg) e instale-o como habitualmente. ::: ## Pacotes de R Terá de instalar alguns pacotes para trabalhar com os dados e os scripts destas aulas. Pode instalá-los no RStudio procurando por eles no separador **Packages**: ![](images/clipboard-812808100.png){width="394"} **ou** executando o seguinte código (um a um) na consola: ```{r} install.packages("tidyverse") install.packages("readxl") install.packages("sf") install.packages("mapview") install.packages("tidytransit") install.packages("gtfsrouter") # opcional install.packages("r5r") install.packages("interp") install.packages("rJavaEnv") install.packages("rmarkdown") # opcional install.packages("osmextract") # opcional install.packages("stplanr") # opcional ``` ## Java Development Kit Para utilizar o pacote `{r5r}` é necessário ter o *Java Development Kit (JDK) 21* instalado no computador. Existem inúmeras implementações de código aberto do JDK. A maneira mais fácil de instalar o JDK é usando o novo pacote [{rJavaEnv}](https://www.ekotov.pro/rJavaEnv/) no R. ```{r} # verificar a versão de Java atualmente instalada (se existir) rJavaEnv::java_check_version_rjava() ## se esta for a primeira vez que utiliza {rJavaEnv}, poderá ter de executar ## este código abaixo para consentir a instalação de Java rJavaEnv::rje_consent(provided = TRUE) # instalar Java 21 rJavaEnv::java_quick_install( version = 21, distribution = 'Corretto') # verificar se o Java foi instalado com sucesso rJavaEnv::java_check_version_rjava() ``` **Em alternativa**, pode transferir e instalar manualmente o JDK 21. ::: {.panel-tabset .nav-pills} ### Windows e MacOS Aceda a [Java Development Kit 21](https://jdk.java.net/archive/), transfira a última versão 21 correspondente ao seu sistema operativo e execute o ficheiro executável. :::