iotbr

Ferramentas para análise das Tabelas de Recursos e Usos (TRU), estimação de Tabelas Insumo-Produto (MIP), deflação de séries temporais e simulação de choques estruturais com base nas Contas Nacionais do IBGE.

Visão geral

iotbr é um pacote Python voltado à manipulação e análise de dados das Tabelas de Recursos e Usos (TRU) do IBGE. Ele oferece funcionalidades para:

1. Leitura, retomada e análise dos dados da TRU, facilitando o entendimento da estrutura produtiva brasileira;
2. Estimação de Tabelas Insumo-Produto (MIP) a partir das TRU, com base na metodologia de Guilhoto (2010);
3. Deflação de séries temporais com base em índices de preços adequados;
4. Simulação e análise de choques estruturais, como variações exógenas na demanda final, permitindo calcular multiplicadores econômicos.

Instalação

pip install iotbr

Exemplos de uso

• 1_tru_analysis.ipynb – leitura e estruturação dos dados da TRU;
• 2_mip_estimation.ipynb – estimação das Tabelas MIP;
• 3_shock_analysis.ipynb – simulação de choques e cálculo de multiplicadores.

Deflação das séries

As TRU fornecem, para várias séries, valores a preços correntes e a preços do ano anterior. O pacote calcula os deflatores encadeando essas variações de preços até o ano-base escolhido. Há duas formas de fazer a deflação:

• method="nao_aditivo" (padrão): cada série usa seu próprio deflator. Essa opção preserva melhor as diferenças de preços relativos entre produtos, mas pode quebrar identidades contábeis depois da deflação. Por exemplo, pode ocorrer X != CI + VA, porque cada parcela foi dividida por um índice diferente.
• method="aditivo": todas as séries monetárias usam o mesmo índice agregado da produção (P_matrix). Assim, uma identidade que valia a preços correntes continua válida após a deflação, pois todas as parcelas são divididas pelo mesmo índice. O custo é impor a mesma variação de preços a produtos com dinâmicas diferentes, como gasolina, eletricidade, serviços e máquinas.

O método padrão é nao_aditivo para preservar o comportamento anterior do pacote. Escolha aditivo quando a prioridade for manter a aditividade da TRU.

from iotbr import tru
from iotbr.io_system import system_def

# Uma série deflacionada com o deflator próprio da série (padrão)
ci_nao_aditivo = tru.read_var_def(
    year="2019", level="51", var="CI_matrix",
    reference_year="2011", method="nao_aditivo",
)

# Todas as séries monetárias deflacionadas pelo índice agregado da produção
ci_aditivo = tru.read_var_def(
    year="2019", level="51", var="CI_matrix",
    reference_year="2011", method="aditivo",
)

# O mesmo método pode ser usado na construção de um sistema de insumo-produto
mip_aditiva = system_def(
    "2019", "51", "t", reference_year="2011", method="aditivo",
)

O fator Fator trabalho (ocupações) representa o número de trabalhadores, e não um valor monetário. Por isso, ele permanece sem deflação nos dois métodos. Quando uma série não possui valores a preços do ano anterior, ou quando uma variação de preços é inválida (por exemplo, denominador zero ou mudança de sinal), o pacote usa o índice agregado da produção como fallback quando essa opção está habilitada internamente.

O ano-base precisa estar disponível para o nível escolhido. Os níveis 12 e 51 cobrem 2000–2021; os níveis 20 e 68 cobrem 2010–2021.

Exemplos de choques que podem ser simulados

• Aumento de 10% no consumo das famílias;
• Variação exógena da demanda final (modelo aberto);
• Variação da demanda com realimentação endógena (modelo fechado);
• Cálculo de multiplicadores de produção, emprego e renda do trabalho.

Esses recursos permitem estimar os impactos diretos, indiretos e induzidos de choques sobre a economia setorial.

Variáveis que o pkg iotbr reconhece dentro da tru

• níveis 20 e 68 so tem dados a partir de 2010

• a TRU51 apresenta os dados de exportação na forma agregada (X_bens + X_serv = X_bens_serv)

• a TRU12 apresentava os dados de exportação na forma desagregada até 2010 (X_bens_serv = X_bens + X_serv). A partir de 2010 passa a apresenta-los de forma agregada (X_bens_serv).

• a TRU51 apresentava os dados de importação na forma desagregada até 2010 (M_bens_serv = CIF_FOB + M_bens + M_serv). A partir de 2010 passa a apresenta-los de forma agregada (M_bens_serv).

• a TRU12 apresentava os dados de importação na forma desagregada até 2010 (M_bens_serv = CIF_FOB + M_bens + M_serv). A partir de 2010 passa a apresenta-los de forma agregada (M_bens_serv).

• Resumindo: Variáveis que só estão disponíveis para os níveis 20 e 51 (disponíveis até 2010): CIF_FOB, M_bens, M_serv, X_bens, X_serv