POP - Censo e Estimativas (base-populacional-ibge-pop)¶
Resumo¶
O base-populacional-ibge-pop contém as populações residentes dos municípios brasileiros, estratificadas por sexo, situação de domicílio (urbano/rural) e faixa etária, obtidas dos Censos Demográficos, Contagens Populacionais e Projeções Intercensitárias do IBGE e disponibilizadas pelo DATASUS. Cada registro (linha) representa a população de um município, em um ano, para uma combinação de sexo, situação e faixa etária. É a base de denominadores populacionais usada nos indicadores de saúde do SUS para o período de 1980 a 2012.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Não
- Documentação oficial no FTP:
/dissemin/publicos/IBGE/DOC(populacao.pdf, etc.) - Tabelas auxiliares no FTP:
/dissemin/publicos/IBGE/Auxiliar(TAB_POP.zip)
Diretórios e Padrões de Arquivos (meta.py)¶
Diretório FTP (dir) |
Prefixo (filename_prefix) |
Padrão (filename_pattern) |
Extensão | Preliminar |
|---|---|---|---|---|
/dissemin/publicos/IBGE/POP |
POP |
UF + AA (ex.: BR12) |
zip |
Não |
Nomenclatura e Armazenamento Local¶
- No servidor FTP (
ftp.datasus.gov.br): exemplo realPOPBR12.zip—POPé o prefixo,BRindica a cobertura nacional e12o ano de referência (2012). O ZIP contémPOPBR12.DBF,POPBR12.csvePOPBR12.xml; há um arquivo por ano. - No armazenamento local do
datasus-fetcher:data/base-populacional-ibge-pop/<AAAA>/base-populacional-ibge-pop_<AAAA>-<uf>@<AAAAMMDD>.dbc, por exemplodata/base-populacional-ibge-pop/2024/[email protected](o sufixo@AAAAMMDDé a data do arquivo no FTP; arquivos preliminares levam-preliminarno nome do dataset). - Documentação e Tabelas Auxiliares associadas: em
IBGE/DOCestãopopulacao.pdf(este dataset),NT-POPULACAO-RESIDENTE-2000-2024.pdf(sériePOPS) ePop_Residente_TCU_*.pdf(sériePOPT); emIBGE/AuxiliarestáTAB_POP.zip, com definições e conversões.cnv/.defpara tabulação (inclusivePROJPOPUF.DEFe conversões de ano, município e região).
Conteúdo¶
A base é produzida pelo IBGE (Censos Demográficos, Contagens Populacionais e Projeções da População) e disseminada pelo Ministério da Saúde/DATASUS, que padroniza e publica os contingentes populacionais municipais por sexo e faixa etária. O objetivo é fornecer denominadores homogêneos para o cálculo de indicadores epidemiológicos e de gestão do SUS (taxas de incidência, prevalência, mortalidade, cobertura etc.), cobrindo os anos de 1980 a 2012.
O evento gerador são os levantamentos demográficos oficiais do IBGE: os Censos de 1980, 1991, 2000 e 2010; as Contagens Populacionais de 1996; e as Projeções Intercensitárias/Estimativas dos demais anos. Conforme a nota técnica populacao.pdf, cada período tem metodologia própria: as estimativas de 2001 a 2006 usaram a distribuição etária do Censo 2000 aplicada às estimativas TCU; as de 2007 a 2009 vieram de projeto UNFPA/IBGE (método AiBi e Relação de Coortes); as de 2011 e 2012 aplicaram a estrutura do Censo 2010 sobre as estimativas TCU. A unidade de análise é a população residente por município, ano, sexo, situação e faixa etária. Os campos são MUNIC_RES (código IBGE de 6 dígitos, sem dígito verificador), ANO, SEXO (1 - Masculino, 2 - Feminino), SITUACAO (1 - Urbano, 2 - Rural, 3 - Não levantado), FXETARIA (faixa etária em 4 dígitos: 0000 menor de 1 ano, 0101..1919 idades simples, 0004, 0509, 1014... grupos quinquenais, 8099 80 anos e mais, I000 idade ignorada) e POPULACAO.
A base só contempla detalhamento por situação urbano/rural nos anos censitários e em 1996, conforme a tabela de disponibilidade da nota técnica. As estimativas de 2011 e 2012 não têm abertura urbano/rural (recebem SITUACAO = 3). Não há diretório preliminar. A cobertura no FTP encerra-se em 2012, quando passou a ser publicada a série POPS (2000 em diante, por sexo e idade simples).
Aplicações analíticas típicas: denominadores de taxas de mortalidade/incidência, cobertura de atenção básica e de vacinação, distribuição etária e por sexo da população, índices de envelhecimento e razão de sexos, planejamento de serviços por porte populacional e estudos demográficos de série histórica longa.
Cobertura observada¶
- Índice do FTP (2026-10): 33 arquivos, de 1980 a 2012, 1 UF(s) com arquivos, última atualização em 2015-11-10.
- Conversão local de amostras (2 arquivo(s) Parquet, de 1980 a 2012), feita em 2026-11-16 com o
datasus-fetcher0.19.0: serve de base ao esquema de referência. Períodos fora das amostras podem ter colunas que não aparecem aqui.
Variáveis de uso mais frequente (resumo da versão anterior desta página)¶
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
MUNIC_RES |
String (6) | Código IBGE do município de residência (sem dígito verificador) |
ANO |
Inteiro (AAAA) |
Ano de referência da população |
SEXO |
Inteiro (1) | Sexo: 1 - Masculino, 2 - Feminino |
SITUACAO |
Inteiro (1) | Situação de domicílio: 1 - Urbano, 2 - Rural, 3 - Não levantado |
FXETARIA |
String (4) | Faixa etária (idade simples, quinquenal, 8099 = 80+, I000 = ignorada) |
POPULACAO |
Inteiro (até 9) | População residente para a combinação município/ano/sexo/situação/faixa |
Variáveis¶
Descrições tiradas do informe técnico ou do dicionário de dados do DATASUS quando o campo consta do documento; textos marcados "inferido do nome do campo" não têm definição oficial; "Sem descrição na documentação oficial consultada" é lacuna a preencher. Tipo e Período vêm do esquema de referência (conversão local de amostras): Período é o intervalo de partições amostradas em que a coluna existe, e todos significa todas as amostras. Na fonte é o nome do campo no DBF.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
munic_res |
MUNIC_RES |
texto | Código do município pelo padrão IBGE, com 6 dígitos (sem o dígito verificador) | — | todos |
sexo |
SEXO |
texto | Sexo: 1 masculino; 2 feminino | 1 masculino; 2 feminino | todos |
situacao |
SITUACAO |
texto | Situação de domicílio: 1 urbano; 2 rural; 3 não levantado (só nos anos em que há detalhamento) | 1 urbano; 2 rural; 3 não levantado | todos |
fxetaria |
FXETARIA |
texto | Faixa etária da população, em 4 dígitos | 0000 menor de 1 ano; 0101 a 1919 idades de 1 a 19 anos; 0004, 0509, 1014... 7579 grupos de 5 anos; 8099 80 anos e mais; I000 idade ignorada | todos |
populacao |
POPULACAO |
inteiro | População residente estimada ou recenseada, em pessoas | — | todos |
uf |
— | texto | UF do arquivo de origem (sigla em minúsculas, br para arquivos nacionais), gravada pelo conversor; as linhas do período saem ordenadas por ela |
sigla da UF | todos |
_origem |
— | texto | Chave do arquivo bruto que originou a linha (nome do arquivo no FTP, sem o carimbo de data), gravada pelo conversor | texto | todos |
No lake¶
- Dataset no lake:
datasus/base-populacional-ibge-pop, particionado porano(diretórioschave=valor). A UF do arquivo de origem vai na colunauf(as linhas do período saem ordenadas por ela) e o nome do arquivo bruto, na coluna_origem; os arquivos de uma mesma partição compartilham um Parquet. - Chave: sem chave natural declarada. Nenhuma combinação de colunas foi conferida como única nas amostras; para tirar duplicatas, defina a chave por consulta (ver Cuidados de uso).
- Tipos nas amostras (número de colunas): inteiro: 1, texto: 6.
- Transformações do conversor (
datasus-fetcher0.19.0,wrangle_datasuseLakeConverter): nomes de coluna em minúsculas; textos aparados (espaços das pontas saem); valores de preenchimento (texto vazio,NA,null,Nonee códigos como999999e00000000, conforme a listaSENTINEL_NULLSdo pacote) viram nulo; colunas de código (CID, CNES, município, procedimento, CEP, número de AIH e semelhantes) ficam como texto, preservando zeros à esquerda; colunas de data no formatoAAAAMMDDviram data (valores inválidos interrompem a conversão em vez de virarem nulo); valores monetários com casas decimais ficam como decimal exato; registros marcados como excluídos no DBF são descartados; arquivos DBC sem nenhuma linha não passam pela limpeza (ver Cuidados de uso). - Esquema de referência:
base-populacional-ibge-pop.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- a disponibilidade de abertura por situação urbano/rural e por idade simples varia por ano (ver nota técnica); o total de municípios muda ao longo da série por criação/emancipação de municípios e mudanças de divisão administrativa; houve quebras metodológicas em 1992, 2007 (método AiBi) e 2011-2012, recomendando cautela em séries longas; e o município de Pinto Bandeira/RS teve população agregada a Bento Gonçalves/RS em 2003-2012 por decisão judicial. (texto da versão anterior desta página; não reconferido nesta revisão.)
- Dado pessoal: as colunas listadas em
dados_pessoaisno cabeçalho são o inventário por nome de coluna; atributos demográficos e territoriais (sexo, raça/cor, idade, município de residência) não entram na lista, mas combinados podem identificar uma pessoa.
Exemplos¶
Consulta sobre o lake (polars)¶
Quantas linhas há por período e por UF do arquivo de origem? (confere a cobertura do lake antes de qualquer análise)
from pathlib import Path
import polars as pl
arquivos = sorted(Path("lake/datasus/base-populacional-ibge-pop").glob("**/*.parquet"))
dados = pl.concat( # períodos diferentes têm colunas e tipos diferentes
[pl.scan_parquet(a, hive_partitioning=True) for a in arquivos],
how="diagonal_relaxed",
)
(dados.group_by("ano", "uf").agg(pl.len().alias("linhas")).sort("ano", "uf").collect())
O caminho lake/ é a raiz do lake (a pasta que contém datasus/). A consulta foi executada sobre a conversão local de amostras de 2026-11-16.
Pela linha de comando (datasus-fetcher)¶
# o que o FTP publica para o dataset (arquivos e tamanho)
datasus-fetcher list base-populacional-ibge-pop
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync base-populacional-ibge-pop -o ./data --start 2020 --end 2024 --docs --aux
# converte o que foi baixado para o lake (Parquet particionado)
datasus-fetcher convert -i ./data -o ./lake --dataset base-populacional-ibge-pop
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/IBGE/POP - Portal de Transferência de Arquivos do DATASUS: https://datasus.saude.gov.br/transferencia-de-arquivos/
- TabNet DATASUS: https://datasus.saude.gov.br/informacoes-de-saude-tabnet/
- IBGE — Censos e Projeções da População: https://www.ibge.gov.br/estatisticas/sociais/populacao.html
- Nota técnica
populacao.pdf(📎 "População Residente — Censos, Contagens Populacionais e Projeções Intercensitárias") e pacoteTAB_POP.zipno FTP DATASUS - RIPSA — Rede Interagencial de Informações para a Saúde: https://www.ripsa.org.br/