# Workshop Análise Textual em R para dados turísticos

Olá Pessoal,

Você se inscreveu no *Workshop Análise Textual em R para dados turísticos*. Ele será realizado no dia 19 de outubro de 2022, das 9:00 às 12:00 hs.

### 1. Material

Todos os arquivos, aulas, dados e algumas bibliografias serão disponibilizados em uma pasta do Google Drive, nesse [link](https://drive.google.com/drive/folders/14rd4pVd8qWQbV4h1vUvIhEqtTb89NMX4?usp=sharing).

### 2. Instalação dos softwares

Teremos uma breve introdução teórica e em seguida passaremos para a parte prática, que será realizada no software R, utilizando a interface RStudio.

Se você ainda não tem os softwares instalados, visite esse [link R](http://www.vps.fmvz.usp.br/CRAN/) para instalar o R e esse [link RStudio](https://www.rstudio.com/products/rstudio/download/#download) para instalar o RStudio. Escolha a versão conforme o sistema operacional de sua máquina (windows, mac, linux...) e siga a instalação padrão.

### 3. Instalação dos pacotes

#### 3.1 Instalação básica

Será preciso instalar alguns pacotes. Faça isso antes de iniciar o curso, pois pode ser que a internet esteja instável. Para isso, abra o software RStudio e clique em File/New File/R Script como mostra a imagem abaixo.


Em seguida, copie e cole o seguinte comando no script (como mostra a figura):

if(!require(pacman)) install.packages("pacman")
pacman::p_load(devtools, rvest, httr, XML, dplyr, textreuse, rslp, 
tm, proxy, factoextra, text2vec, ngram, ggplot2, stringr, stringi, 
cluster, dendextend, wordcloud, wordcloud2, rmarkdown, knitr, gridExtra,
kableExtra, textreuse, syuzhet, RColorBrewer, tidyverse,  reshape2, 
lexiconPT, textdata, tidyr, scales, broom, purrr, widyr, igraph, 
ggraph, SnowballC, RWekajars)


Depois, selecione o código e clique em ***run***.

---

**PS1.** Pode ser que seja preciso rodar o ***run*** duas vezes, porque em algumas máquinas ele não reconhece o *pacman* de primeira.

---

**PS2.** **Para usuários do Windows**, talvez seja preciso instalar o Rtools. Para isso acesse esse [link](https://cran.r-project.org/bin/windows/Rtools/rtools42/rtools.html) e clique em **Rtools42 installer**.

---

Se der tudo certo, os pacotes aparecerão na aba **Packages** do quadro inferior direito do seu RStudio, após você clicar no símbolo **refresh** como mostra a figura:


#### 3.2. Instalação de versões de pacotes incompatíveis com a versão atual do R

Alguns pacotes não têm suporte para as versões mais atuais do R. Nesse caso, o procedimento para instalação é um pouco diferente. É necessário que visitemos a página de arquivos de pacotes, nesse [link](https://cran.r-project.org/src/contrib/Archive), para procurar o arquivo **.tar.gz** do pacote que pretendemos instalar.
No nosso caso, precisamos ainda dos pacotes **ANLP** e **smdc**.

Então, rodamos o seguinte comando, indicando o link do pacote:

#Para instalar o pacote "smdc"
packageurl <- "http://cran.r-project.org/src/contrib/Archive/smdc/smdc_0.0.2.tar.gz"
install.packages(packageurl, repos=NULL, type="source", dependencies=TRUE)

#Para instalar o pacote "ANLP"
packageurl <- "https://cran.r-project.org/src/contrib/Archive/ANLP/ANLP_1.3.tar.gz"
install.packages(packageurl, repos=NULL, type="source", dependencies=TRUE)

#### 3.3. Instalação dos pacotes via GitHub

Existem alguns pacotes que ainda estão em desenvolvimento e, por isso, para usá-los temos que instalá-los direto do GitHub. Nesses casos, o melhor a fazer é seguir o próprio guia do pacote, já que a instalação varia de acordo com cada desenvolvedor.

No nosso caso, instalaremos o **SentimentBR** e o **subtools**, através dos seguintes comandos:

# Para instalar o subtools
devtools::install_github("fkeck/subtools")

# Para instalar o sentimentBR
install.packages('Rstem', repos = "http://www.omegahat.net/R")
devtools::install_github("jodavid/sentimentBR")

Pode ser que você não consiga instalar o **SentimentBR** direto via internet. Então precisará baixar o arquivo no seu computador e seguir os seguintes comandos:

# Instalação do pacote de dependência
# Faz o download do pacote aqui do repositório pelo link:
# https://github.com/Jodavid/sentimentBR/blob/main/Rstem_0.4-1.tar.gz
# e instala como pacote local substituindo XXX pelo local do arquivo
install.packages("XXX/Rstem_0.4-1.tar.gz", repos = NULL, type = "source")

# Instação do pacote sentimentBR
devtools::install_github("jodavid/sentimentBR")

### 4. Possíveis erros

Alguns pacotes precisam de outros para serem instalados. Nesse caso, o próprio R já indica na mensagem de erro qual pacote está faltando.

Se isso acontecer, basta você instalar o pacote indicado usando o comando ```install.packages("NomeDoPacoteEntreAspas")``` e rodar novamente o comando para a instalação do pacote que pretendia antes do erro.

**Caso você tenha dificuldades nos processos de instalação do R, RStudio ou de algum pacote, não hesite em escrever para [e-mail] para esclarecer sua dúvida.** :wink:

Para aqueles que não tem experiência com o R, NÃO SE ASSUSTE. Ele é legalzinho! Aprenderemos do começo :slightly_smiling_face:

Até logo!
Abraços,