-
Notifications
You must be signed in to change notification settings - Fork 1
/
6_documentacao.qmd
166 lines (133 loc) · 5.09 KB
/
6_documentacao.qmd
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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
---
from: markdown+emoji
code-annotations: hover
---
# Documentação dos Censos
## Documentação do censo disponível no {censobr}
Além de funções para leitura dos dados, o pacote {censobr} traz ainda um conjunto de funções que permitem rápido acesso à documentação dos censos demográficos, incluindo os dicionários de variáveis, questionários e manual do entrevistador para entrevistas.
**Tabela 2. Funções de documentação disponíveis no {censobr}**
```{=html}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
table {
width: 100%;
border-collapse: collapse;
}
table, th, td {
border: 1px solid black; /* Thicker border for better visibility */
}
th, td {
padding: 10px;
text-align: center;
}
</style>
</head>
<body>
<table>
<thead>
<tr>
<th rowspan="2">Função</th>
<th rowspan="2">Documentação</th>
<th rowspan="2">Tipo</th>
<th colspan="7">Disponibilidade</th>
</tr>
<tr>
<th>1960</th>
<th>70</th>
<th>80</th>
<th>91</th>
<th>2000</th>
<th>10</th>
<th>22</th>
</tr>
</thead>
<tbody>
<tr>
<td rowspan="2">data_dictionary()</td>
<td rowspan="2">Dicionário de variáveis</td>
<td>Microdados</td>
<td><i>X</i></td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td><i>em breve</i></td>
</tr>
<tr>
<td>Agregados de setores censitários</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td>X</td>
<td>X</td>
<td><i>em breve</i></td>
</tr>
<tr>
<td>questionnaire()</td>
<td>Questionários</td>
<td>Longo e curto</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
</tr>
<tr>
<td>interview_manual()</td>
<td>Manual do entrevistador</td>
<td>-</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
<td>X</td>
</tr>
</tbody>
</table>
</body>
</html>
```
Todas funções de documentação baixam os arquivos em formato `.html` ou `.pdf`, e abrem o documento no navegador (*browser*). Assim como as funções de leitura de dados do {censobr}, essas funções de documentação também salvam os arquivos num cache local na primeira vez que a função é rodada. Assim, quando o usuário roda a função novamente, o pacote simplesmente carrega o arquivo local de maneira quase instantânea.
## Dicionário de dados
A função `data_dictionary()` carrega o dicionário de variáveis, apontando a definição de cada variável e o significado de suas categorias no caso de variáveis categóricas. Atualmente, a função abrange os dicionários dos microdados da amostra para todos os censos brasileiros desde 1960: `c(1960, 1970, 1980, 1991, 2000 e 2010)`. Além disso, a função também inclui atualmente os dicionários dos dados do universo agregados em setores censitário para os anos 2000 e 2010.
```{r, eval = FALSE}
library(censobr)
# dicionário de variáveis de pessoas (microdados da amostra)
data_dictionary(year = 2010,
dataset = 'population')
# dicionário de variáveis de domicílios (microdados da amostra)
data_dictionary(year = 2010,
dataset = 'households')
# dicionário de variáveis de setores censitários (agregados do universo)
data_dictionary(year = 2010,
dataset = 'tracts')
```
## Questionários
Com frequência, é importante se entender a estrutura e fluxo do questionário utilizado em pesquisas de coleta de dados. A função `questionnaire()` inclui os questionários utilizados na coleta de dados de todos os censos brasileiros desde 1960.
Além de passar o parâmetro `year`, o usuário precisa indicar o tipo de questionário de interesse, se o questionário curto do universo (`type = 'short'`) ou o questionário longo utilizado na pesquisa amostral (`type = 'long'`).
```{r, eval = FALSE}
# questionário curto da pesquisa do universo
questionnaire(year = 2022,
type = 'short')
# questionário longo da pesquisa amostral
questionnaire(year = 2022,
type = 'long')
```
## Manual do entrevistador
Por fim, a função `interview_manual()` faz o download e abre no navegador o "Manual do Recenseador", ou seja, o manual de instruções para os recenseadores do IBGE sobre como coletar os dados do censo. Estão disponíveis os manuais de todos os censos desde 1960.
```{r, eval = FALSE}
# Censo de 2010
interview_manual(year = 2022)
# Censo de 1970
interview_manual(year = 1960)
```