Universalizando o acesso a dados de qualidade no Brasil.
Versões atuais do pacote:
| R | Python |
|---|---|
 |
    |
Tratamos, padronizamos e disponibilizamos bases de dados públicas de várias fontes como PNAD, RAIS, Censo e DataSUS. A Base dos Dados Mais (BD+) é um datalake público no Google BigQuery e uma consulta escrita em SQL é o suficiente para começar a sua análise. Temos bibliotecas em Python e R para facilitar o acesso ao datalake e estamos sempre adicionando novas bases.
O projeto faz parte da Base dos Dados, uma organização sem fins lucrativos com a missão e universalizar o acesso a dados de qualidade para todes. Veja mais quem contribui e como você também pode contribuir.
pip install basedosdadosimport basedosdados as bd
df = bd.read_table('br_ibge_pib', 'municipio', billing_project_id="<YOUR-PROJECT>")Caso esteja acessando da primeira vez, vão aparecer alguns passos na tela para autenticar seu projeto - basta segui-los!
É necessário criar um projeto para que você possa fazer as queries no nosso repositório. Ter um projeto é de graça e basta ter uma conta Google (seu gmail por exemplo). Veja aqui como criar um projeto no Google Cloud.
Se possível, armazene suas credenciais em um arquivo
dotenv:"billing_project_id=<suas_credenciais_do_projeto>" >> .env
import basedosdados as bd
# Bens dos candidatos de Tocantins em 2020
query = """
SELECT *
FROM `basedosdados.br_tse_eleicoes.bens_candidato`
WHERE ano = 2020
AND sigla_uf = 'TO'
"""
df = bd.read_sql(query, billing_project_id="<YOUR-PROJECT>")Caso esteja acessando da primeira vez, vão aparecer alguns passos na tela para autenticar seu projeto - basta segui-los!
import basedosdados as bd
bd.list_datasets()Para saber mais, veja os exemplos ou a documentação da API
install.packages("basedosdados")
# ou a versão de desenvolvimento
devtools::install_github("basedosdados/mais", subdir = "r-package")library(basedosdados)
set_billing_id("id do seu projeto aqui") # autenticação para acesso aos dados
pib_per_capita <- "
SELECT
pib.id_municipio ,
pop.ano,
pib.PIB / pop.populacao as pib_per_capita
FROM `basedosdados.br_ibge_pib.municipio` as pib
INNER JOIN `basedosdados.br_ibge_populacao.municipio` as pop
ON pib.id_municipio = pop.id_municipio AND pib.ano = pop.ano"
(data <- read_sql(pib_per_capita)) # leia os dados em memória
download(pib_per_capita, "pib_per_capita.csv") # salve os dados em discoCaso esteja acessando da primeira vez, vão aparecer alguns passos na tela para autenticar seu projeto - basta segui-los!
É necessário criar um projeto para que você possa fazer as queries no nosso repositório. Ter um projeto é de graça e basta ter uma conta Google (seu gmail por exemplo). Veja aqui como criar um projeto no Google Cloud.
Se possível, armazene suas credenciais em um arquivo
dotenv:"billing_project_id=<suas_credenciais_do_projeto>" >> .env
Acesse os códigos de análises produzidas em Workshops, Artigos, Tutoriais e Redes Sociais todas no nosso repositório de analises.
Você pode conferir também tutoriais de como utilizar nossa plataforma no Youtube e no blog.
Você pode contribuir de várias maneiras:
- Subindo novos conjuntos de dados
- Melhorando a documentação
- Criando tutoriais e workshops
- Melhorando nossa API em Python
- Melhorando nossa API em R
- Criando checagens automáticas de qualidade de dados e metadados (em Python)
- Melhorando nosso o UX do nosso site (React, CSS, HTML)
- Contribuindo com nossa comunicação e mídias
- Reportando bugs
- Ajudando na captação de recursos
- Nos chamando para aprensetações, simpósios e conferências
- Corrigindo links quebrados no site
Incentivamos que outras instituições e pessoas contribuam. Veja mais como contribuir e descubra quem contribui com nosso código!
A Base dos Dados já poupou horas da sua vida? Ou permitiu coisas antes impossíveis? Nosso trabalho é quase todo voluntário, mas temos vários custos de infraestrutura, equipe, e outros.
Nos ajude a fazer esse projeto se manter e crescer!
O projeto está licenciado sob a Licença Hipocrática. Sempre que usar os dados cite a fonte como:
Português:
Carabetta, João; Dahis, Ricardo; Israel, Fred; Scovino, Fernanda (2020) Base dos Dados: Repositório de Dados Abertos em https://basedosdados.org.
Inglês:
Carabetta, João; Dahis, Ricardo; Israel, Fred; Scovino, Fernanda (2020) Data Basis: Open Data Repository at https://basedosdados.org.
Documentação está em português (quando possível), código e configurações estão em inglês.
Atualize os docs adicionando ou editando .md em docs/.
Se for adicionar um arquivo novo, adicione ele em mkdocs.yml sob a chave nav.
Para testar a documentação, rode:
mkdocs serve