Curso de R DaTax

Domine R para Análise de Administração Tributária

Boas-vindas

Este curso ensina programação prática em R para administração tributária. Você aprenderá a analisar dados de contribuintes, automatizar relatórios e criar visualizações profissionais—nenhuma experiência em programação necessária.

Desenvolvido pela equipe DaTax do Banco Mundial para administradores tributários em todo o mundo.

O Que Você Aprenderá

Ao final deste curso, você será capaz de:

🎯 Objetivos de Aprendizagem

Gestão de Dados - Importar e exportar conjuntos de dados tributários (CSV, Excel, múltiplos formatos de arquivo) - Limpar e transformar registros de contribuintes eficientemente - Lidar com milhões de linhas com confiança

Análise de Dados - Filtrar e subdividir populações de contribuintes - Calcular estatísticas tributárias e métricas de conformidade - Agrupar e resumir dados por regiões, setores ou períodos de tempo - Mesclar conjuntos de dados de diferentes sistemas tributários

Visualização de Dados - Criar gráficos profissionais para relatórios e apresentações - Visualizar tendências de receita tributária, taxas de conformidade e distribuições - Projetar gráficos prontos para publicação com ggplot2

Fluxos de Trabalho Reproduzíveis - Escrever scripts R claros e documentados - Automatizar tarefas de análise repetitivas - Compartilhar análises reproduzíveis com colegas

Por Que Aprender R para Administração Tributária?

Gratuito e de Código Aberto: Sem custos de licenciamento para sua organização
Poderoso: Lidar com conjuntos de dados com milhões de registros de contribuintes
Reproduzível: Cada etapa da análise é documentada e repetível
Eficiente: Automatizar relatórios mensais e análises de rotina
Em Crescimento: Grande comunidade de usuários em governo e pesquisa

Pré-requisitos

✓ O Que Você Precisa

Necessário - Um computador com R e RStudio instalados (veja o guia de instalação abaixo) - Habilidades básicas de informática (abrir arquivos, usar pastas) - Conexão à internet para baixar materiais do curso

NÃO Necessário - Nenhuma experiência em programação necessária - Nenhum conhecimento de estatística necessário - Nenhum conhecimento prévio de R ou qualquer linguagem de programação

Este curso é projetado para iniciantes completos. Se você pode trabalhar com Excel, você pode aprender R.

Estrutura do Curso

O curso consiste em 5 módulos sequenciais projetados para desenvolver suas habilidades progressivamente:

Módulo 1: Introdução ao R — Aprenda os fundamentos de R, interface do RStudio, variáveis e tipos de dados fundamentais.

Módulo 2: Importação e Exportação de Dados — Domine a leitura de arquivos CSV e Excel, lide com diferentes formatos de arquivo e exporte resultados.

Módulo 3: Manipulação de Dados com dplyr — Transforme conjuntos de dados com filtragem, seleção, criação de variáveis e resumo.

Módulo 4: Reestruturação e Junção de Dados — Reestruture dados entre formatos amplo e longo. Combine múltiplos conjuntos de dados.

Módulo 5: Visualização de Dados com ggplot2 — Crie gráficos profissionais e comunique insights efetivamente.

Cada módulo inclui explicações passo a passo, exercícios práticos com dados tributários reais, scripts modelo e soluções completas.

Começando

Passo 1: Instalar R e RStudio

Você precisa instalar dois programas: R (a linguagem de programação) e RStudio (a interface que torna o R fácil de usar).

Importante: Ordem de Instalação

Sempre instale o R primeiro, depois o RStudio. O RStudio precisa que o R já esteja instalado no seu computador.

Instalando o R

Visite o site do R
Vá para https://cloud.r-project.org/
Clique em “Download R for Windows”
Você verá este link perto do topo da página
Clique em “base” ou “install R for the first time”
Isso leva você à página de download para a instalação básica do R
Clique em “Download R-4.x.x for Windows”
(O número da versão será diferente, por exemplo, R-4.4.1)
Isso baixa um arquivo .exe (geralmente para sua pasta Downloads)
Execute o instalador
- Clique duas vezes no arquivo .exe baixado
- Se o Windows perguntar “Você deseja permitir que este aplicativo faça alterações?”, clique em Sim
- Escolha Português (ou seu idioma preferido)
- Clique em Avançar em todas as telas, aceitando as opções padrão
- Clique em Concluir quando a instalação for concluída
Verifique a instalação
- Procure o ícone do R na sua área de trabalho ou no menu Iniciar
- Você não precisa abrir o R diretamente—você usará o RStudio em vez disso

Visite o site do R
Vá para https://cloud.r-project.org/
Clique em “Download R for macOS”
Você verá este link perto do topo da página
Escolha a versão correta para o seu Mac
- Para Macs mais novos (chips M1, M2, M3): Baixe o arquivo que diz “Apple silicon arm64”
- Para Macs mais antigos (processadores Intel): Baixe o arquivo que diz “Intel 64-bit”
- Se você não tem certeza de qual você tem, clique no menu Apple () → “Sobre Este Mac” → procure em “Chip” ou “Processador”
Baixe o arquivo .pkg
Clique no link apropriado (por exemplo, R-4.4.1-arm64.pkg ou R-4.4.1-x86_64.pkg)
O arquivo será baixado para sua pasta Downloads
Execute o instalador
- Clique duas vezes no arquivo .pkg baixado
- Clique em Continuar nas telas de introdução
- Clique em Concordar com a licença
- Clique em Instalar (você pode precisar inserir sua senha do Mac)
- Clique em Fechar quando a instalação for concluída
Instale o XQuartz (pode ser necessário)
- Alguns pacotes R precisam do XQuartz
- Baixe-o de https://www.xquartz.org/
- Instale-o da mesma maneira (clique duas vezes no arquivo .pkg)
- Reinicie seu computador após instalar o XQuartz
Verifique a instalação
- Procure o R na sua pasta Aplicativos
- Você não precisa abrir o R diretamente—você usará o RStudio em vez disso

Visite o site do R
Vá para https://cloud.r-project.org/
Clique em “Download R for Linux”
Escolha sua distribuição Linux (Ubuntu, Debian, Fedora, etc.)

Siga as instruções da sua distribuição

Para Ubuntu/Debian:

# Update package list
sudo apt update

# Install R
sudo apt install r-base r-base-dev

Para Fedora:

sudo dnf install R

Verifique a instalação
Abra um terminal e digite R --version
Você deve ver as informações da versão do R

Instalando o RStudio

Agora que o R está instalado, você pode instalar o RStudio:

Visite o site do RStudio
Vá para https://posit.co/download/rstudio-desktop/
Role para baixo até “All Installers”
Procure a tabela mostrando diferentes versões
Clique no instalador do Windows
Encontre a linha que diz “Windows 10/11” e clique no link de download
Isso baixa um arquivo .exe (por exemplo, RStudio-2024.xx.x-xxx.exe)
Execute o instalador
- Clique duas vezes no arquivo .exe baixado
- Se o Windows pedir permissão, clique em Sim
- Clique em Avançar em todas as telas, aceitando os padrões
- Clique em Instalar
- Clique em Concluir quando completo
Inicie o RStudio
- Encontre o ícone do RStudio na sua área de trabalho ou menu Iniciar
- Clique duas vezes para abrir o RStudio
- Você deve ver uma janela com múltiplos painéis—isso é o RStudio!

Visite o site do RStudio
Vá para https://posit.co/download/rstudio-desktop/
Role para baixo até “All Installers”
Procure a tabela mostrando diferentes versões
Clique no instalador do macOS
Encontre a linha que diz “macOS 11+” e clique no link de download
Isso baixa um arquivo .dmg
Instale o RStudio
- Clique duas vezes no arquivo .dmg baixado
- Uma janela abre mostrando o ícone do RStudio e a pasta Aplicativos
- Arraste o ícone do RStudio para dentro da pasta Aplicativos
- Aguarde a cópia ser concluída
- Ejete a imagem de disco do RStudio (se aparecer na sua área de trabalho)
Inicie o RStudio
- Vá para a pasta Aplicativos
- Clique duas vezes no RStudio
- Se o Mac disser “RStudio não pode ser aberto porque é de um desenvolvedor não identificado”:
  - Abra Preferências do Sistema → Segurança e Privacidade
  - Clique em “Abrir Assim Mesmo” ao lado da mensagem do RStudio
  - Clique em Abrir no diálogo de confirmação
- Você deve ver o RStudio abrir com múltiplos painéis

Visite o site do RStudio
Vá para https://posit.co/download/rstudio-desktop/
Baixe o instalador para sua distribuição

Para Ubuntu/Debian:
- Baixe o arquivo .deb
- Instale com: sudo dpkg -i rstudio-2024.xx.x-amd64.deb
- Se você receber erros de dependência, execute: sudo apt-get install -f
Para Fedora/RedHat:
- Baixe o arquivo .rpm
- Instale com: sudo dnf install rstudio-2024.xx.x-x86_64.rpm
Inicie o RStudio
Digite rstudio no terminal ou encontre-o no seu menu de aplicativos

Verifique Se Tudo Funciona

Abra o RStudio (não o R—você sempre usará o RStudio)
Você deve ver 4 painéis:
- Console (esquerda ou inferior esquerdo)
- Ambiente/Histórico (superior direito)
- Arquivos/Gráficos/Ajuda (inferior direito)
- Editor de script (superior esquerdo, pode não aparecer até você abrir um arquivo)
Teste o R digitando no Console:
```
2 + 2
```
Pressione Enter. Você deve ver [1] 4
Se você ver o resultado, parabéns! R e RStudio estão funcionando corretamente.

Instalação Bem-sucedida?

Se você viu [1] 4 aparecer no seu console, você está pronto para começar a aprender!

Tendo problemas? Problemas comuns: - RStudio não abre: Certifique-se de ter instalado o R primeiro - Console diz “R não encontrado”: Reinstale o R, depois reinicie o RStudio - Segurança do Mac bloqueia o RStudio: Vá para Preferências do Sistema → Segurança e Privacidade → clique em “Abrir Assim Mesmo”

Passo 2: Baixar Materiais do Curso

Visite a página de Materiais Didáticos para baixar: - Modelos de exercícios (arquivos .R) - Scripts de solução (arquivos .R)
- Conjuntos de dados tributários de amostra - Guias de referência rápida

Passo 3: Começar a Aprender

Clique em “1. Introdução ao R” na barra lateral esquerda para começar seu primeiro módulo.

Trabalhe nos módulos sequencialmente—cada um se baseia em conceitos das lições anteriores.

Pronto para Começar?

🚀 Inicie Sua Jornada com R

Você tem R e RStudio instalados. Você sabe onde encontrar os materiais do curso.

Agora clique em “1. Introdução ao R” no menu da barra lateral para começar o Módulo 1.

Lembre-se: todo especialista já foi um iniciante. Reserve seu tempo, pratique consistentemente e não hesite em experimentar!

Desenvolvido pela Equipe DaTax do Banco Mundial | Ver no GitHub

De volta ao topo

--- title: "Curso de R DaTax" subtitle: "Domine R para Análise de Administração Tributária" format: html --- ## Boas-vindas Este curso ensina programação prática em R para administração tributária. Você aprenderá a analisar dados de contribuintes, automatizar relatórios e criar visualizações profissionais—nenhuma experiência em programação necessária. Desenvolvido pela equipe DaTax do Banco Mundial para administradores tributários em todo o mundo. --- ## O Que Você Aprenderá Ao final deste curso, você será capaz de: ::: {.callout-note icon=false} ## 🎯 Objetivos de Aprendizagem **Gestão de Dados** - Importar e exportar conjuntos de dados tributários (CSV, Excel, múltiplos formatos de arquivo) - Limpar e transformar registros de contribuintes eficientemente - Lidar com milhões de linhas com confiança **Análise de Dados** - Filtrar e subdividir populações de contribuintes - Calcular estatísticas tributárias e métricas de conformidade - Agrupar e resumir dados por regiões, setores ou períodos de tempo - Mesclar conjuntos de dados de diferentes sistemas tributários **Visualização de Dados** - Criar gráficos profissionais para relatórios e apresentações - Visualizar tendências de receita tributária, taxas de conformidade e distribuições - Projetar gráficos prontos para publicação com ggplot2 **Fluxos de Trabalho Reproduzíveis** - Escrever scripts R claros e documentados - Automatizar tarefas de análise repetitivas - Compartilhar análises reproduzíveis com colegas ::: ### Por Que Aprender R para Administração Tributária? - **Gratuito e de Código Aberto**: Sem custos de licenciamento para sua organização - **Poderoso**: Lidar com conjuntos de dados com milhões de registros de contribuintes - **Reproduzível**: Cada etapa da análise é documentada e repetível - **Eficiente**: Automatizar relatórios mensais e análises de rotina - **Em Crescimento**: Grande comunidade de usuários em governo e pesquisa --- ## Pré-requisitos ::: {.callout-important icon=false} ## ✓ O Que Você Precisa **Necessário** - Um computador com R e RStudio instalados (veja o guia de instalação abaixo) - Habilidades básicas de informática (abrir arquivos, usar pastas) - Conexão à internet para baixar materiais do curso **NÃO Necessário** - Nenhuma experiência em programação necessária - Nenhum conhecimento de estatística necessário - Nenhum conhecimento prévio de R ou qualquer linguagem de programação ::: Este curso é projetado para iniciantes completos. Se você pode trabalhar com Excel, você pode aprender R. --- ## Estrutura do Curso O curso consiste em **5 módulos sequenciais** projetados para desenvolver suas habilidades progressivamente: **Módulo 1: Introdução ao R** — Aprenda os fundamentos de R, interface do RStudio, variáveis e tipos de dados fundamentais. **Módulo 2: Importação e Exportação de Dados** — Domine a leitura de arquivos CSV e Excel, lide com diferentes formatos de arquivo e exporte resultados. **Módulo 3: Manipulação de Dados com dplyr** — Transforme conjuntos de dados com filtragem, seleção, criação de variáveis e resumo. **Módulo 4: Reestruturação e Junção de Dados** — Reestruture dados entre formatos amplo e longo. Combine múltiplos conjuntos de dados. **Módulo 5: Visualização de Dados com ggplot2** — Crie gráficos profissionais e comunique insights efetivamente. Cada módulo inclui explicações passo a passo, exercícios práticos com dados tributários reais, scripts modelo e soluções completas. --- ## Começando ### Passo 1: Instalar R e RStudio Você precisa instalar dois programas: **R** (a linguagem de programação) e **RStudio** (a interface que torna o R fácil de usar). ::: {.callout-warning} ## Importante: Ordem de Instalação Sempre instale o **R primeiro**, depois o **RStudio**. O RStudio precisa que o R já esteja instalado no seu computador. ::: #### Instalando o R ::: {.panel-tabset} ## Windows 1. **Visite o site do R** Vá para [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Clique em "Download R for Windows"** Você verá este link perto do topo da página 3. **Clique em "base" ou "install R for the first time"** Isso leva você à página de download para a instalação básica do R 4. **Clique em "Download R-4.x.x for Windows"** (O número da versão será diferente, por exemplo, R-4.4.1) Isso baixa um arquivo `.exe` (geralmente para sua pasta Downloads) 5. **Execute o instalador** - Clique duas vezes no arquivo `.exe` baixado - Se o Windows perguntar "Você deseja permitir que este aplicativo faça alterações?", clique em **Sim** - Escolha **Português** (ou seu idioma preferido) - Clique em **Avançar** em todas as telas, aceitando as opções padrão - Clique em **Concluir** quando a instalação for concluída 6. **Verifique a instalação** - Procure o ícone do R na sua área de trabalho ou no menu Iniciar - Você não precisa abrir o R diretamente—você usará o RStudio em vez disso ## Mac 1. **Visite o site do R** Vá para [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Clique em "Download R for macOS"** Você verá este link perto do topo da página 3. **Escolha a versão correta para o seu Mac** - **Para Macs mais novos (chips M1, M2, M3)**: Baixe o arquivo que diz "Apple silicon arm64" - **Para Macs mais antigos (processadores Intel)**: Baixe o arquivo que diz "Intel 64-bit" - Se você não tem certeza de qual você tem, clique no menu Apple () → "Sobre Este Mac" → procure em "Chip" ou "Processador" 4. **Baixe o arquivo `.pkg`** Clique no link apropriado (por exemplo, `R-4.4.1-arm64.pkg` ou `R-4.4.1-x86_64.pkg`) O arquivo será baixado para sua pasta Downloads 5. **Execute o instalador** - Clique duas vezes no arquivo `.pkg` baixado - Clique em **Continuar** nas telas de introdução - Clique em **Concordar** com a licença - Clique em **Instalar** (você pode precisar inserir sua senha do Mac) - Clique em **Fechar** quando a instalação for concluída 6. **Instale o XQuartz (pode ser necessário)** - Alguns pacotes R precisam do XQuartz - Baixe-o de [https://www.xquartz.org/](https://www.xquartz.org/) - Instale-o da mesma maneira (clique duas vezes no arquivo `.pkg`) - Reinicie seu computador após instalar o XQuartz 7. **Verifique a instalação** - Procure o R na sua pasta Aplicativos - Você não precisa abrir o R diretamente—você usará o RStudio em vez disso ## Linux 1. **Visite o site do R** Vá para [https://cloud.r-project.org/](https://cloud.r-project.org/) 2. **Clique em "Download R for Linux"** Escolha sua distribuição Linux (Ubuntu, Debian, Fedora, etc.) 3. **Siga as instruções da sua distribuição** **Para Ubuntu/Debian:** ```bash # Update package list sudo apt update # Install R sudo apt install r-base r-base-dev ``` **Para Fedora:** ```bash sudo dnf install R ``` 4. **Verifique a instalação** Abra um terminal e digite `R --version` Você deve ver as informações da versão do R ::: #### Instalando o RStudio Agora que o R está instalado, você pode instalar o RStudio: ::: {.panel-tabset} ## Windows 1. **Visite o site do RStudio** Vá para [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/) 2. **Role para baixo até "All Installers"** Procure a tabela mostrando diferentes versões 3. **Clique no instalador do Windows** Encontre a linha que diz "Windows 10/11" e clique no link de download Isso baixa um arquivo `.exe` (por exemplo, `RStudio-2024.xx.x-xxx.exe`) 4. **Execute o instalador** - Clique duas vezes no arquivo `.exe` baixado - Se o Windows pedir permissão, clique em **Sim** - Clique em **Avançar** em todas as telas, aceitando os padrões - Clique em **Instalar** - Clique em **Concluir** quando completo 5. **Inicie o RStudio** - Encontre o ícone do RStudio na sua área de trabalho ou menu Iniciar - Clique duas vezes para abrir o RStudio - Você deve ver uma janela com múltiplos painéis—isso é o RStudio! ## Mac 1. **Visite o site do RStudio** Vá para [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/) 2. **Role para baixo até "All Installers"** Procure a tabela mostrando diferentes versões 3. **Clique no instalador do macOS** Encontre a linha que diz "macOS 11+" e clique no link de download Isso baixa um arquivo `.dmg` 4. **Instale o RStudio** - Clique duas vezes no arquivo `.dmg` baixado - Uma janela abre mostrando o ícone do RStudio e a pasta Aplicativos - **Arraste o ícone do RStudio para dentro da pasta Aplicativos** - Aguarde a cópia ser concluída - Ejete a imagem de disco do RStudio (se aparecer na sua área de trabalho) 5. **Inicie o RStudio** - Vá para a pasta Aplicativos - Clique duas vezes no RStudio - Se o Mac disser "RStudio não pode ser aberto porque é de um desenvolvedor não identificado": - Abra Preferências do Sistema → Segurança e Privacidade - Clique em "Abrir Assim Mesmo" ao lado da mensagem do RStudio - Clique em **Abrir** no diálogo de confirmação - Você deve ver o RStudio abrir com múltiplos painéis ## Linux 1. **Visite o site do RStudio** Vá para [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/) 2. **Baixe o instalador para sua distribuição** **Para Ubuntu/Debian:** - Baixe o arquivo `.deb` - Instale com: `sudo dpkg -i rstudio-2024.xx.x-amd64.deb` - Se você receber erros de dependência, execute: `sudo apt-get install -f` **Para Fedora/RedHat:** - Baixe o arquivo `.rpm` - Instale com: `sudo dnf install rstudio-2024.xx.x-x86_64.rpm` 3. **Inicie o RStudio** Digite `rstudio` no terminal ou encontre-o no seu menu de aplicativos ::: #### Verifique Se Tudo Funciona 1. **Abra o RStudio** (não o R—você sempre usará o RStudio) 2. **Você deve ver 4 painéis:** - Console (esquerda ou inferior esquerdo) - Ambiente/Histórico (superior direito) - Arquivos/Gráficos/Ajuda (inferior direito) - Editor de script (superior esquerdo, pode não aparecer até você abrir um arquivo) 3. **Teste o R digitando no Console:** ```r 2 + 2 ``` Pressione Enter. Você deve ver `[1] 4` 4. **Se você ver o resultado, parabéns!** R e RStudio estão funcionando corretamente. ::: {.callout-tip} ## Instalação Bem-sucedida? Se você viu `[1] 4` aparecer no seu console, você está pronto para começar a aprender! Tendo problemas? Problemas comuns: - **RStudio não abre**: Certifique-se de ter instalado o R primeiro - **Console diz "R não encontrado"**: Reinstale o R, depois reinicie o RStudio - **Segurança do Mac bloqueia o RStudio**: Vá para Preferências do Sistema → Segurança e Privacidade → clique em "Abrir Assim Mesmo" ::: --- ### Passo 2: Baixar Materiais do Curso Visite a página de [Materiais Didáticos](teaching_materials.qmd) para baixar: - Modelos de exercícios (arquivos .R) - Scripts de solução (arquivos .R) - Conjuntos de dados tributários de amostra - Guias de referência rápida --- ### Passo 3: Começar a Aprender Clique em **"1. Introdução ao R"** na barra lateral esquerda para começar seu primeiro módulo. Trabalhe nos módulos sequencialmente—cada um se baseia em conceitos das lições anteriores. --- ## Pronto para Começar? ::: {.callout-tip icon=false} ## 🚀 Inicie Sua Jornada com R Você tem R e RStudio instalados. Você sabe onde encontrar os materiais do curso. Agora clique em **"1. Introdução ao R"** no menu da barra lateral para começar o Módulo 1. Lembre-se: todo especialista já foi um iniciante. Reserve seu tempo, pratique consistentemente e não hesite em experimentar! ::: --- <div style="text-align: center; margin-top: 2em; padding-top: 1em; border-top: 1px solid #ddd; color: #666; font-size: 0.9em;"> Desenvolvido pela **Equipe DaTax do Banco Mundial** | [Ver no GitHub](https://github.com/rdoino-wb/datax_r) </div>