Inquérito de Tracoma (sinan-trac)¶
Resumo¶
Registros de inquéritos populacionais de tracoma (busca ativa de casos) conduzidos no âmbito da vigilância epidemiológica e registrados no SINAN. Cada linha representa o resultado do exame oftalmológico de um indivíduo examinado durante um inquérito domiciliar, escolar ou comunitário.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Sim (diretório PRELIM, 2025–2026; Finais até 2024)
- Documentação oficial no FTP:
/dissemin/publicos/SINAN/DOCS - Tabelas auxiliares no FTP:
/dissemin/publicos/SINAN/AUXILIAR
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/SINAN/DADOS/FINAIS |
TRAC |
UF + AA (uf_year2_pattern) |
dbc |
Não |
/dissemin/publicos/SINAN/DADOS/PRELIM |
TRAC |
UF + AA (uf_year2_pattern) |
dbc |
Sim |
Nomenclatura e Armazenamento Local¶
- No servidor FTP (
ftp.datasus.gov.br): exemploTRACBR24.dbc, em queTRACé o prefixo do agravo,BRindica a base nacional (arquivo único por ano para o Brasil) e24é o ano com 2 dígitos (2024). - No armazenamento local do
datasus-fetcher:data/sinan-trac/<AAAA>/sinan-trac_<AAAA>-<uf>@<AAAAMMDD>.dbc, por exemplodata/sinan-trac/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 (grupo
sinan, compartilhadas por todos os agravos): - Documentação (
/SINAN/DOCS):Docs_TAB_SINAN.zip(~65 MB),POP_I_Acesso_a_Microdados_5.pdf,POP_II_Descompactacao_expansao_conversao_3.pdf,POP_III_Instalacao_do_tabulador_TabWin_3.pdf. - Tabelas auxiliares (
/SINAN/AUXILIAR):TAB_SINANNET.zip(~44 MB),TAB_SINANONLINE.zip(~240 KB),POPT_Estimativa_TCU_2019_Sinan.zip. - O dicionário desta base (
Inquérito de Tracoma) é distribuído no Portal SINAN; não há PDF por agravo no FTP.
Conteúdo¶
O inquérito de tracoma integra o Programa de Vigilância e Controle do Tracoma da Secretaria de Vigilância em Saúde e Ambiente (SVSA/MS), alinhado à meta da OMS de eliminação do tracoma como problema de saúde pública até 2030. O tracoma é uma ceratoconjuntivite crônica causada por Chlamydia trachomatis, doença tropical negligenciada associada a condições precárias de saneamento, aglomeração e higiene, com maior prevalência em áreas rurais, ribeirinhas e periferias urbanas.
O evento gerador é o exame oftalmológico realizado em massa durante inquéritos de busca ativa, com o objetivo de estimar a prevalência de tracoma, especialmente a forma folicular (TF) em crianças de 1 a 9 anos — indicador-chave de eliminação. A unidade de análise é o indivíduo examinado (um registro por pessoa), e não apenas os casos confirmados; por isso a base é mais ampla que a notificação individual. O diagnóstico segue a classificação OMS (TF, TI, TS, TT, CO).
O instrumento é a Ficha de Inquérito de Tracoma, que registra dados do município e localidade investigada, características do indivíduo examinado (idade, sexo, escola), data do exame, resultado por olho (direito/esquerdo), forma clínica e tratamento. A série no FTP inicia em 2009; os dados de 2025 e 2026 estão em PRELIM e sujeitos a revisão.
Principais usos: cálculo de prevalência de tracoma e de TF em crianças, monitoramento de indicadores de eliminação, avaliação de campanhas de tratamento em massa com azitromicina e priorização de municípios e localidades para intervenção (saneamento, educação em saúde e busca ativa).
Cobertura observada¶
- Índice do FTP (2026-10): 18 arquivos, de 2009 a 2026, 1 UF(s) com arquivos, última atualização em 2026-05-29.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2009 a 2026), 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)¶
As colunas abaixo foram extraídas do cabeçalho do arquivo mais recente (TRACBR26.dbc). Por padrão, wrangle_datasus converte os nomes de coluna para minúsculas.
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
DT_NOTIFIC |
Data (AAAAMMDD) | Data da notificação do registro. |
ID_AGRAVO |
String | Código CID-10 do agravo notificado (A71). |
SEM_NOT |
String | Semana epidemiológica da notificação (AAAASS). |
NU_ANO |
String | Ano da notificação. |
SG_UF_NOT |
String | UF de notificação (código IBGE de 2 dígitos). |
ID_MUNICIP |
String | Município de notificação (código IBGE, 6 dígitos). |
ID_REGIONA |
String | Código da regional de saúde. |
ID_UNIDADE |
String | Código CNES da unidade responsável (7 dígitos). |
CS_INQUERI |
String | Tipo de inquérito realizado. |
NU_CASO |
Inteiro | Número de casos registrados. |
SG_UF |
String | UF de residência (código IBGE de 2 dígitos). |
ID_MUNI_RE |
String | Município de residência (código IBGE, 6 dígitos). |
CS_SEXO |
String | Sexo (M, F, I = ignorado). |
NU_IDADE_N |
Inteiro | Idade. |
FORMA_TF / FORMA_TI / FORMA_TS / FORMA_TT / FORMA_CO |
String | Indicadores das formas clínicas: TF (folicular), TI (inflamatório intenso), TS (cicatricial), TT (triquíase) e CO (opacificação da córnea). |
ENCAMINHA |
String | Encaminhamento do examinado. |
DT_DIGITA |
Data (AAAAMMDD) | Data de digitação do registro. |
DT_TRANSUS / DT_TRANSDM / DT_TRANSSM / DT_TRANSRM / DT_TRANSRS / DT_TRANSSE |
Data (AAAAMMDD) | Datas de transferência do registro entre as esferas do SINAN (US, distrital/municipal, estadual/regional, federal). |
NU_LOTE_V / NU_LOTE_H |
String | Números dos lotes de transferência vertical e horizontal. |
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 |
|---|---|---|---|---|---|
dt_notific |
DT_NOTIFIC |
data | Data da Notificação. Data de preenchimento da ficha de notificação | — | todos |
id_agravo |
ID_AGRAVO |
texto | Agravo. Tabela de agravos do sistema com códigos (classificação internacional de doenças –CID 10) e nomes dos agravos classificados como notificação compulsória ( nacional, estadual ou municipal) e as síndromes ( febre hemorragia aguda;respiratória aguda; diarréia aguda; sanguinolenta; | — | todos |
sem_not |
SEM_NOT |
texto | Semana epidemiológic a da notificação (campo interno) | — | todos |
nu_ano |
NU_ANO |
texto | (campo interno). Ano da notificação | — | todos |
sg_uf_not |
SG_UF_NOT |
texto | UF de Notificação. Sigla da Unidade Federativa onde está localizada a unidade de saúde (ou outra fonte notificadora) que realizou a notificação. A sigla é uma variável que está associada ao código na tabela | — | todos |
id_municip |
ID_MUNICIP |
texto | Município de Notificação | — | todos |
id_regiona |
ID_REGIONA |
texto | (campo interno). Regional de saúde onde está localizado o município da unidade de saúde ou outra fonte notificadora | — | todos |
id_unidade |
ID_UNIDADE |
texto | Unidade de saúde ou outra fonte notificadora | — | todos |
cs_inqueri |
CS_INQUERI |
texto | Indica caso identificado em inquérito (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
nu_caso |
NU_CASO |
inteiro | Número de casos (inquérito) (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
sg_uf |
SG_UF |
texto | UF. Sigla da Unidade Federada de residência do paciente por ocasião da notificação. A sigla é uma variável que está associada ao código na tabela | — | todos |
id_muni_re |
ID_MUNI_RE |
texto | Município. Código do | — | todos |
cs_sexo |
CS_SEXO |
texto | Sexo. M- Masculino F- Feminino I- Ignorado | — | todos |
nu_idade_n |
NU_IDADE_N |
inteiro | Idade. A composição da variável obedece o seguinte critério: 1o | — | todos |
forma_tf |
FORMA_TF |
texto | Dado do inquérito de tracoma (FORMA_TF) |
— | todos |
forma_ti |
FORMA_TI |
texto | Dado do inquérito de tracoma (FORMA_TI) |
— | todos |
forma_ts |
FORMA_TS |
texto | Dado do inquérito de tracoma (FORMA_TS) |
— | todos |
forma_tt |
FORMA_TT |
texto | Dado do inquérito de tracoma (FORMA_TT) |
— | todos |
forma_co |
FORMA_CO |
texto | Dado do inquérito de tracoma (FORMA_CO) |
— | todos |
encaminha |
ENCAMINHA |
texto | Dado do inquérito de tracoma (ENCAMINHA) |
— | todos |
dt_digita |
DT_DIGITA |
data | Data de digitação. Data de Digitação da primeira inclusão da notificação no sistema | — | todos |
dt_transus |
DT_TRANSUS |
data ou texto | Data de transferência da unidade de saúde. Data de Transferência do registro da Unidade de Saúde para do nível superior do sistema | — | todos |
dt_transdm |
DT_TRANSDM |
data ou texto | Data de transferência do distrito municipal. Data de Transferência do registro do Distrito Municipal para do nível superior do sistema | — | todos |
dt_transsm |
DT_TRANSSM |
data ou texto | Data de transferência da secretaria municipal de saúde. Data de Transferência do registro da secretaria municipal para do nível superior do sistema | — | todos |
dt_transrm |
DT_TRANSRM |
data ou texto | Data de transferência da regional municipal. Data de Transferência do registro da Regional Municipal para do nível superior do sistema | — | todos |
dt_transrs |
DT_TRANSRS |
data ou texto | Data de transferência da regional de saúde. Data de Transferência do registro da Regional de Saúde para do nível superior do sistema | — | todos |
dt_transse |
DT_TRANSSE |
data ou texto | Data de transferência da secretaria estadual de saúde. Data de Transferência do registro da Secretaria Estadual para do nível superior do sistema | — | todos |
nu_lote_v |
NU_LOTE_V |
texto | Número do lote vertical. Descrever aqui a estrutura da composição do número do lote | — | todos |
nu_lote_h |
NU_LOTE_H |
texto | Número do lote horizontal | — | 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/sinan-trac, 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): data: 8, inteiro: 2, texto: 27.
- 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). - Colunas renomeadas por colidir com partição (SINAN):
UFvirauf_hospital. - Esquema de referência:
sinan-trac.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- este é o inquérito (busca ativa, indivíduos examinados), distinto da notificação individual de casos em
sinan-ntra. O denominador é o número de examinados, e a base não deve ser usada para contagem de casos notificados. Os leiautes variam substancialmente entre campanhas, especialmente nos indicadores de forma clínica (FORMA_*). Os arquivosBRreúnem todas as UFs; useSG_UF_NOTouID_MUNICIPconforme a pergunta. Arquivos do diretório PRELIM (2025+) são preliminares; deduplique com cautela ao combinar as fontes. (texto da versão anterior desta página; não reconferido nesta revisão.) - Tipo que varia entre períodos:
dt_transus,dt_transdm,dt_transsm,dt_transrm,dt_transrs,dt_transseaparecem com mais de um tipo nas amostras (por exemplo, inteiro em alguns períodos e texto em outros); leia a colunaTipodo dicionário e converta explicitamente antes de empilhar períodos. Evidência: conversão local de amostras em 2026-11-16,datasus-fetcher0.19.0. - 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 fichas foram notificadas por ano e UF de notificação?
from pathlib import Path
import polars as pl
arquivos = sorted(Path("lake/datasus/sinan-trac").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", "sg_uf_not")
.agg(pl.len().alias("fichas"))
.sort("ano", "sg_uf_not")
.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 sinan-trac
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sinan-trac -o ./data --start 2020 --end 2024 --regions br --docs --aux
# converte o que foi baixado para o lake (Parquet particionado)
datasus-fetcher convert -i ./data -o ./lake --dataset sinan-trac
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/SINAN/DADOS/ - 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/
- Portal SINAN (Ministério da Saúde): https://portalsinan.saude.gov.br/
- Ficha e dicionário do inquérito (Inquérito de Tracoma): https://portalsinan.saude.gov.br/
- Guia de Vigilância em Saúde (SVSA/MS), capítulo Tracoma: https://www.gov.br/saude/pt-br/centrais-de-conteudo/publicacoes/svsa/guia-de-vigilancia-em-saude
- Lista Nacional de Notificação Compulsória (Portaria de Consolidação nº 4/2017, Anexo V, atualizada pela Portaria GM/MS nº 217/2023 e pela Portaria GM/MS nº 5.201/2024): https://www.gov.br/saude/pt-br/composicao/svsa
- OMS — Eliminação do tracoma como problema de saúde pública (metas 2030): https://www.who.int/health-topics/trachoma