pyqog

Cliente Python para dados do Quality of Government (QoG) Institute.
Baixe, armazene em cache e analise dados de governanca mundial com facilidade.

pip install pyqog
📚 Sobre este pacote

O pyqog foi desenvolvido como ferramenta didatica para exercicios em sala de aula das disciplinas de Data Science do Professor Danny de Castro no IDP – Instituto Brasileiro de Ensino, Desenvolvimento e Pesquisa.

Este pacote facilita o acesso aos dados do Quality of Government Institute para fins educacionais e de pesquisa academica. Para uso de dados oficiais e como fonte de informacao oficial, acesse diretamente o site do QoG Institute:

🔗 https://www.gu.se/en/quality-government

Encontrou algum erro ou tem sugestoes? Entre em contato: danny.soares@idp.edu.br

O que e o QoG?

O Quality of Government Institute (QoG) e um instituto de pesquisa da Universidade de Gotemburgo, na Suecia. O instituto coleta e disponibiliza dados sobre qualidade de governo, corrupcao, democracia, burocracia e diversas outras dimensoes politicas e sociais.

Os datasets do QoG integram centenas de variaveis de diferentes fontes internacionais (Banco Mundial, ONU, Transparency International, Freedom House, entre outras) em bases de dados padronizadas, facilitando a pesquisa comparativa entre paises.

Saiba mais: Site oficial do QoG Institute

🌎
Dados Globais

Cobertura de mais de 190 paises com series temporais longas.

O que e o pyqog?

O pyqog e um pacote Python que facilita o download, armazenamento em cache e uso dos datasets do QoG Institute diretamente no Python. Inspirado no pacote R rqog, o pyqog permite:

  • Baixar dados do QoG em formato CSV com um unico comando
  • Armazenar dados em cache local para uso offline
  • Acessar versoes atuais e historicas dos datasets
  • Buscar variaveis por nome
  • Obter URLs dos codebooks em PDF
  • Listar todos os datasets e versoes disponiveis
🐍
Simples e Pythonico

Apenas duas dependencias: pandas e requests. Minimalista e eficiente.

Inicio Rapido

1. Instale o pacote
pip install pyqog
2. Baixe dados do QoG
import pyqog

# Baixar dados basicos (time-series, versao mais recente)
df = pyqog.read_qog()

# Baixar dados standard cross-sectional
df = pyqog.read_qog(which_data="standard", data_type="cross-sectional")

# Baixar versao antiga (2020)
df = pyqog.read_qog(which_data="basic", year=2020)

# Listar datasets disponiveis
pyqog.list_datasets()

# Buscar variaveis com "corruption" no nome
cols = pyqog.search_variables(df, "corrupt")
3. Explore os dados
# Ver primeiras linhas
print(df.head())

# Filtrar por pais
brasil = df[df["cname"] == "Brazil"]

# Info sobre o dataset
info = pyqog.describe_dataset("basic")
print(info)

Explore a Documentacao

📦
Instalacao

Como instalar o pyqog via pip e configurar o ambiente de desenvolvimento.
📖
Tutorial Completo

Guia passo a passo para baixar, filtrar e analisar dados do QoG.
🛠
Referencia da API

Documentacao detalhada de todas as funcoes do pacote.
📊
Datasets Disponiveis

Tabela completa com todos os datasets, versoes e links para codebooks.
🔍
QoG Data Finder

Ferramenta oficial do QoG para buscar e explorar variaveis.
💻
Codigo Fonte

Repositorio no GitHub. Contribuicoes e issues sao bem-vindas.

Citacao

Se utilizar dados do QoG em sua pesquisa, cite:

Teorell, Jan, et al. 2026. The Quality of Government Standard Dataset, version Jan26. University of Gothenburg: The Quality of Government Institute, https://www.gu.se/en/quality-government