Pular para conteúdo

condepe logo do condepe

Acesso, pelo Python, aos dados abertos do Observatório de Pernambuco, publicados pela Condepe/Fidem (Agência Estadual de Planejamento e Pesquisas de Pernambuco): séries municipais de população, economia, finanças públicas, trabalho, educação, saúde, segurança, transporte e meio ambiente para os 185 municípios de Pernambuco.

Todas as fontes são publicadas no mesmo formato longo (uma observação por linha, 15 colunas), e por isso um único conjunto de funções atende a todas, devolvendo pandas.DataFrame.

Instalação

pip install condepe
# versão em desenvolvimento:
pip install git+https://github.com/StrategicProjects/condepe-py

Uso

import condepe

# Fontes disponíveis (uma por linha) e a versão do catálogo
cat = condepe.condepe_catalog()
cat.attrs["version"]

# Indicadores de uma fonte
condepe.condepe_indicators("sidra_populacao_estimada")

# Uma série: Recife (IBGE 2611606), de 2020 em diante
condepe.condepe_series(
    "sidra_populacao_estimada",
    "Populacao residente estimada",
    code="2611606",
    years=range(2020, 2027),
)

# Uma fonte inteira e a lista de municípios
condepe.condepe_data("datasus_sinasc")
condepe.condepe_localities()

# Mapas (pip install "condepe[geo]"): malha da Condepe/Fidem ou do IBGE,
# regionalizações do estado e junção dos dados pelo código IBGE
malha = condepe.condepe_geometry(noronha=False)
rd = condepe.condepe_geometry("rd")        # Regiões de Desenvolvimento
condepe.condepe_regions("regiao_saude")    # a que região pertence cada município
mapa = condepe.condepe_add_geometry(condepe.condepe_series(
    "sidra_populacao_estimada", "Populacao residente estimada", years=2025))

Os nomes das colunas ficam em português, como publicados, para que todo resultado possa ser rastreado até os arquivos oficiais: cd_municipio_ibge, nm_municipio, ano, mes, indicador, indicador_base, valor, unidade, natureza, id_fonte, eixo, tema, assunto, fonte_original, arquivo_origem. Séries mensais trazem o período em indicador ("… [MM/AAAA]") e em mes; indicador_base é o rótulo sem ele.

Documentação: https://strategicprojects.github.io/condepe-py/ — primeiros passos, exemplos, mapas e a relação das fontes.

Fontes do Observatório

Versão 2026-11-06_182408 do catálogo: 83 fontes, 113.859 indicadores e 9.037.977 observações. O identificador da fonte é o que se passa às funções do pacote; clique num eixo para abrir a lista. A relação também está em Fontes do Observatório.

Economia 26 fontes · 89.374 indicadores
Tema e fonteDescrição e origemPeríodoIndicadores
Agropecuária
sidra_abate_bovinos		Bovinos abatidos (cabeças) e peso das carcaças (kg) sob inspeção em Pernambuco, trimestral desde 1997
IBGE - Pesquisa Trimestral do Abate de Animais · só Pernambuco
1997–20262
Agropecuária
sidra_abate_frangos		Frangos abatidos (cabeças) e peso das carcaças (kg) sob inspeção em Pernambuco, trimestral desde 1997
IBGE - Pesquisa Trimestral do Abate de Animais · só Pernambuco
1997–20262
Agropecuária
sidra_abate_suinos		Suínos abatidos (cabeças) e peso das carcaças (kg) sob inspeção em Pernambuco, trimestral desde 1997
IBGE - Pesquisa Trimestral do Abate de Animais · só Pernambuco
1997–20262
Agropecuária
sidra_censo_agro_estabelecimentos		Número e área dos estabelecimentos agropecuários, por tipologia
IBGE - Censo Agropecuário 2017
201716
Agropecuária
sidra_leite		Leite cru adquirido e industrializado (mil litros) pelos estabelecimentos sob inspeção em Pernambuco, trimestral desde 1997
IBGE - Pesquisa Trimestral do Leite · só Pernambuco
1997–20262
Agropecuária
sidra_pam		Área plantada, colhida, quantidade produzida, rendimento e valor, por produto
IBGE - Produção Agrícola Municipal (PAM) · 181 municípios
2020–2025243
Agropecuária
sidra_pog_ovos		Ovos de galinha produzidos (mil dúzias) e galinhas poedeiras em Pernambuco, trimestral desde 1987
IBGE - Pesquisa Trimestral da Produção de Ovos de Galinha (POG) · só Pernambuco
1987–20262
Agropecuária
sidra_ppm_origem_animal		Produção de origem animal e valor, por tipo de produto
IBGE - Pesquisa da Pecuária Municipal (PPM)
2020–20259
Agropecuária
sidra_ppm_rebanho		Efetivo dos rebanhos por tipo
IBGE - Pesquisa da Pecuária Municipal (PPM)
2020–202510
Comércio e Serviços
bcb_conjuntura		Séries de conjuntura macroeconômica (IPCA, Selic, câmbio, IBC-Br)
Banco Central do Brasil - SGS · só Pernambuco
2020–20264
Comércio e Serviços
bcb_estban		Estatística bancária mensal por município: agências, instituições, crédito, financiamentos e depósitos (ESTBAN)
Banco Central do Brasil - Estatística Bancária Mensal por Município (ESTBAN) · 102 municípios
2020–202610
Comércio e Serviços
comex_municipios		Exportações e importações por município do domicílio fiscal da empresa, mensal (US$ FOB e kg)
Ministério do Desenvolvimento, Indústria, Comércio e Serviços - ComexStat (município do domicílio fiscal da empresa) · 140 municípios
1997–20264
Comércio e Serviços
comex_uf		Exportações e importações de Pernambuco, mensal, por UF do produto e por domicílio da empresa
Ministério do Desenvolvimento, Indústria, Comércio e Serviços - ComexStat · só Pernambuco
1997–20268
Comércio e Serviços
sidra_iatur		Volume das atividades turísticas em Pernambuco (IATUR): número-índice (2022 = 100, com e sem ajuste sazonal) e quatro variações, mensal desde 2011
IBGE - Pesquisa Mensal de Serviços, Índice de Atividades Turísticas (IATUR) · só Pernambuco
2011–20266
Comércio e Serviços
sidra_pmc		Volume de vendas do comércio varejista ampliado em Pernambuco: número-índice (2022 = 100, com e sem ajuste sazonal) e quatro variações, mensal desde 2003
IBGE - Pesquisa Mensal de Comércio (PMC), comércio varejista ampliado · só Pernambuco
2004–20266
Comércio e Serviços
sidra_pms		Volume de serviços em Pernambuco: número-índice (2022 = 100, com e sem ajuste sazonal) e quatro variações, mensal desde 2011
IBGE - Pesquisa Mensal de Serviços (PMS) · só Pernambuco
2011–20266
Finanças Públicas
sefaz_arrecadacao		Arrecadação mensal de ICMS e IPVA por município e total estadual (SEFAZ-PE)
SEFAZ-PE - Arrecadação por Município e por Região de Desenvolvimento
2020–20264
Finanças Públicas
siconfi_dca		DCA - Declaração de Contas Anuais dos municípios de PE
Secretaria do Tesouro Nacional - Siconfi
2020–20256.261
Finanças Públicas
siconfi_estado		DCA do Governo do Estado de Pernambuco: todas as contas e séries derivadas de receita, despesa e transferências da União
Secretaria do Tesouro Nacional - Siconfi (DCA, Governo do Estado de Pernambuco) · só Pernambuco
2020–20256.443
Finanças Públicas
siconfi_rreo		RREO - Relatório Resumido da Execução Orçamentária dos municípios de PE (6º bimestre)
Secretaria do Tesouro Nacional - Siconfi · 175 municípios
2020–20255.867
Finanças Públicas
tce_despesas		Despesas municipais por unidade gestora e função
TCE-PE - Dados Abertos (via pacote tceper)
2020–202656.183
Finanças Públicas
tce_receitas		Receitas municipais por unidade gestora, categoria e fonte de recurso
TCE-PE - Dados Abertos (via pacote tceper)
2020–202614.207
Indicadores
seplag_iaem		IAEM — Índice de Atividade Econômica Municipal, mensal (índice geral e escores)
CONDEPE/FIDEM - IAEM
2021–20269
Indústria
sidra_pimpf		Produção física industrial de Pernambuco: número-índice (2022 = 100, com e sem ajuste sazonal) e quatro variações, por seção e atividade (CNAE 2.0), mensal desde 2002
IBGE - Pesquisa Industrial Mensal, Produção Física Regional (PIM-PF) · só Pernambuco
2002–202658
Indústria
sidra_sinapi		Custo médio do m² da construção civil (nível estadual), mensal
IBGE - Sistema Nacional de Pesquisa de Custos e Índices da Construção Civil (SINAPI) · só Pernambuco
2020–20263
PIB
sidra_pib_municipal		PIB municipal, impostos e valor adicionado bruto por setor
IBGE - Produto Interno Bruto dos Municípios
2002–20237
Infraestrutura 3 fontes · 39 indicadores
Tema e fonteDescrição e origemPeríodoIndicadores
Transporte
der_malha_rodoviaria		Extensão da malha rodoviária por município: total, por tipo (federais, estaduais, vicinais, acessos), pavimentada e não pavimentada, duplicada; proporção pavimentada e densidade rodoviária. Derivada do SRE do DER-PE recortado pela Malha Municipal
DER-PE - Sistema Rodoviário Estadual (SRE); trechos federais do SNV/DNIT
202610
Transporte
porto_suape_carga		Porto de Suape: contêineres, TEU e toneladas movimentadas por espécie de carga, mensal
Complexo Industrial Portuário de Suape - Movimentação de cargas (site institucional) · só Pernambuco
2020–20267
Transporte
senatran_frota		Frota de veículos por município e tipo, mensal
Senatran - Ministério dos Transportes (frota por município e tipo)
2020–202622
Social 45 fontes · 15.062 indicadores
Tema e fonteDescrição e origemPeríodoIndicadores
Assistencia
seplag_ivcad		IVCAD — Índice de Vulnerabilidade do CadÚnico por município (recorte vigente)
MDS/CONDEPE - IVCAD
20268
Demografia
sidra_censo_2022		População residente, variação absoluta e taxa de crescimento
IBGE - Censo Demográfico 2022
20223
Demografia
sidra_censo_2022_envelhecimento		Índice de envelhecimento, idade mediana e razão de sexo
IBGE - Censo Demográfico 2022
20223
Demografia
sidra_censo_2022_indigenas		População indígena e percentual de pessoas indígenas na população residente (Censo 2022)
IBGE - Censo Demográfico 2022 · 181 municípios
20222
Demografia
sidra_censo_cor_raca		População residente por cor ou raça (2010 e 2022)
IBGE - Censos Demográficos
2010–20226
Demografia
sidra_populacao_estimada		Estimativas anuais de população residente por município
IBGE - Estimativas da Populacao
2001–20261
Demografia
sidra_registro_civil_nascimentos		Nascidos vivos ocorridos no ano, por município
IBGE - Estatísticas do Registro Civil
2020–20241
Demografia
sidra_registro_civil_obitos		Óbitos ocorridos no ano, por município
IBGE - Estatísticas do Registro Civil
2020–20241
Domicílios
sidra_censo_2022_agua		Domicílios particulares permanentes ocupados, por forma de abastecimento de água
IBGE - Censo Demográfico 2022
20229
Domicílios
sidra_censo_2022_esgotamento		Domicílios particulares permanentes ocupados, por tipo de esgotamento sanitário
IBGE - Censo Demográfico 2022
202210
Educação
inep_adequacao_da_formacao_docente		Adequação da formação docente à disciplina que leciona
INEP - Indicadores Educacionais
2020–2025560
Educação
inep_censo_escolar		Censo Escolar: matrículas, docentes, turmas, salas, equipamentos e profissionais por município (soma das escolas)
INEP - Censo Escolar da Educação Básica (microdados)
2020–2025704
Educação
inep_censo_superior		Censo da Educação Superior: cursos (vagas, ingressantes, matrículas, concluintes) e IES (docentes, técnicos) por município
INEP - Censo da Educação Superior (microdados) · 133 municípios
2020–2024244
Educação
inep_complexidade_de_gestao_da_escola		Indicador de complexidade de gestão da escola
INEP - Indicadores Educacionais
2020–2025108
Educação
inep_esforco_docente		Indicador de esforço docente
INEP - Indicadores Educacionais
2020–2025402
Educação
inep_ideb_anos_finais		IDEB por município - anos finais do ensino fundamental
INEP - Instituto Nacional de Estudos e Pesquisas Educacionais Anísio Teixeira
2005–202544
Educação
inep_ideb_anos_iniciais		IDEB por município - anos iniciais do ensino fundamental
INEP - Instituto Nacional de Estudos e Pesquisas Educacionais Anísio Teixeira
2005–202536
Educação
inep_ideb_ensino_medio		IDEB por município - ensino médio
INEP - Instituto Nacional de Estudos e Pesquisas Educacionais Anísio Teixeira
2017–202543
Educação
inep_media_de_alunos_por_turma		Média de alunos por turma
INEP - Indicadores Educacionais
2020–2025350
Educação
inep_media_de_horas_aula_diaria		Média de horas-aula diária
INEP - Indicadores Educacionais
2020–2025335
Educação
inep_nivel_socioeconomico		Indicador de nível socioeconômico (INSE) dos alunos, por rede e localização
INEP - Indicadores Educacionais
2021–2023335
Educação
inep_percentual_de_docentes_com_curso_superior		Percentual de docentes com curso superior
INEP - Indicadores Educacionais
2020–2025193
Educação
inep_regularidade_do_corpo_docente		Indicador de regularidade do corpo docente
INEP - Indicadores Educacionais
2020–202572
Educação
inep_remuneracao_media_dos_docentes		Remuneração média dos docentes da educação básica (RAIS × Censo Escolar)
INEP - Indicadores Educacionais
2020–202136
Educação
inep_taxas_de_distorcao_idade_serie		Taxas de distorção idade-série
INEP - Indicadores Educacionais
2020–2025276
Educação
inep_taxas_de_rendimento_escolar		Taxas de rendimento escolar (aprovação, reprovação e abandono)
INEP - Indicadores Educacionais
2020–2025870
Educação
siope_dados_gerais		Dados gerais do SIOPE: receitas vinculadas, despesas e despesas em educação
FNDE/MEC - SIOPE (via pacote tesouror)
2020–202624
Educação
siope_indicadores		Indicadores de financiamento da educação: investimento por aluno e por etapa
FNDE/MEC - SIOPE (via pacote tesouror)
2020–202659
Indicadores Sociais
sds_crimes_patrimonio		Crimes violentos contra o patrimônio (CVP), por município
SDS-PE - Secretaria de Defesa Social (microdados de CVP)
2020–20262
Indicadores Sociais
sds_estupro		Estupro e estupro de vulnerável, por município e natureza
SDS-PE - Secretaria de Defesa Social (microdados de estupro)
2020–20268
Indicadores Sociais
sds_mvi		Mortes violentas intencionais (MVI/CVLI) por município, ano e natureza
SDS-PE - Secretaria de Defesa Social (microdados de MVI)
2020–202611
Indicadores Sociais
sds_violencia_domestica		Violência doméstica e familiar contra a mulher, por município e natureza
SDS-PE - Secretaria de Defesa Social (microdados de violência doméstica)
2020–202617
Movimento Eleitoral
tse_perfil_eleitorado		Perfil do eleitorado por município: gênero, faixa etária, escolaridade, estado civil, raça/cor
TSE - Tribunal Superior Eleitoral (perfil do eleitorado)
2020–202652
Saúde
datasus_equipamentos		Equipamentos de saúde em uso: total e grupos (tomógrafo, ressonância, mamógrafo, ultrassom, raio X, respirador, desfibrilador, monitor, hemodiálise)
DataSUS - CNES Equipamentos
2020–202510
Saúde
datasus_equipes		Equipes de saúde ativas em dezembro, total e por tipo (CNES-EP)
DataSUS - CNES (equipes, CNES-EP)
2020–202514
Saúde
datasus_estabelecimentos		Estabelecimentos de saúde por tipo de unidade
DataSUS - CNES (Cadastro Nacional de Estabelecimentos de Saúde)
2020–202538
Saúde
datasus_internacoes		Internações hospitalares do SUS: mensais por especialidade (local de internação) e anuais por residência, com ICSAP
DataSUS - SIH/SUS (AIH reduzida)
2020–202641
Saúde
datasus_leitos		Leitos existentes, SUS e contratados por tipo; leitos de UTI por grupo (adulto, pediátrica, neonatal, queimados)
DataSUS - CNES (leitos) · 183 municípios
2020–202533
Saúde
datasus_mortalidade_infantil		Taxa de mortalidade infantil (óbitos de menores de 1 ano por mil nascidos vivos)
Ministério da Saúde (SIM / SINASC)
2017–20241
Saúde
datasus_profissionais		Vínculos de profissionais de saúde por ocupação (CBO); um profissional em dois estabelecimentos conta duas vezes
DataSUS - CNES (profissionais)
2020–2025753
Saúde
datasus_sim		Óbitos por residência (total, infantis, por causa e sexo) e por ocorrência
Ministério da Saúde - Sistema de Informações sobre Mortalidade (SIM)
2017–202414
Saúde
datasus_sinasc		Nascidos vivos por residência (sexo, parto, peso, idade da mãe, pré-natal, prematuridade) e por ocorrência
Ministério da Saúde - Sistema de Informações sobre Nascidos Vivos (SINASC)
2017–202410
Trabalho
mte_novo_caged		Admissões, desligamentos, saldo e salário médio de admissão por município e mês, total e por seção CNAE (série ajustada)
MTE - Novo CAGED (microdados PDET, pacote cagedr)
2020–202692
Trabalho
mte_rais		Vínculos formais ativos em 31/12 por município: total, sexo, escolaridade, faixa etária, faixa de remuneração e remuneração média
MTE - RAIS (microdados PDET, pacote raisr)
2020–202538
Trabalho
mte_rais_historica		RAIS histórica 1985–2017 por município: vínculos, admissões, desligamentos e remuneração por sexo, faixa etária, escolaridade, setor, porte, tipo de vínculo e ocupação (acervo histórico da Condepe/Fidem)
MTE - RAIS (acervo histórico da Condepe/Fidem)
1985–20179.193
Território 9 fontes · 9.384 indicadores
Tema e fonteDescrição e origemPeríodoIndicadores
Divisão Territorial
ibge_munic		Perfil dos Municípios: gestão, cultura, esporte, ambiente, habitação e risco
IBGE - Pesquisa de Informações Básicas Municipais (MUNIC)
2020–20249.030
Estrutura Fundiária
incra_assentamentos		Assentamentos de reforma agrária por município: acumulado de projetos, área e famílias assentadas, e projetos criados no ano (acervo fundiário do INCRA)
INCRA - Acervo Fundiário, projetos de assentamento · 113 municípios
1986–20264
Estrutura Fundiária
incra_quilombolas		Territórios quilombolas com portaria de reconhecimento do INCRA em Pernambuco: territórios, área e famílias, acumulados por ano (só o Estado: cada território cita mais de um município, sem código)
INCRA - Acervo Fundiário, territórios quilombolas · só Pernambuco
2008–20263
Estrutura Fundiária
incra_sigef		Parcelas de imóveis rurais certificadas no SIGEF por município e ano de aprovação: no ano e acumuladas, total e por natureza (particular, pública); o ano corrente é parcial (acervo fundiário do INCRA)
INCRA - SIGEF, parcelas certificadas (acervo fundiário)
2013–20266
Meio Ambiente
mapbiomas_cobertura		Cobertura e uso da terra por município (MapBiomas Coleção 11, 30 m): área de cada classe da legenda, 1985–2025, e a proporção de vegetação nativa
Projeto MapBiomas - Coleção 11 da Série Anual de Mapas de Cobertura e Uso da Terra do Brasil
1985–202531
Meio Ambiente
mma_cnuc		Unidades de conservação incidentes e área de UC por município (interseção espacial)
MMA - Cadastro Nacional de Unidades de Conservação (CNUC) · 83 municípios
20252
Posição e Extensão
sidra_area_densidade		Área total e densidade demográfica das unidades territoriais
IBGE - Áreas Territoriais
20102
Recursos Hídricos
ana_hidrografia		Hidrografia por município: extensão de cursos d’água e densidade de drenagem, área de espelho d’água, reservatórios acompanhados pela ANA e sua capacidade. Derivada das camadas da ANA recortadas pela Malha Municipal
ANA - Base Hidrográfica Ottocodificada e dados abertos do SNIRH
20265
Recursos Hídricos
apac_reservatorios		Reservatórios monitorados pela APAC: volume armazenado (hm³ e % da capacidade) e capacidade de cada reservatório, por mês (última leitura do mês), e os totais por município do barramento e do Estado
APAC - Agência Pernambucana de Águas e Clima, monitoramento dos reservatórios (SIRH) · 64 municípios
2026301

De onde vêm os dados

Os arquivos ficam em cache em disco por versão do catálogo (condepe_cache_dir()) e são conferidos pelo SHA-256 publicado no catálogo; o catálogo vale por 6 horas. As variáveis CONDEPE_URL, CONDEPE_MIRROR_URL e CONDEPE_CACHE_DIR substituem os padrões.

Fontes, citação e licença

Os números não são produzidos pela Condepe/Fidem: cada série vem de uma fonte pública oficial (IBGE, Ministério da Saúde, INEP, Ministério do Trabalho, Tesouro Nacional, TCE-PE, Banco Central, entre outras), indicada em toda linha pelas colunas fonte_original e arquivo_origem. A Condepe/Fidem coleta, confere, padroniza e organiza essas séries no Observatório de Pernambuco.

Ao usar os dados, cite a fonte original e o Observatório como organizador, com a versão do catálogo. condepe_cite() monta a citação:

condepe.condepe_data("sidra_populacao_estimada").pipe(condepe.condepe_cite)  # uma por fonte
condepe.condepe_cite("datasus_sinasc")                                      # pelo identificador
condepe.condepe_cite()                                                      # o acervo inteiro

Funciona também depois de filtrar ou concatenar, porque usa as colunas id_fonte e fonte_original. Por exemplo:

IBGE - Estimativas da Populacao. Dados organizados pela Condepe/Fidem no Observatório de Pernambuco (fonte sidra_populacao_estimada), versão 2026-11-05_235518, https://cf.pe.gov.br/observatorio/fontes/sidra_populacao_estimada.

A organização (padronização, estrutura, catálogo e metadados) é publicada sob CC BY 4.0; os dados de cada fonte seguem os termos de uso de quem os publicou.

Código: MIT. Para ler ou gravar buckets privados do s3.pe.gov.br com chave de acesso, veja o s3pe; o condepe não precisa de chave, porque os dados abertos do Observatório são públicos. Há um pacote R com as mesmas funções: condepe para R.