Python JavaScript PHP HTML Shell

4HAM Spectrum Analysis

Observatório de espetro HF/VHF autoalojado, potenciado por RTL-SDR. Descodifica FT8, FT4, WSPR, CW e APRS, mapeia a propagação em tempo real e exporta análises académicas.

Um observatório abrangente e autoalojado para a atividade de rádio amador em HF/VHF. Transforma um dispositivo RTL-SDR económico, associado a um PC Linux ou Raspberry Pi, num laboratório de propagação e ocupação em funcionamento contínuo.

Funcionalidades Principais

4ham-spectrum-analysis é um observatório completo e autoalojado para a atividade de rádio amador em HF/VHF, concebido para transformar um RTL-SDR económico (ou SDR compatível), associado a um PC Linux ou Raspberry Pi, num laboratório de propagação e ocupação em funcionamento contínuo e cientificamente rigoroso.

A plataforma combina:

  • DSP e waterfall em tempo real — deteção adaptativa de ocupação por potência/limiar, espetro e waterfall no browser, extração de SNR/Doppler/crista por evento.
  • Pipeline multi-descodificador — FT8/FT4/WSPR via WSJT-X, CW através de detetor por filtro adaptado próprio, SSB por deteção de atividade vocal com transcrição opcional via Whisper ASR, APRS via Direwolf KISS (RF) e APRS-IS (TCP), com uma classificação unificada de 3 regras rf_gated no mapa e nas análises.
  • Análise de balizas NCDXF/IARU — agendador de slots de 10 s alinhado ao UTC, a monitorizar 18 balizas fixas nas bandas de 20/17/15/12/10 m, separador próprio no dashboard com KPIs, contexto ionosférico, pontuação de propagação por banda, matriz de atividade recente e sobreposição multi-banda das balizas diretamente no globo de propagação principal.
  • Pontuação de propagação por descodificação confirmada — só eventos verificados com indicativo+SNR alimentam a pontuação de propagação; eventos sem indicativo são registados como ocupação de banda mas excluídos da pontuação, mantendo a métrica defensável para uso académico.
  • Rotação automática de varrimento multi-banda — permanência configurável, predefinições, agendador, contagem decrescente em direto, interface sensível ao modo.
  • Dashboard de Análises Académicas — pontuação de propagação, mapas de calor por banda, indicadores instrumentais de KPI, agregações históricas (1 h → 30 dias), exportações exaustivas em XLSX/CSV com enriquecimento de DXCC/locator/fonte.
  • Espelho público (push-mirror) para alojamento PHP+MySQL partilhado — réplica só de leitura do dashboard de Análises Académicas, publicada a cada 5 min via snapshots JSON assinados, sem necessidade de redirecionamento de portas, sem WebSocket e sem superfície de administração do lado público (ex.: https://cs5arc.pt/external_academic_analytics/).
  • Operação de nível de produção — empacotamento systemd, instalador gráfico whiptail, SQLite em modo WAL com índices compostos, logs estruturados, autenticação de admin com bcrypt, replicação do espelho assinada com HMAC-SHA256.
  • Este software serve exclusivamente como um guia de ciência rádio para uma estação de rádio amador em funcionamento ou para a análise de dados radioelétricos pela comunidade científica.