-
Notifications
You must be signed in to change notification settings - Fork 9
/
README.Rmd
130 lines (95 loc) · 7.21 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
---
output: github_document
---
For the English version, click on the Shield below:
<!-- badges: start -->
[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/datazoompuc/datazoom_social_Stata/blob/main/README_en.md)
<!-- badges: end -->
<a href="https://github.com/datazoompuc/datazoom_social_Stata"><img src="https://raw.githubusercontent.com/datazoompuc/datazoom_social_stata/master/logo.jpg" align="left" width="100" hspace="10" vspace="6"></a>
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# datazoom_social
<!-- badges: start -->
![Languages](https://img.shields.io/github/languages/count/datazoompuc/datazoom_social_Stata?style=flat)
![Commits](https://img.shields.io/github/commit-activity/y/datazoompuc/datazoom_social_Stata?style=flat)
![Open Issues](https://img.shields.io/github/issues-raw/datazoompuc/datazoom_social_Stata?style=flat)
![Closed Issues](https://img.shields.io/github/issues-closed-raw/datazoompuc/datazoom_social_Stata?style=flat)
![Files](https://img.shields.io/github/directory-file-count/datazoompuc/datazoom_social_Stata?style=flat)
![Followers](https://img.shields.io/github/followers/datazoompuc?style=flat)
<!-- badges: end -->
O `datazoom_social` é um pacote que compatibiliza microdados de pesquisas realizadas pelo IBGE. Com o pacote, é possível fazer a leitura de todas as pesquisas domiciliares realizadas pelo IBGE, compatibilizar os Censos Demográficos de diferentes anos, gerar identificação dos indivíduos da PNAD Contínua, e muito mais.
## Instalação <a name="instalacao"></a>
Digite o código abaixo na linha de comando do Stata para baixar e instalar a versão mais recente do pacote
```
net install datazoom_social, from("https://raw.githubusercontent.com/datazoompuc/datazoom_social_stata/master/") force
```
## Uso
Todas as funções do pacote podem ser usadas pelas caixas de diálogo. Para acessá-las, digite o comando
```
db datazoom_social
```
Clique nos botões abaixo para ir à helpfile de cada função. Elas são melhor visualizadas abrindo no Stata, com `help função`.
| | | | |
|:-----:|:------:|:-----:|:-----:|
| <a href = "Censo/datazoom_censo.sthlp"> <kbd> <br> <font size = 3> Censo </font> <br><br> </kbd> </a> <br> <br> <small> Censo Demográfico </small> <br> <small> 1970 a 2010 </small> | <a href = "ECINF/datazoom_ecinf.sthlp"> <kbd> <br> <font size = 3> ECINF </font> <br><br> </kbd> </a> <br><br> <small> Economia Informal Urbana </small> <br> <small> 1997 e 2003 </small> | <a href = "PME/datazoom_pme.sthlp"> <kbd> <br> <font size = 3> PME </font> <br><br> </kbd> </a> <br><br> <small> Pesquisa Mensal de Emprego </small> <br> <small> 1990 a 2015 </small> | <a href = "PNAD/datazoom_pnad.sthlp"> <kbd> <br> <font size = 3> PNAD </font> <br><br> </kbd> </a> <br><br> <small> PNAD Antiga </small> <br> <small> 2001 a 2015 </small> |
| <a href = "PNAD_Continua/Trimestral/datazoom_pnadcontinua.sthlp"> <kbd> <br> <font size = 3> PNAD Contínua </font> <br><br> </kbd> </a> <br><br> <small> PNAD Contínua </small> <br> <small> 2012 a 2023 </small> | <a href = "PNAD_Covid/datazoom_pnad_covid.sthlp"> <kbd> <br> <font size = 3> PNAD Covid </font> <br><br> </kbd> </a> <br><br> <small> PNAD Covid </small> <br> <small> 2020 </small> | <a href = "PNS/datazoom_pns.sthlp"> <kbd> <br> <font size = 3> PNS </font> <br><br> </kbd> </a> <br><br> <small> Pesquisa Nacional de Saúde </small> <br> <small> 2013 e 2019 </small> | <a href = "POF/datazoom_pof.sthlp"> <kbd> <br> <font size = 3> POF </font> <br><br> </kbd> </a> <br><br> <small> Pesquisa de Orçamentos Familiares </small> <br> <small> 1995 a 2018 </small> |
<a href = "#créditos">![Static Badge](https://img.shields.io/badge/Cr%C3%A9ditos%20-%20Departamento%20de%20Economia%20PUC%20Rio%20-%20blue) </a> <a href = "#créditos"> ![Static Badge](https://img.shields.io/badge/Cita%C3%A7%C3%A3o%20-%20green) </a>
## Programas Auxiliares (Dicionários)
A maioria dos programas do pacote lidam com dados originais
armazenados em formato *.txt*, que precisam de dicionários – formato *.dct*
no Stata – para serem lidos. A consequência é um volume de dicionários
que supera o limite de 100 arquivos permitido para um pacote do Stata
poder ser instalado. Por isso, os dicionários individuais são
compactados em um arquivo *.dta* único, que é lido dentro de cada
programa. Ambas as funções usadas para isso são definidas no arquivo
*read\_compdct.ado*.
O primeiro programa definido nesse arquivo é `write_compdct`, que pode
ser usado como a seguir: após rodar o arquivo *.ado* para definir a
função, basta usar o código
write_compdct, folder("/pasta com os dicionários") saving("/caminho/dict.dta")
A função então lê todos os arquivos *.dct* presentes na pasta, e junta
todos no arquivo *dict.dta*, com cada dicionário identificado por uma
variável com seu nome.
Para transformar esse arquivo compactado novamente do dicionário
original, se usa o programa `read_compdct`:
read_compdct, compdct("dict.dta") dict_name("dic original") out("dic extraído.dct")
que extrai o *“dic original”* do arquivo *dict.dta* e o salva para *“dic extraído.dct”*.
Como exemplo, veja o uso dessa função no programa
`datazoom_pnadcontinua`
tempfile dic // Arquivo temporário onde o .dct extraído será salvo
findfile dict.dta // Acha o arquivo dict.dta salvo pela instalação
// do pacote na pasta /ado/, e armazena o caminho
// até ele na macro r(fn)
read_compdct, compdct("`r(fn)'") dict_name("pnadcontinua`lang'") out("`dic'")
// Lê o dicionário compactado dict.dta, extrai o dicionário pnadcontinua
// (ou pnadcontinua_en, `lang` é vazio ou "_en"), e salva o arquivo final
// na tempfile dic, que é usada para ler os dados
Para a nossa organização interna, cada pasta correspondente a um
programa armazena os dicionários na sub-pasta */dct/*. Todos esses
dicionários são também armazenados juntos na pasta */dct/* diretamente,
que é usada para gerar o *dict.dta* através do `write_compdct`. Note que
nenhum arquivo *.dct* é efetivamente listado no arquivo
*datazoom\_social.pkg*, e portanto, não são instalados no computador do
usuário. Apenas o arquivo *dict.dta* é enviado.
Periodicamente, na manutenção do pacote, temos que rodar a do-file `atualizacao_dict.do` e seguir as instruções.
## Créditos
O [Data Zoom](https://www.econ.puc-rio.br/datazoom/) é desenvolvido por uma equipe do Departamento de Economia da Pontifícia Universidade Católica do Rio de Janeiro (PUC-Rio)
Para citar o pacote `datazoom_social`, utilize:
> Data Zoom (2023). Data Zoom: Simplifying Access To Brazilian Microdata.
> https://www.econ.puc-rio.br/datazoom/english/index.html
Ou, em formato BibTeX:
```
@Unpublished{DataZoom2023,
author = {Data Zoom},
title = {Data Zoom: Simplifying Access To Brazilian Microdata},
url = {https://www.econ.puc-rio.br/datazoom/english/index.html},
year = {2023},
}
```