In nmecsys/BETS: Brazilian Economic Time Series

knitr::opts_chunk$set(warning=FALSE, message=FALSE, prompt = TRUE)
library(BETS)

Objetivo

Discutiremos algumas formas básicas de uso do pacote, mostrando algumas de suas principais funções.

Interface com a Base de Dados

BETS.search

Devido ao tamanho considerável da base de dados, foi necessário criar um modo de pesquisar por séries a partir de seus metadados, isto é, uma ferramenta de busca que utilizasse uma ou mais informações das séries como palavras-chave. A função BETSsearch realiza as pesquisas por cada campo da tabela de metadados

O protótipo da BETSsearch tem a forma:

BETSsearch(description, src, periodicity, unit, code, view = TRUE, lang = "en")

Onde os argumentos recebem, respectivamente:

• description: um character. String de busca com os termos que devem ou não estar presentes na descrição da série desejada.
• src: um \code{character}. A fonte dos dados.
• periodicity um character. A frequência na qual a série é observada.
• unit: um character. A unidade na qual os dados foram medidos.
• code: um integer. O código único da série na base do BETS.
• view: um boolean. Por padrão, TRUE. Se FALSE, os resultados serão mostrados direto no console do R.
• lang: um character. Idioma da pesquisa. Por padrão, 'en', para inglês. Também é possivel fazer a pesquisa em português, bastando mudar o valor para 'pt'.

Para refinar as buscas, há regras de sintaxe para o parâmetro description:

1. Para procurar palavras alternativas, separe-as por espaços em branco. Exemplo: description = 'núcleo ipca' significa que a descrição da série deve conter 'ipca' e 'núcleo'.

2. Para procurar expressões inteiras, basta cercá-las com ' '. Exemplo: description = 'índice de 'núcleo ipca'' significa que deve conter na descrição da série 'núcleo ipca' e 'índice'.

3. Para excluir palavras da busca, insira um $\sim$ antes de cada um delas. Exemplo: description = 'ipca $\sim$ núcleo' significa que a descrição da série deve conter 'ipca' e não pode conter 'núcleo'.

4. Para excluir todas as expressões da busca, de forma semelhante ao item anteiror, basta cercá-los com ' ' e inserir um $\sim$ antes de cada uma delas. Exemplo: description = '$\sim$ índice 'núcleo ipca'' significa que a descrição da série deve conter 'índice' e não pode conter 'núcleo ipca'.

5. É possível pesquisar ou negar várias palavras ou expressões, desde que sejam respeitadas as regras precedentes.

6. O espaço em branco após o sinal de negação ($\sim$) não é necessário. Mas os espaços em branco depois de expressões ou palavras são necessários.

Alguns exemplos de uso podem ser visto abaixo:

BETSsearch(description = "sales ~ retail")
BETSsearch(description = "'sales volume index' ~ vehicles")
BETSsearch(description = "'distrito federal'", periodicity = 'A', src = 'IBGE')

BETSsearch(description = "gdp accumulated", unit = "US", view = F)
results = BETSsearch(description = "consumption ~ 'seasonally adjusted' ~ private", view = F)
head(results)

Para mais informações sobre a BETSsearch, incluindo os valores válidos em cada campo, consulte o manual de referência, digitando ?BETSsearch no console do R.

BETS.get}

A BETSget funciona unicamente através do código de referência da série, obtido com as consultas feita com a \code{BETSsearch}. Sua assinatura é:

BETSget(code, data.frame = FALSE)

O parâmetro code é, obviamente, obrigatório. O argumento opcional data.frame representa o tipo do objeto que será retornado. Por padrão, seu valor é FALSE, indicando que o objeto devolvido pela função será um ts (time series). Caso data.frame = TRUE, a série será armazenada em um objeto do tipo data.frame.

Vamos extrair duas das séries pesquisadas anteriormente.

# Obter a serie do PIB acumulado em 12 meses, em dolares
gdp_accum = BETSget(4192)
window(gdp_accum, start = c(2014,1))

# Obter a serie do PIB do Distrito Federal, a precos de mercado
gdp_df = BETSget(23992, data.frame = T)
head(gdp_df)

BETS.save

Para conferir versatilidade às formas de armazenamento das séries do \code{BETS}, há a possibilidade de criar arquivos com as séries em formatos proprietários, isto é, formatos que pertencem a softwares pagos.

A save extrai a série temporal da base de dados do pacote na forma de um data.frame e cria um arquivo no formato especificado. No arquivo, há uma tabela onde a primeira coluna conterá as datas e a segunda, os dados.

A função possui três variações:

saveSas(code, data = NULL, file.name = "series")
saveSpss(code, data = NULL, file.name = "series")
saveStata(code, data = NULL, file.name = "series")

Novamente, o parâmetro code recebe o código da série. O usuário pode fornecer sua própria série através do argumento data, que pode ser um data.frame ou um ts. Não é necessário acrescentar a extensão ao nome do arquivo no parãmetro file.name.

Alguns exemplos típicos de uso seriam:

# Salvar a série da dívida pública líquida no formato padrão do Excel
saveStata(code = 2078, file.name = "series_stata.dta")

# Salvar uma série qualquer no formato do SPSS
saveSpss(data = myseries, file.name = "series_spss")

BETS.chart

A chart foi inicialmente projetada para ser uma função privada, auxiliar da dashboard. No entanto, pensamos ser de grande valia para o usuário dispor de um meio de obter os gráficos dos dashboards separadamente, de modo a poder incorporá-los em seus trabalhos.

O protótipo da chart é o que se segue:

chart(ts, file = NULL, open = TRUE, params = NULL)

O parâmetro ts pode receber uma dentre as várias opções pré-definidas de gráficos ou uma série do usuário. Há também a opção de salvar a saída no working directory, definindo o nome do arquivo file. Caso o arquivo deva ser aberto após a criação, open deve ser mantido como TRUE. O parâmetro params é reservado para gráficos de séries do usuário. É uma lista que pode conter o campo codace, que recebe um booleano e indica se devem ser desenhadas áreas sombreadas representando recessões datadas pelo CODACE (FGV/IBRE), e o campo start, que especifica qual deve ser a data de início da série. Uma vez que se tratam de gráficos de conjuntura, a data de fim não pode ser alterada e é sempre o último dado disponível.

Vejamos dois exemplos de uso da chart.

chart(ts = 'iie_br', file = "iie_br", open = TRUE)

{ width=60% }

chart(ts = "misery_index", file = "misery_index.png", open = TRUE)

{ width=60% }

Para uma lista completa dos gráficos diponíveis, consulte o manual de referência da chart.

BETS.dashboard

O BETS possui uma poderosa ferramenta de análise de conjuntura, os dashboards. Para criar um dashboard, chamamos a dashboard, cuja assinatura é:

dashboard(type = "business_cycle", saveas = NA)

Assim, obtemos um arquivo .pdf. No exemplo, o usuário escolhe salvar o arquivo com o nome de survey.pdf. Os gráficos que são exibidos também são de escolha do usuário, selecionados através do parâmetro charts (por default, seu valor é 'all'). O manual de referência possui uma lista completa dos gráficos disponíveis.

dashboard(type = "business_cycle", saveas = "survey.pdf")

nmecsys/BETS documentation built on April 8, 2021, 1:54 a.m.