O principal atrativo do pacote ´e o seu banco de dados e nesse ponto o pacote precisava ser abrangente (e adicionalmente adaptativo, ou seja, ser f´acil a tarefa de adicionar novas fontes de dados), pois essa era a ideia principal da proposta. Nessa categoria, est˜ao concentradas ferramentas para recuperar as s´eries e informa¸c˜oes sobre elas. Isso n˜ao cobre somente a API privada para extrair dados diretamente das fontes, mas tamb´em a API p´ublica para recuperar os dados do banco de dados no pacote.
A interface para o usu´ario ´e bem intuitiva, o pacote possui uma fun¸c˜ao para pesquisa, uma para extra¸c˜ao e fun¸c˜oes para exporta¸c˜ao dos dados que possibilitam a comunica¸c˜ao com outros softwares estat´ısticos famosos, como SPSS, STATA e SAS. No total foram criadas 4 fun¸c˜oes:
BETSsearch - fun¸c˜ao que pesquisa por metainforma¸c˜oes dos dados. Permite bus- cas em portuguˆes e em inglˆes e por qualquer propriedade dispon´ıvel. O Algoritmo 3.8 apresenta o escopo geral da fun¸c˜ao BETSsearch.
BETSsearch (d e s c r i p t i o n , s r c , p e r i o d i c i t y , u n i t , code , view = TRUE, l a n g = ” en ”)
Algoritmo 3.8: Fun¸c˜ao BETSsearch
Os argumentos s˜ao:
• description - um caracter. Uma frase ou palavra que se encaixa da descri¸c˜ao da s´erie temporal;
• src - um caracter. A fonte do dado;
• periodicity - caracter. A frequˆencia com que o dado ´e observado ao longo do tempo;
• unit - um caracter. A unidade com que o dado ´e medido; • code - um intereiro ou um caracter. O c´odigo ´unico do dado;
• view - um booleano. Por padr˜ao, TRUE (verdadeiro). Se FALSE (falso) os resultados que se encaixam com a pesquisa ser˜ao imprimidos no console do R;
• lang - um caracter. A liguagem da pesquisa. Por padr˜ao, en, para inglˆes. A pesquisa tamb´em pode ser feita em portuguˆes, basta mudar o valor do argumento para pt.
3.2 BETS - Brazilian Economic Times Series 35
O parametro code ´e usado para uma r´apida busca. O c´odigo ´e obtido a partir do resultado da utiliza¸c˜ao da fun¸c˜ao BETSsearch.
O Algoritmo 3.9 apesenta alguns exemplos de uso da fun¸c˜ao variando alguns parˆametros.
BETSsearch (” Desemprego ”, l a n g = ’ pt ’) BETSsearch (d e s c r i p t i o n = ” s a l e s ˜ r e t a i l ”)
BETSsearch (d e s c r i p t i o n = ” ’ s a l e s volume i n d e x ’ ˜ v e h i c l e s ”)
BETSsearch (d e s c r i p t i o n = ” ’ d i s t r i t o f e d e r a l ’ ”, p e r i o d i c i t y = ’A ’, s r c = ’IBGE ’)
Algoritmo 3.9: Exemplos de uso da BETSsearch
BETSget - fun¸c˜ao para a extra¸c˜ao do dado. Ao fornecer o c´odigo da s´erie, obtem-se os dados em tempo real, direto da fonte, conforme o Algoritmo 3.10.
BETSget ( code ,d a t a.frame = FALSE)
Algoritmo 3.10: Fun¸c˜ao BETSget
O argumento c´odigo ´e obrigat´orio. O argumento opcional, data.frame, representa o tipo de objeto que ser´a retornado. Seu valor padr˜ao ´e FALSE, indicando que o objeto retornado por a fun¸c˜ao ser´a uma ts (s´erie temporal). Se data.frame = TRUE, a s´erie ser´a armazenada em um objeto do tipo data.frame. Segue alguns exemplos de uso da fun¸c˜ao de extra¸c˜ao de dados do pacote utilizando o termo IPCA (Algoritmo 3.11).
# obtendo o c o d i g o da s e r i e do i p c a
BETSsearch (d e s c r i p t i o n = ” i p c a ”, l a n g = pt, view = FALSE)
Algoritmo 3.11: Exemplo de uso da BETSsearch
Na Figura 8 tem-se, grifado de verde, uma poss´ıvel escolha do dado que se refere ao termo pesquisado.
i p c a <− BETSget ( c o d e = 4 4 3 )
Algoritmo 3.12: Exemplo de uso da BETSget
No BETS h´a um conjunto de fun¸c˜oes separadas para auxiliar a pesquisa e extra¸c˜ao de dados do SIDRA (Sistema IBGE de Recupera¸c˜ao Autom´atica), sidraSearch e sidraGet.
3.2 BETS - Brazilian Economic Times Series 36
Figura 8: Tabela resultante do uso da BETSsearch para o termo IPCA.
sidraSearch - A API fornecida pelo IBGE de acesso ao SIDRA ´e um tanto complexa e por vezes, confusa. Definimos uma fun¸c˜ao para que torne essa intera¸c˜ao um pouco melhor. A fun¸c˜ao sidraSearch como no 3.13 tem por objetivo, algo semelhante a BETSsearch, pesquisar nos bancos de dados da Sidra s´eries por sua descri¸c˜ao ou por uma determinada tabela.
s i d r a S e a r c h (d e s c r i p t i o n = NULL, code , view = TRUE, browse = FALSE)
Algoritmo 3.13: Fun¸c˜ao sidraSearch
Os parˆametros s˜ao:
• description - um caracter. Uma frase ou palavra que se encaixa da descri¸c˜ao de dados do Sidra;
• code - um intereiro ou um caracter. O c´odigo ´unico do dado;
• view - um booleano. Por padr˜ao, TRUE (verdadeiro). Se FALSE (falso) os resultados que se encaixam com a pesquisa ser˜ao imprimidos no console do R;
• browse - um booleano. Se estiver definido como TRUE, a tabela de descri¸c˜ao ser´a aberta em seu navegador para melhor visualiza¸c˜ao.
No Algoritmo 3.14 seguem um exemplo de uso da fun¸c˜ao. Logo em seguida, na Figura 9, apresenta-se o resultado da fun¸c˜ao.
3.2 BETS - Brazilian Economic Times Series 37
s i d r a S e a r c h (d e s c r i p t i o n = ” p i b ”)
Algoritmo 3.14: Exemplo de uso da sidraSearch
Figura 9: Tabela resultante do uso da sidraSearch para o termo pib.
sidraGet - Como a BETSget, a sidraGet (Algoritmo 3.15) tem por finalidade extrair dados das bases do Sidra.
s i d r a G e t ( x , from , to , t e r r i t o r y = c( n1 = ” b r a z i l ”, n2 = ” r e g i o n ”, n3 = ” s t a t e ”,
n6 = ” c i t y ”, n8 = ” m e s o r e g i o n ”, n9 = ” m i c r o r e g i o n ”, n129 = ” c i t i z e n s h i p ”, n132 = ” s e m i a r i d ”, n133 = ” semiaridUF ”) , v a r i a b l e , c l = NULL, s e c t i o n s
= NULL)
Algoritmo 3.15: Fun¸c˜ao sidraGet
Os parˆametros s˜ao:
• x - n´umero da s´erie temporal no Sidra;
• from - um caracter. Data que se deseja inicar os dados; • to - um caracter. Data que se deseja finalizar os dados;
• territory - um caracter. Especifica os n´ıveis territoriais desejados;
• variable - um inteiro descrevendo quais caracter´ısticas (vari´aveis) ser˜ao retornadas; • cl - um vetor contendo os c´odigos de classifica¸c˜ao;
3.2 BETS - Brazilian Economic Times Series 38
• sections - um vetor ou uma lista de vetores (se houver duas ou mais classifica¸c˜oes). No Algoritmo 3.16 seguem alguns exemplos de uso da fun¸c˜ao sidraGet.
s i d r a = s i d r a G e t ( x = c( 1 6 1 2 ) , from = 1 9 9 0 , t o = 2 0 1 5 , t e r r i t o r y = ” b r a z i l ”, v a r i a b l e =109) s i d r a = s i d r a G e t ( x = c( 3 6 5 3 ) , from = c(” 200201 ”) , t o = c(” 201703 ”) , t e r r i t o r y = ” b r a z i l ”, v a r i a b l e = 3 1 3 5 , s e c t i o n s = c( 1 2 9 3 1 6 , 1 2 9 3 3 0 ) , c l = 5 4 4 ) s i d r a = s i d r a G e t ( x = 1 6 2 0 , from = 1 9 9 0 0 1 , t o = 2 0 1 7 0 1 , t e r r i t o r y = ” b r a z i l ”, s e c t i o n s=l i s t(c( 9 0 6 8 7 ) ) , c l =c( 1 1 2 5 5 ) , v a r i a b l e = 5 8 3 )
Algoritmo 3.16: Exemplos sidraGet
Para permitir maior flexibilidade na forma como as s´eries BETS s˜ao armazenadas, foram criados as fun¸c˜oes saveSas, saveSpss e saveStata para exportar os dados para outros softwares estat´ısticos. Forne¸ca o objeto com o dado e nome do arquivo no qual deseja-se salvar, como no Algoritmo 3.17.
s a v e S a s ( code ,d a t a = NULL, f i l e . name = ” s e r i e s ”) s a v e S p s s ( code ,d a t a = NULL, f i l e . name = ” s e r i e s ”) s a v e S t a t a ( code ,d a t a = NULL, f i l e . name = ” s e r i e s ”)
Algoritmo 3.17: Fun¸c˜oes de exporta¸c˜ao
Novamente, repare no Algoritmo 3.18 que o parˆametro code recebe o c´odigo da s´erie. O usu´ario pode fornecer sua pr´opria s´erie com os dados no argumento data, que pode ser um data.frame ou um ts. N˜ao h´a necessidade de adicionar a extens˜ao ao nome do arquivo no parˆametro file.name.
s a v e S t a t a ( c o d e = 2 0 7 8 , f i l e . name = ” s e r i e s s t a t a ”)
# S a l v a n d o q u a l q u e r s e r i e em f o r m a t o SPSS
my . s e r i e s <− BETSget ( 4 4 4 7 )
s a v e S p s s (d a t a = my . s e r i e s , f i l e . name = ” s e r i e s s p s s ”)
Algoritmo 3.18: Utilizando as fun¸c˜oes de exporta¸c˜ao
Com as informa¸c˜oes fornecidas at´e agora, a promessa do BETS se torna muito mais aparente. Indo al´em do mero fornecimento de dados e fornecendo uma ampla gama
3.2 BETS - Brazilian Economic Times Series 39
de ferramentas para estudar s´eries temporais, este pacote pioneiro permite que um pro- gramador inexperiente em qualquer lugar do mundo possa analisar o cen´ario econˆomico brasileiro. Tudo o que ´e necess´ario para liberar o poder da BETS ´e um simples ins- tall.packages(‘BETS‘), o ´unico comando necess´ario para instalar o pacote.