Informações Gerais

Esse é um workshop baseado no Data Carpentry, um módulo do The Carpentries voltado para o desenvolvimento e ensino de abilidades relacionadas a dados. O público alvo são alunos e pesquisadores com pouca ou nenhuma experiência computacional prévia, visando capacitá-los para aplicar as novas abilidades rapidamente em sua própria pesquisa.

Para mais informações sobre o quê se ensina no The Carpentries e por quê, veja o paper "Good Enough Practices for Scientific Computing".

Onde: Esse minicurso será online. Passaremos o link de conexão por email aos participantes registrados pelo site do EBRAM.

Quando: 04-05 Out, 2021. Adicione ao seu Calendário do Google.

Pré-requisitos: Os participantes precisarão de um computador com sistema operacional Mac, Linux, ou Windows no qual tenham permissão para instalar novos programas. Siga as instruções de instalação dos programas abaixo.

Accessibilidade: Queremos que esse minicurso seja um ambiente positivo e acessível a todos. Por favor entre em contato antes da data de início se houver alguma coisa que possamos fazer para tornar o evento mais acessível para você.

Contato: Escreva para Tauana Cunha CunhaT@si.edu para mais informações.

Quem pode participar?: Inscrição nesse minicurso é aberta para participantes do XXVII EBRAM.

---

Código de Conduta

Espera-se que todos os participantes respeitem o Código de Conduta do The Carpentries.

Programa

---

Caderno de Notas Colaborativo

Vamos usar esse documento colaborativo para tomar notas, compartilhar links e código.

---

Preparação necessária antes do minicurso

Configure seu espaço de trabalho

Esse minicurso segue o modelo de live-coding do The Carpentries, ou seja, programação em tempo real acompanhando os instrutores. Para isso, você precisará ter na tela tanto a janela do programa que vamos usar (RStudio, Excel etc.) como a janela do Zoom. Para ver as duas ao mesmo tempo, recomendamos uma das seguintes opções:

• Dois monitores: Se você tem dois monitores disponíveis (outro monitor ou TV com cabo para conectar no computador), planeje para manter o software de interesse em um dos monitores, e a janela do Zoom no outro.
• Dois aparelhos: Se um segundo monitor não está disponível, você tem algum outro aparelho (tablet, celular) com uma tela de tamanho razoável? Caso sim, tente usar a tela menor para o vídeo e a tela do computador para acompanhar o programa sobre o qual vamos aprender.
• Divida sua tela: Pratique ter as duas janelas abertas ao mesmo tempo (a janela do Zoom e a do RStudio). Qual a melhor disposição das duas janelas na sua tela? Será que é melhor alternar entre as duas janelas com um atalho do teclado? Teste com antencedência para encontrar o melhor ajuste para você, e para que sua experiência durante o minicurso seja a melhor possível.

A seguinte página do The Carpentries dá mais detalhes sobre como configurar sua tela durante o workshop.

R and RStudio

R e RStudio são instalados separadamente. R é o ambiente de programação por trás do RStudio, mas usar o R sozinho é pouco prático. RStudio é uma interface gráfica que faz o uso do R mais fácil e interativo. É necessário instalar o R antes de instalar o RStudio. Depois da instalação dos dois programas, temos que baixar também um pacote específico de R. Siga as instruções abaixo de acordo com seu sistema operacional, e depois veja ao fim da página sobre como instalar o pacote tidyverse.

Uma lista de erros comuns que podem ocorrer durante a instalação é encontrada nessa página (em inglês) do The Carpentries: Configuration Problems and Solutions wiki page.

Windows

Se você já tem R e RStudio instalados

• Abra o RStudio e clique em “Help” > “Check for updates”. Se uma nova versão estiver disponível, feche o RStudio e baixe a última versão.

• Para checar qual versão do R você está usando, abra o RStudio e a primeira mensagem que aparece no console indica a sua versão atual. Digitar sessionInfo() no console também mostrará a versão do R. Cheque no site do CRAN se uma versão de R mais recente está disponível. Caso sim, baixe e instale essa nova versão. Caso queira, você pode ver como remover versões antigas do R do seu computador.

• Siga os passos para todos no final dessa página.

Se você não tem R e RStudio instalados

• Baixe o R do site do CRAN.
• Abra o arquivo .exe que foi baixado.
• Visite a página de download do RStudio.
• Na seção Installers, selecione RStudio x.yy.zzz - Windows Vista/7/8/10 (onde x, y, and z representam o número da versão)
• Clique no link para instalar.

• Uma vez instalado, abra o RStudio para garantir que está funcionando e que nenhuma mensagem de erro aparece.

• Siga os passos para todos no final dessa página.

macOS

Se você já tem R e RStudio instalados

• Abra o RStudio e clique em “Help” > “Check for updates”. Se uma nova versão estiver disponível, feche o RStudio e baixe a última versão.

• Para checar qual versão do R você está usando, abra o RStudio e a primeira mensagem que aparece no console indica a sua versão atual. Digitar sessionInfo() no console também mostrará a versão do R. Cheque no site do CRAN se uma versão de R mais recente está disponível. Caso sim, baixe e instale essa nova versão.

• Siga os passos para todos no final dessa página.

Se você não tem R e RStudio instalados

• Baixe o R do site do CRAN.
• Selecione o arquivo .pkg para a versão mais recente. Clique no arquivo que foi baixado no seu computador para instalar o R. Também é uma boa ideia baixar o XQuartz, usado por alguns pacotes.
• Visite a página de download do RStudio.
• Na seção Installers, selecione RStudio x.yy.zzz - Mac OS X 10.6+ (64-bit) (onde x, y, and z representam o número da versão)
• Clique no arquivo que foi baixado no seu computador para instalar o RStudio.

• Uma vez instalado, abra o RStudio para garantir que está funcionando e que nenhuma mensagem de erro aparece.

• Siga os passos para todos no final dessa página.

Linux

Instruções Linux

• Siga as instruções para sua distribuição a partir do CRAN, onde é fornecida informação para baixar a versão mais recent do R para as distribuições mais comuns. Para a maioria das distribuições, você pode usar seu gerenciador de programas (e.g., para Debian/Ubuntu use sudo apt-get install r-base, e para Fedora sudo yum install R), mas nós não recomendamos essa estratégia porque as versões disponíveis normalmente estão desatualizadas.
• Visite a página de download do RStudio.
• Na seção Installers, selecione a versão compatível com sua distribuição e instale com seu método preferido (e.g., com Debian/Ubuntu sudo dpkg -i rstudio-x.yy.zzz-amd64.deb no terminal).

• Uma vez instalado, abra o RStudio para garantir que está funcionando e que nenhuma mensagem de erro aparece.

• Siga os passos para todos no final dessa página.

Para todos

• Depois de ter instalado o R e o RStudio, vamos instalar o pacote tidyverse. Abra o RStudio clicando no ícone do programa no seu computador e digite: install.packages("tidyverse"). Você também pode instalar pacotes indo em Tools -> Install Packages e digitando o nome do pacote.

Recursos adicionais

Abaixo estão links para livros online, tutoriais, comunidades de discussão, e galerias de gráficos para servir de inspiração e fonte de código.

Livros:

• Big Book of R, por Oscar Baruffa
• R for Beginners, por Emmanuel Paradis
• R para Principiantes, por Emmanuel Paradis
• Introdução ao R, por Sergio Miranda Freire
• R for Data Science - R4DS

Galerias de gráficos ggplot2:

• The R Graph Gallery - vá em ALL no menu para ver todos direto na tela!
• Top 50 ggplot2 Visualizations - The Master List (With Full R Code)
• ggplot2 extensions - gallery

Onde buscar ajuda:

• Stack Overflow (com frequência é um dos primeiros resultados quando procuramos ajuda direto no Google)
• Rseek