readdbc

Leitor puro-Python para arquivos .dbc do DATASUS — formato dBASE III com compressão PKWARE blast. Sem dependências C, sem compilador necessário.

Instalação

pip install climasus_readdbc_py

Requisitos: Python ≥ 3.10, pandas ≥ 2.0

Uso rápido

import readdbc

# Ler arquivo .dbc diretamente como DataFrame pandas
df = readdbc.read_dbc("DOSP2023.dbc")

# Ler arquivo .dbf comum
df = readdbc.read_dbf("dados.dbf")

# Descomprimir bytes brutos de um .dbc para .dbf
with open("DOSP2023.dbc", "rb") as f:
    compressed = f.read()

raw_dbf_bytes = readdbc.blast_decompress(compressed)

O formato DBC

Os arquivos .dbc são distribuídos pelo DATASUS para transferência eficiente dos microdados do SUS (Sistema Único de Saúde). Internamente, são arquivos dBASE III (.dbf) cujo bloco de registros foi comprimido com o algoritmo PKWARE DCL Implode (também chamado de blast).

Layout interno:

[0 .. H)       Cabeçalho DBF não comprimido (H = uint16 LE nos bytes 8-9)
[H .. H+4)     4 bytes de CRC / padding (ignorados)
[H+4 .. EOF)   Dados comprimidos com PKWare blast

A descompressão produz: cabeçalho_dbf + registros_descomprimidos = DBF completo.

API de referência

Projeto ClimaSUS

Este pacote faz parte do ecossistema ClimaSUS — plataforma de análise de dados climáticos e de saúde pública do SUS.

• Repositório principal: https://github.com/climasus/climasus_readdbc_py
• Organização: https://github.com/climasus