Esporotricose (Epizootia) (sinan-espo)¶
Resumo¶
O sinan-espo contém os registros de notificação de epizootias e casos animais de Esporotricose (dermatofitose por Sporothrix spp., transmissível de felinos a humanos) registrados no módulo específico do Sistema de Informação de Agravos de Notificação (SINAN) do Ministério da Saúde. Cada registro (linha) representa a notificação consolidada de ocorrência de esporotricose em animais (com destaque para felinos, principal reservatório dos surtos urbanos), registrada por unidades de saúde e serviços de zoonoses e digitada no SINAN Net — leiaute compacto de 17 colunas com identificação da notificação, período (semana/mês), local (UF/município), zona e ambiente de ocorrência (TP_ZN_OCO/TP_AMB_OCO), espécie animal (ESPECIE) e indicadores de ocorrência em gatos (G_D/G_M) e cães (C_D/C_M) — suporte à Vigilância Integrada em Zoonoses (esporotricose felina/canina e notificação humana) instituída pela Nota Técnica nº 60/2023-CGZV/DEDT.
Ficha técnica¶
Origem e coleta¶
- Arquivos preliminares: Sim —
meta.pytambém consultaPRELIM, mas hoje o diretório não contém arquivos do agravo (toda a série está emFINAIS) - 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 |
ESPO |
UF + AA (2 dígitos; na prática consolidações BR anuais) |
dbc |
Não |
/dissemin/publicos/SINAN/DADOS/PRELIM |
ESPO |
UF + AA (2 dígitos) | dbc |
Sim |
Nomenclatura e Armazenamento Local¶
- No servidor FTP (
ftp.datasus.gov.br): exemplo realESPOBR22.dbc—ESPOé o prefixo do agravo (Esporotricose),BRindica a consolidação nacional de todo o país e22é o ano de notificação (2022). O agravo publica apenas emFINAIS, de 2013 a 2022 (semPRELIM), com atualizações em 08–18/01/2024. - No armazenamento local do
datasus-fetcher:data/sinan-espo/<AAAA>/sinan-espo_<AAAA>-<uf>@<AAAAMMDD>.dbc, por exemplodata/sinan-espo/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: no diretório
SINAN/DOCSestãoDocs_TAB_SINAN.zipe as instruções POP_I/II/III de acesso, descompactação e tabulação; emSINAN/AUXILIARestãoTAB_SINANNET.zip,TAB_SINANONLINE.zipePOPT_Estimativa_TCU_2019_Sinan.zip(denominadores populacionais). A normatização do agravo está na Nota Técnica nº 60/2023-CGZV/DEDT (Vigilância da Esporotricose).
Conteúdo¶
A esporotricose é uma zoonose micótica em expansão no Brasil, associada à transmissão preferencial por felinos domiciliados e errantes (Sporothrix brasiliensis), com surtos urbanos reiteradamente descritos desde os anos 1990 (notadamente no Rio de Janeiro). Em 2023, a vigilância do agravo foi normatizada pela Nota Técnica nº 60/2023-CGZV/DEDT (Coordenação-Geral de Vigilância das Zoonoses e Doenças de Transmissão Veterinária/DEDT/SVSA), que institui a vigilância integrada de esporotricose em humanos e animais — as epizootias em felinos e cães passam a ser registradas em módulo próprio do SINAN, em regra pelos serviços de zoonoses e pelas unidades de saúde
O evento gerador deste dataset é a ficha de notificação de esporotricose animal do SINAN (módulo de epizootias, referenciado pela Nota Técnica do agravo). Cada registro é uma notificação consolidada por município-semana, com: identificação da notificação (ID_NOTIFIC, sequencial), ano (NU_ANO), data de notificação e de digitação (DT_NOTIFIC, DT_DIGITA), UF e município (SG_UF_NOT, ID_MUNICIP), semanas epidemiológicas de notificação e de início da epizootia (SEM_NOT, SEM_PRI), data de início da epizootia (DT_INI_EPI), zona da ocorrência (TP_ZN_OCO: urbana, rural, periurbana, ignorado), ambiente onde ocorreu a epizootia (TP_AMB_OCO: 1 - Domicílio, 2 - Parque, praça ou zoológico, 3 - Área Silvestre, 4 - Reserva Ecológica, 5 - Outro, com descrição em DS_OUT_AMB), espécie animal afetada (ESPECIE, código conforme dicionário — nos dados observados, o valor 1 concentra a vigilância de felinos) e presença de animais sintomáticos/óbitos por espécie: gatos (G_D = doentes, G_M = mortos) e cães (C_D = doentes, C_M = mortos), campos binários/contagem conforme a ficha. A unidade de análise é a notificação de epizootia/caso animal.
A série histórica é curta e recente: o FTP contém apenas as bases FINAIS de 2013 a 2022 (10 arquivos, sem diretório PRELIM), com última atualização em 08/01/2024 (dois arquivos reenviados em 18/01/2024). O volume inicial é minúsculo (arquivo de 2013 com poucas dezenas de registros, concentrados em municípios do Rio de Janeiro — SG_UF_NOT 33) e cresce ao longo dos anos: a vigilância de esporotricose animal (notificação por município/felino) se expande nacionalmente nos anos seguintes, via serviços de zoonoses/CIEVS (módulo de "Sistemas Auxiliares" do SINAN — Epizootias).
Aplicações analíticas típicas: evolução do número de notificações por ano/UF (NU_ANO, SG_UF_NOT); distribuição de zona e ambiente (TP_ZN_OCO, TP_AMB_OCO) — perfil urbano/domiciliar da esporotricose felina; espécie e indicadores por espécie (ESPECIE, gatos vs cães em G_D/C_D); sazonalidade por semana epidemiológica (SEM_NOT, SEM_PRI); e correlação com casos humanos de esporotricose em municípios com notificação ativa (vigilância integrada NT 60/2023).
Cobertura observada¶
- Índice do FTP (2026-10): 10 arquivos, de 2013 a 2022, 1 UF(s) com arquivos, última atualização em 2024-01-18.
- Conversão local de amostras (5 arquivo(s) Parquet, de 2013 a 2022), 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)¶
Schema extraído de ESPOBR13.dbc (17 colunas depois de remover _deleted).
| Coluna (DBF) | Tipo / Formato | Descrição |
|---|---|---|
ID_NOTIFIC |
Inteiro | Número sequencial da notificação de epizootia/caso animal |
NU_ANO |
Inteiro | Ano da notificação |
DT_NOTIFIC / DT_DIGITA |
Data (AAAAMMDD) |
Data da notificação e de digitação no SINAN |
SG_UF_NOT / ID_MUNICIP |
String 2/6 | Código das UF (IBGE) e de município (IBGE) de notificação |
SEM_NOT / SEM_PRI |
String AAAASS |
Semanas epidemiológicas de notificação e de início da epizootia |
DT_INI_EPI |
Data (AAAAMMDD) |
Data do início da epizootia (não deve ser maior que a data de notificação) |
TP_ZN_OCO |
String (1) | Zona onde ocorreu a epizootia: 1 - Urbana, 2 - Rural, 3 - Periurbana, 9 - Ignorado |
TP_AMB_OCO |
String (1) | Ambiente onde ocorreu a epizootia: 1 - Domicílio, 2 - Parque/praça/zoológico, 3 - Área Silvestre, 4 - Reserva Ecológica, 5 - Outro |
DS_OUT_AMB |
String (30) | Descrição do outro ambiente (habilitado se TP_AMB_OCO = 5) |
ESPECIE |
Inteiro | Espécie animal notificada (código conforme ficha; nos dados observados o valor 1 concentra a vigilância de felinos) |
G_D / G_M |
String (1) | Presença/ocorrência de gatos doentes e de gatos mortos |
C_D / C_M |
String (1) | Presença/ocorrência de cães doentes e de cães mortos |
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 |
|---|---|---|---|---|---|
id_notific |
ID_NOTIFIC |
inteiro | Código (tipo, identificação ou classificação) registrado na ficha de Esporotricose (Epizootia) (ID_NOTIFIC); o dicionário consultado não define o campo isoladamente |
— | todos |
nu_ano |
NU_ANO |
inteiro | (campo interno). Ano da notificação | — | todos |
dt_notific |
DT_NOTIFIC |
data | Data da Notificação. Data de preenchimento da ficha de notificação | — | todos |
dt_digita |
DT_DIGITA |
data | Data de digitação. Data de Digitação da primeira inclusão da notificação no sistema | — | 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 |
sem_not |
SEM_NOT |
texto | Semana epidemiológic a da notificação (campo interno) | — | todos |
sem_pri |
SEM_PRI |
texto | Semana epidemiológic a dos primeiros sintomas/ diagnósticos. (campo interno) | — | todos |
dt_ini_epi |
DT_INI_EPI |
data | Data de início da epizootia (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
tp_zn_oco |
TP_ZN_OCO |
texto | Zona de ocorrência da epizootia (urbana, rural ou periurbana) (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
tp_amb_oco |
TP_AMB_OCO |
texto | Ambiente de ocorrência da epizootia (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
ds_out_amb |
DS_OUT_AMB |
texto | Descrição de outro ambiente de ocorrência da epizootia (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
especie |
ESPECIE |
inteiro | Espécie do animal (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
g_d |
G_D |
inteiro | Número de animais doentes (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
g_m |
G_M |
inteiro | Número de animais mortos (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
c_d |
C_D |
inteiro | Número de animais doentes (inferido do nome do campo; sem definição na documentação oficial consultada) | — | todos |
c_m |
C_M |
inteiro ou texto | Número de animais mortos (inferido do nome do campo; sem definição na documentação oficial consultada) | — | 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-espo, 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: 3, inteiro: 7, texto: 10.
- 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-espo.schema.json, gerado por conversão local de amostras. Tipos listados com mais de um valor variam entre partições.
Cuidados de uso¶
- base de notificação de epizootia/casos animais — não há registros individuais de pacientes, dados clínicos, exames ou desfechos humanos neste dataset (casos humanos de esporotricose migraram para vigilância integrada à parte, via NT 60/2023); cobertura restrita a
FINAIS2013–2022 sem arquivos preliminares; e os camposG_D/G_M/C_D/C_Mfrequentemente vêm em branco (ex.: emESPOBR13.dbcC_D/C_Mvazios), exigindo tratamento cuidadoso de nulos para não confundir "sem info" com "não ocorreu". (texto da versão anterior desta página; não reconferido nesta revisão.) - Tipo que varia entre períodos:
c_maparecem 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-espo").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-espo
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync sinan-espo -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-espo
Referências¶
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/dissemin/publicos/SINAN/DADOS/FINAIS - 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 — Epizootias/Esporotricose (Sistemas Auxiliares do SINAN): https://portalsinan.saude.gov.br
- Nota Técnica nº 60/2023-CGZV/DEDT (Vigilância da Esporotricose, humana e em animais — CGZV/DEDT/SESSAS/MS)
- Portaria GM/MS nº 204/2016 (consolidação da notificação compulsória do SUS), Lei nº 6.259/1975 e Decreto nº 78.231/1976
- PCDaS/Fiocruz — SINAN: https://pcdas.icict.fiocruz.br/conteudo/tecnico/sinan
- Guia de Vigilância em Saúde (SVSA/MS, Ed. atual) — capítulo de micose cutânea/dermatofitoses e vigilância de zoonoses (zoonoses urbanas)