Pular para conteúdo

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.py também consulta PRELIM, mas hoje o diretório não contém arquivos do agravo (toda a série está em FINAIS)
  • 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 real ESPOBR22.dbc — ESPO é o prefixo do agravo (Esporotricose), BR indica a consolidação nacional de todo o país e 22 é o ano de notificação (2022). O agravo publica apenas em FINAIS, de 2013 a 2022 (sem PRELIM), 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 exemplo data/sinan-espo/2024/[email protected] (o sufixo @AAAAMMDD é a data do arquivo no FTP; arquivos preliminares levam -preliminar no nome do dataset).
  • Documentação e Tabelas Auxiliares associadas: no diretório SINAN/DOCS estão Docs_TAB_SINAN.zip e as instruções POP_I/II/III de acesso, descompactação e tabulação; em SINAN/AUXILIAR estão TAB_SINANNET.zip, TAB_SINANONLINE.zip e POPT_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-fetcher 0.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 por ano (diretórios chave=valor). A UF do arquivo de origem vai na coluna uf (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-fetcher 0.19.0, wrangle_datasus e LakeConverter): nomes de coluna em minúsculas; textos aparados (espaços das pontas saem); valores de preenchimento (texto vazio, NA, null, None e códigos como 999999 e 00000000, conforme a lista SENTINEL_NULLS do 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 formato AAAAMMDD viram 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): UF vira uf_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 FINAIS 2013–2022 sem arquivos preliminares; e os campos G_D/G_M/C_D/C_M frequentemente vêm em branco (ex.: em ESPOBR13.dbc C_D/C_M vazios), 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_m aparecem com mais de um tipo nas amostras (por exemplo, inteiro em alguns períodos e texto em outros); leia a coluna Tipo do dicionário e converta explicitamente antes de empilhar períodos. Evidência: conversão local de amostras em 2026-11-16, datasus-fetcher 0.19.0.
  • Dado pessoal: as colunas listadas em dados_pessoais no 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)