HERTZ V2.0

Info

Build 347 - 2026-09-20 21:05:18 CEST

Recent Updates

Implementazioni introdotte tra 9 aprile 2026 e 4 agosto 2026.

4 Aug 2026

ERP — la heatmap torna a mostrare il segno: il pannello e` stato riscritto da capo. la ERP image precedente calcolava una RMS a finestra scorrevole e la divideva per il massimo globale della matrice, quindi il segno spariva e un solo trial saturo schiacciava tutti gli altri in fondo alla scala colori. Misurato sul confronto con NeuroExplorer: l'83% dei pixel sotto 0.15 della colormap, mediana 0.071; con il valore predefinito di 1 ms a 1 kHz la finestra RMS valeva un campione, cioe` l'immagine era letteralmente |x| / max|x|. La media ERP invece era gia` corretta, r = 0.98 sulle tracce sovrapposte. Il nuovo pannello tiene l'ampiezza con segno, scala divergente centrata sullo zero e limiti da percentile robusto di |x|.
Pipeline in Rust, una chiamata per tutti i gruppi: erp2_compute_ptr esegue estrazione epoche, baseline, media e SEM, lisciatura, percentile e ordinamento; il canale attraversa il confine JS/wasm una volta sola e torna come buffer concatenati con gli offset per gruppo. Media e SEM si calcolano prima della lisciatura, il percentile dopo: una media mobile abbassa i picchi, e riusare la scala dei dati grezzi sbiadirebbe l'immagine invece di renderla leggibile.
Lettura del contesto: altezza della heatmap proporzionale al numero di epoche a px/trial costante, cosi` un gruppo da 86 non occupa lo stesso spazio di uno da 1; lisciatura sui trial adiacenti in stile erpimage; sei palette divergenti, quattro a luminanza simmetrica fra i due rami; e gli altri marker che cadono nella finestra, disegnati alla posizione mediana con la banda interquartile a dichiararne la dispersione.
Rimosso il vecchio pannello ERP: 7267 righe eliminate, fra cui un modulo da 5639. Con esso escono dall'interfaccia Sub-Noise Radar, ERP Band Tracking, MMR e la creazione della Baseline Correction: verranno ricostruite dentro la nuova architettura quando serviranno, e il loro codice Rust resta al suo posto. Il tipo di azione baseline-correction continua a funzionare nella History e nel replay delle sessioni esistenti.

30 Jul 2026

Filtri FIR — la transizione segue la banda richiesta: la larghezza di transizione aveva un pavimento fs*0.0015 e un tetto di 8 Hz; sopra 5333 Hz il pavimento superava il tetto, l'intervallo si invertiva e la funzione restituiva lo stesso numero per qualunque banda (a 10 kHz, 15 Hz di transizione tanto per una banda di 2 Hz quanto per una di 100). Conseguenze misurate, tutte silenziose: la banda 3000–3002 Hz usciva a −13.10 dB e larga 8.7 Hz, la banda delta a 10 kHz a −27.05 dB, un passa-alto chiesto a 0.5 Hz tagliava davvero a 4.4 Hz.
Convoluzione FIR su FFT: quel pavimento era un tetto di costo travestito da parametro di progetto, perche` la convoluzione era diretta e la lunghezza del kernel e` 4*fs/tw. Sostituita con overlap-add su FFT conservando l'allineamento temporale esatto: su 60 s a 10 kHz con kernel da 50001 tap, da 28156 ms a 32 ms. La soglia di commutazione e` fissata a 2668 tap, uno piu` del massimo che la vecchia stima potesse produrre, cosi` ogni filtro gia` costruibile resta bit-identico per costruzione.
Guardie su Nyquist e durata: nessun controllo di Nyquist esisteva nella catena: una banda sopra Nyquist restituiva l'alias, una a cavallo restituiva guadagno 2.0. Ora band-pass, band-stop, passa-alto, passa-basso e Decomposition rifiutano con un messaggio esplicito. Tolto il tetto di costo, il limite residuo e` la durata della registrazione — circa 10/W secondi per una banda larga W — e la soglia coincide con quella di MNE, non piu` stretta.
Validazione contro scipy, MNE ed EEGLAB: i kernel confrontati sono quelli che il core Rust costruisce davvero, esportati dal crate e non riscritti in Python. A parita` di ordine EEGLAB riproduce Hertz fino alla terza cifra decimale; scipy.firwin coincide esattamente. Il referto documenta anche che MNE ed EEGLAB derivano la transizione dalla frequenza di taglio: su 3000–3002 Hz a 10 kHz entrambi calcolano 750 Hz di transizione e 45 tap. Riproducibile con node scripts/comparative/run-fir-validation.mjs.
Import HDF5 su WebAssembly: il lettore passa da jsfive (JavaScript puro) a h5wasm. Su un file g.tec da 106 MB l'import scende da circa 5000 ms a 138 ms e il picco di memoria da 967 MB a 11 MB — prima era venti volte il file, con rischio di blocco della scheda su macchine con poca RAM. Il segnale prodotto e` identico, hash SHA-256 di tutti i 26 milioni di campioni compreso.
Checklist UAT: 126 casi di prova generati dai menu, con controllo automatico di copertura sulle voci di index.html (70 su 70). Cartella uat/ autonoma con i segnali di prova e l'ordine di esecuzione.

29 Jul 2026

Impostazioni per-grafico nel popup standard: il pannello dei limiti d'asse usa ora l'overlay centrato dell'applicazione, con sviluppo orizzontale e un riquadro per asse, nel vocabolario del pannello Session; aggiunta la scelta fra scala lineare e logaritmica sull'asse Y.
Scala logaritmica solo dove ha senso: sulle viste gia` espresse in dB la scala logaritmica non viene piu` proposta — applicherebbe il logaritmo due volte, e i valori negativi normali in dB su quella scala non esistono.
Menu Analysis raggruppato: sei sezioni etichettate che separano le analisi immediate da quelle con pannello di parametri, dalle analisi fra canali e dagli strumenti.
Controlli contestuali: Spectral Sensitivity compare solo dove ha effetto; rimosso psdFmax, che non controllava nulla.

28 Jul 2026

Gating Noise su una porzione: l'analisi puo` essere limitata a un intervallo della registrazione; cambiando l'intervallo i risultati calcolati si azzerano da soli e la registrazione di controllo resta caricata.
Ingranaggio per-grafico: ogni grafico ha un pannello da cui fissare il massimo degli assi, per allineare la figura che si sta per esportare a una fatta altrove. I limiti sopravvivono al cambio di file — e` esattamente il caso d'uso — e vengono sospesi, non scartati in silenzio, quando cambia l'unita` di misura.
Export scientifico: corretto un difetto per cui non produceva alcun file, con l'eccezione inghiottita silenziosamente.
Assi delle PSD: ripristinata la scala logaritmica delle frequenze, che serve a non appiattire i file ad alto sampling rate, e corretto cio` che l'aveva rotta; l'unita` di misura dell'asse Y ha ora lo spazio per essere disegnata.
Campo sampling rate: allargato perche` i valori a sei cifre siano leggibili per intero.

27 Jul 2026

Un'unica icona di export: tutte le etichette testuali e le icone diverse fra loro sostituite da una sola icona a fotocamera, in alto a destra del pannello di ogni grafico, accanto a quella CSV.
Le analisi seguono il sampling rate: i tetti di frequenza fissati sulle bande EEG sono stati rimossi in nove viste: il calcolo arriva sempre a Nyquist del file, mentre il profilo di analisi governa solo gli altri parametri. Prima una FFT su un file a 10 kHz si fermava a 58 Hz.
PAC ad alti sampling rate: corretto un difetto per cui la matrice usciva tutta nera: il filtro di fase, Butterworth di secondo ordine in f32, divergeva sopra i 4 kHz producendo zero campioni finiti. Risolto con decimazione della fase e calcolo in f64; le bande di ampiezza sono ora log-spaziate fino a 0.85 Nyquist.
Griglie derivate invece che fisse: la griglia di frequenza SST non e` piu` bloccata a 256 bin ma deriva dal passo in Hz, ora parametro di sessione; la finestra STFT e la decimazione temporale derivano dalla registrazione.
Etichette degli assi compatte: niente decimali superflui, migliaia abbreviate con k, unita` di misura visibili anche nelle immagini esportate; corretta la scala delle PSD che stampava solo zeri.
Pannello ERP: non si apre piu` al clic su elementi non correlati; tre funzioni di render navigavano come effetto collaterale.
Avanzamento e precaricamento: SST, Hilbert Spectrum e PAC riportano il progresso; il precaricamento delle heatmap in background resta fuori dall'indicatore e parte solo quando e` piu` economico della vista stessa.

25 Jul 2026

Gating Noise — file di controllo in qualsiasi formato: il caricamento della registrazione di controllo era vincolato ad ABF; passa ora dalle primitive di import condivise, quindi accetta EDF/REC, CSV, TXT, DIF, HAE/HAC/HZZ, IQ, WAV, BIN, DAT, HDF5 e NEX. I formati senza intestazione ereditano il sampling rate della registrazione attiva.
Gating Noise — export della figura: il grafico PSD si esporta come PNG ad alta risoluzione con intestazione del nome file, parametri di configurazione e risultati, scelta del tema e blocchi opzionali.
Tema chiaro, primo incremento: interruttore, overlay dei controlli grafico e pulsanti a pillola passano da colori scritti a mano a token con doppio tema. I valori del tema scuro sono identici a prima, quindi il tema scuro non cambia.

23 Jul 2026

Tre nuovi pannelli di analisi: Gating Noise, ML-NSFA e Spectral Counterbalance, con i rispettivi moduli WASM (gating_noise, ml_nsfa, spectral_redistribution), viste e profili di analisi dedicati. Inclusi aggiornamenti al parser ABF, nuovi test e i manuali dei pannelli in docs/.

16 Jul 2026

Manuale della libreria WASM: documentazione di hertz-wasm-v2 come modulo condivisibile (SDK/DLL): caricamento, modello di memoria a riuso di buffer, gate di licenza e catalogo delle 166 funzioni esportate. Include l'audit del manuale contro il codice, che ha corretto fra l'altro il conteggio reale delle funzioni, il fatto che le sa_* non sono compilate, e la descrizione di cleanline come regressione sinusoidale.

15 Jul 2026

ELTF rendering piu` veloce: le heatmap usano ora una LUT colori precalcolata a 1024 livelli (il mapping per-pixel si riduce a tre letture di array) e il dominio colore di base viene memoizzato per matrice di potenza, cosi` gli slider Contrast/Resolution non rifanno il passaggio sui quantili di ogni heatmap ad ogni ridisegno.
Block picker multi-selezione: nei blocchi Reference/Contrast i menu di selezione condizioni e canali restano aperti finche` non si clicca fuori, permettendo di selezionare e deselezionare piu` voci senza dover riaprire il menu ad ogni scelta.
Colorbar overlay statistico: la scala dell'overlay di contrasto e` ora etichettata t (Welch) invece del fuorviante z-score.
Manuale pannello ELTF: aggiunto in docs/ il manuale completo del pannello Event-Locked TF (Markdown, HTML stampabile e PDF).
Source Localization — correttezza del problema inverso: standardizzazione sLORETA riportata alle unita` canoniche (era scalata di un fattore globale √λ); standardizzazione free-orientation con l'inversa del blocco 3×3 completo della resolution matrix (l'approssimazione isotropa deviava fino al ~60%); la noise covariance viene ora effettivamente usata da sLORETA in modalita` full-noise (whitening del lead field con C^-1/2); eLORETA centra il lead field sotto average reference come MNE/sLORETA. Formule verificate contro Pascual-Marqui 2002/2007.
Nomenclatura Source: l'etichetta generica “LORETA” e` stata sostituita con “Source Localization (sLORETA/eLORETA)”: il pannello calcola sLORETA/eLORETA, non la LORETA originale del 1994.
Slice anatomiche MNI152 reali: le viste ortogonali axial/coronal/sagittal usano ora slice del template ICBM152 (MNI152) 2009 brain-extracted (livelli z=+12, y=−18, x=0 mm), al posto delle immagini generate da AI, con orientamenti L/R · A/P · S/I coerenti con le convenzioni del pannello e attribuzione del template inclusa.
Allineamento heatmap esatto: sulle slice ortogonali la heatmap delle sorgenti viene ora posizionata con una mappatura MNI(mm)→pixel fissa, derivata dalla geometria reale del template, al posto dell'euristica bounding-box + affine “a blend”: ogni sorgente cade sulla sua posizione anatomica corretta (verificato su punti MNI noti).
Slice alla profondità della sorgente: ogni piano dispone ora di uno stack di livelli MNI152 (6 per piano); il pannello mostra la slice che passa alla profondità della sorgente dominante e la heatmap è filtrata alle sole sorgenti vicine a quel livello, così l'overlay è una vera sezione e non più una proiezione che collassa tutte le profondità. Durante l'animazione la slice resta stabile mentre la heatmap evolve nel tempo.
eLORETA su bundle a orientamento libero: il solver eLORETA supporta ora i lead field vettoriali a 3 orientamenti (gli stessi usati da sLORETA), con la versione matrice-pesata del fixed point di Pascual-Marqui (2007); prima falliva su questi bundle e funzionava solo sLORETA.

14 Jul 2026

ELTF Welch t-test reale: i p-value del contrasto a blocchi usano ora i gradi di liberta` di Welch-Satterthwaite con la CDF t di Student (verificata contro scipy.stats.ttest_ind) al posto della normale standard, che sottostimava p di 1.6x-6.3x ai trial count tipici degli ERP; le statistiche sufficienti sono accumulate in f64 per evitare la perdita di precisione con baseline sottrattiva; default minTrialsPerGroup alzato da 2 a 10.
Contrasto same-channel: un contrasto paired gira sempre sui canali del blocco reference (rimosso il channel picker dal blocco contrast); ripristinato il contorno giallo dell'area di interesse in modalita` multicanale; la sensibilita` dell'overlay e` ora uno slider live.
License enforcement nel core WASM: ogni funzione esportata verifica ora la propria autorizzazione direttamente nel core Rust, con la tabella dei tier allineata ai requisiti gia` applicati dalla UI.
Wavelet scalogram loader: il pannello scalogramma usa il loader condiviso dei pannelli, allineandosi al multitaper.

13 Jul 2026

Large-file import DAT/IQ/WAV su WASM multi-thread: il downsampling a chunk per file .dat, .iq e .wav molto grandi gira ora nel core Rust/WASM con parallelismo Rayon per canale (mc_average_decimate_dat_i16_ptr, mc_average_decimate_iq_f32_ptr, mc_average_decimate_wav_ptr) al posto del vecchio loop JS single-thread, con fallback automatico al percorso JS se il core caricato non espone ancora le nuove funzioni.
Worker bootstrap fix: risolto un bug per cui src/config/runtimeEndpoints.js non veniva incluso nello staging di produzione, causando il fallimento silenzioso del bootstrap del WASM worker sulle build fresche.
Worker resilience: il client worker riaggancia ora correttamente i listener onmessage/onerror quando un worker viene ricreato dopo un errore, evitando blocchi silenziosi delle richieste in corso durante l'import di file grandi.
Rayon thread-pool fix: corretta la patch mancante su workerHelpers.js generato da wasm-bindgen-rayon, che causava un errore di tipo MIME all'avvio dei thread WASM.

25 May 2026

NEX ingest + ELTF text-condition bridge: il file picker accetta ora .nex, il parser importa stream continui ed eventi base e ELTF promuove automaticamente marker testuali a gruppi condizione selezionabili quando il dataset non contiene codici numerici condition-phase, senza piu` toggle manuale nel pannello Session.
ELTF results + plot docking: il pannello bottom ELTF Results usa una testata piu` compatta, mostra marker contestuali dentro le epoche come guide grigie e puo` far collassare il signal plot top in una strip Open signal plot ripristinabile o nel comando manuale Hide.
Theme architecture hardening: avviata la migrazione verso token di tema condivisi per shell sidebar, popup base e Preferences, mantenendo il modello dark-first con variante light opzionale.
Light-mode coverage: aggiunti override coerenti per About, popup startup file, EEG gate e controlli utility flottanti, riducendo la dipendenza da palette dark hardcoded.
Top-bar theme toggle: introdotto accanto a Help un toggle rapido a icona singola; in tema dark mostra il sole, in tema light mostra la luna, restando sincronizzato con Preferences > Appearance.
Marker visibility propagation: il controllo Show markers / Hide markers del grafico principale usa ora uno stato condiviso e si propaga anche alle view bottom che supportano overlay marker, inclusa Decomposition.
Release prep: build di release aggiornata con staging completo, metadati build rinfrescati e pacchetto benchmark pubblico riallineato al runtime corrente.

24 May 2026

BFD migration completed: il codice vivo di parser sidecar ed ELTF renderer e` stato migrato sotto src/, il bootstrap legacy separato e` stato rimosso e la cartella bfd/ e` stata eliminata dal runtime e dal repo.
Runtime staging cleanup: lo staging non genera piu` la root annidata /bfd/ ne` il worker dedicato bigDataWorker.js; il file mode principale resta l'unico entrypoint operativo.
Offline update fix: il deploy sincronizza ora anche sw.js, precache-manifest.json e build-info.json nella root runtime, cosi` il confronto dei manifest puo` rilevare davvero gli aggiornamenti pubblicati sul server.
Localhost update prompt: su https://localhost il service worker non viene piu` azzerato automaticamente; il popup Update Available segue lo stesso flusso della produzione e aspetta conferma esplicita dell'utente.
Update completion controls: una volta scaricata la nuova release, il popup propone ora Refresh per entrare subito nella build aggiornata oppure Cancel per restare nella sessione corrente.
ERP / ELTF lazy rendering: i blocchi del pannello ERP, soprattutto le heatmap ELTF, vengono costruiti on-demand durante lo scroll con placeholder e piccolo loader centrale, evitando di consumare CPU/WASM per pannelli non ancora visibili.

23 May 2026

Large DAT import: introdotto il flusso working copy per file .dat molto grandi, con downsampling diretto, sidecar events/timestamps e metadata originali preservati.
ELTF in file mode: il set di analisi Event-Locked TF e` ora disponibile nel file mode principale, con setup in sidebar e risultati nel tab bottom ELTF RESULTS.
ELTF results UX: i risultati usano il pannello bottom dedicato, il toggle Original / Processed e` stato spostato nella testata del panel e il calcolo mostra stato/progresso senza riempire la sidebar di heatmap.
Marker rendering control: nel grafico principale i marker evento sono nascosti di default per evitare rallentamenti; quando presenti compare il pulsante Show markers / Hide markers.
HDF5 lab export: aggiunto export Hertz Lab HDF5 (.h5) con schema gerarchico /DATA/unit/condition/trial, ordine canali configurabile e documentazione hertz_lab_hdf5_v1.
Unified WASM runtime: il runtime scientifico e` stato unificato su un solo modulo src/wasm, includendo anche gli entrypoint ELTF usati dal file mode e dal BFD.
ELTF export fix: il bottone camera delle heatmap esporta ora PNG leggibili e scalate correttamente, invece di frammenti alla risoluzione nativa della matrice.

14 Apr 2026

Cookie consent footer: il comando Privacy & cookies e` stato spostato nel footer persistente per evitare sovrapposizioni con i controlli laterali.
Footer slot dedicato: introdotto il contenitore #footerConsentSlot accanto a #footerRuntimeStatus cosi` il bottone consenso viene montato in una posizione stabile.
Consent banner wiring: il banner ora prova prima il mount nel footer dedicato e usa fallback controllati solo se lo slot non e` disponibile.
Footer layout hardening: aggiornato il layout della bottom bar per gestire runtime status e controllo consenso senza collisioni visive su desktop e mobile.

12 Apr 2026

Source sidebar: pannello rinominato Source, con info operative ripulite e controlli concentrati su segnale, metodo, lambda, noise, finestra e azioni Run/Reload.
Orthogonal Source view: overview ridotta a Orthogonal e Scalp, con slice assiale/coronale/sagittale su asset anatomici runtime e heatmap mascherata.
Asset runtime Source: la cartella res/loreta-slices-gemini-20260411 viene ora inclusa nello staging di produzione per evitare 404 sugli asset ortogonali.
ERP marker panel: il vecchio tab MARKER e` ora esposto come ERP, mantenendo lista eventi, heatmap epoche e click marker.
Source marker playback: il click su un marker ERP puo` avviare il loop temporale sulle slice ortogonali usando finestra pre/post e bin marker configurati.
Bad-channel overlay: lo stato dei canali bad/repaired viene propagato alla vista Source/Scalp con bad in rosso e repaired in verde.
Source robustness: l'inversa sanifica campioni non finiti prima e dopo il calcolo, e il solo repair bad-channel non blocca piu` l'avvio come preprocessing QC.
SSA single-channel: nuovo pannello sidebar sul canale EEG corrente con scree plot, preset prudenti, preview ricostruzione e applicazione reversibile in pipeline.
Debug cleanup: rimosse dal Source sidebar le sezioni Runtime Diagnostics, Alignment QA, Scientific Readiness e l'export JSON di debug montage.

11 Apr 2026

HDF5 import: aggiunto supporto .h5/.hdf5 con lettura binaria, parser jsfive, riconoscimento firma HDF5 e metadata uV/SampleRate.
g.HIamp HDF5 schema: riconosciuto /RawData/Samples, esclusa la colonna contatore campioni quando presente e letti AcquisitionTaskDescription/DAQDeviceDescription.
HDF5 diagnostics: log import con dataset usato, schema rilevato, colonne escluse, label source e sampling-rate source; valori implausibili vengono scartati e richiesti nel popup.
BIDS montage importer: introdotta pipeline core per coordsystem.json, electrodes.tsv e channels.tsv, con unita convertite in mm e supporto NAS/LPA/RPA.
Montage spatial model: generati registration, surfaceAnchoring, proiezioni axial/coronal/sagittal e payload QA esportabile dal debug JSON.
Source Localization (sLORETA/eLORETA): vista ancora work-in-progress per ricerca e validazione tecnica; non e` un output clinico individualizzato e richiede ancora scalp mesh validata, lead field dedicato e soglie QA bloccanti.
Slice visualization: rimossi elettrodi e sorgenti puntiformi a reticolo dalle slice principali; la distribuzione dell'attivita ora usa una heatmap energia continua e multicolore.
QA guardrail: lo stato resta warn quando l'anchoring usa il fallback ellissoidale; serve una scalp mesh validata per promuovere il flusso a livello clinico.

10 Apr 2026

Batch Action: nuova esecuzione batch di pipeline esportate su piu file EDF/REC, con output EDF/REC/ABF.
Batch panel bottom: nuovo tab BATCH con stati per-file queued/loading/processing/exporting/done/error e azione finale Apri.
Batch popup redesign: popup compatto stile Adobe, a due colonne, con altezza controllata e setup rapido di pipeline, file e formato output.
Import popup redesign: pannello File Import Settings riallineato allo stesso linguaggio UI, piu leggibile per sampling rate, auto-detect, unita e colonne eventi.
Update popup emphasis: il popup di aggiornamento disponibile e` ora piu visibile con accento arancione dedicato nello stato Update Available.

9 Apr 2026

Offline differential update: introdotti precache-manifest.json, sync con hash e update offline che riscarica solo i file cambiati.
Service worker / staging prod: migliorato il flusso di staging del sito e la generazione degli asset di produzione con manifest e build timestamp coerenti.
Import/export robustness: aggiornati parser e flussi di import/export per EDF, CSV/TXT e ABF, inclusa configurazione file piu controllata.
Performance tuning: ottimizzazioni su viste e worker ad alto costo come PAC, PSD Multitaper, STFT Scalogram, heatmap avanzata e WebGPU wavelet.

Questa sezione raccoglie la documentazione operativa di Hertz. Se ti serve la reference tecnica completa su filtri, analisi, parametri richiesti e formule matematiche usate dal motore WASM, il punto giusto da aprire è questo:

Matematiche e processing reference: https://hertz.wavehub.it/docs/processing_reference.html

Manuale Operativo Hertz v2

Guida completa, menu-per-menu, per uso pratico e ricerca EEG. Ogni voce include scopo, procedura, esempio e algoritmo.

Flusso dati: original = sorgente caricata, processed = risultato pipeline.
History: tutte le azioni di processing vengono salvate e rigiocate in ordine.
WASM/MT: i calcoli pesanti sono eseguiti in worker WASM (multi-thread quando disponibile).
Licenza: alcune funzioni avanzate richiedono tier Explore/Lab.

Menu Hertz (Brand)

About Hertz

Uso: Logo Hertz > About Hertz.
Esempio: verifica stato licenza prima di ICA/ASR.
Algoritmo: nessun DSP; pannello informativo/stato licenza.

Preferences

Uso: Logo Hertz > Preferences.
Esempio: imposta preferenze marker o opzioni analisi.
Algoritmo: persistenza configurazioni applicative.

Menu File

Open signal...

Uso: File > Open signal e selezione file.
Formati: .bin, .csv, .txt, .dif, .abf, .hae, .edf, .h5, .hdf5, .iq, .wav.
Esempio: apri un EDF multicanale o un HDF5 g.HIamp e avvia preprocessing.
Algoritmo: identify parser + parse dedicato; EDF in worker, HDF5 in browser con schema/metadata e diagnostica import.

Import Montage...

Uso: File > Import Montage (.tsv/.csv/.json).
Esempio: importa electrodes.tsv, channels.tsv e coordsystem.json BIDS per costruire il modello spaziale degli elettrodi.
Algoritmo: matching label canale-coordinate, registrazione fiduciale NAS/LPA/RPA, proiezioni axial/coronal/sagittal e QA. L'anchoring ellissoidale resta un fallback finche non e` disponibile una scalp mesh validata.

Export (HAE) / Export Signal...

Uso: salva sessione completa (HAE) o segnale corrente.
Esempio: condividi traccia processata o archivio completo.
Algoritmo: serializzazione dati + metadati + pipeline.

Menu View

History Panel / Log Console / Info

Uso: attiva/disattiva i pannelli dalla voce View.
Esempio: apri History per disabilitare uno step e confrontare il risultato.
Algoritmo: gestione stato UI e replay pipeline.

Reset Layout

Uso: ripristina layout default della workspace.
Esempio: recupera pannelli dopo modifiche docking.
Algoritmo: reset stato tab/sidebar/bottom.

Menu Preprocessing

Remove DC offset

Uso: Preprocessing > Remove DC offset.
Esempio: centra baseline prima di PSD.
Algoritmo: y[n] = x[n] - mean(x).

Detrend

Uso: rimuove deriva lineare lenta.
Esempio: registrazioni lunghe con drift elettrodi.
Algoritmo: fit lineare e sottrazione y[n] = x[n] - (a*n+b).

Notch / Notch + harmonics / CleanLine

Uso: elimina rumore di rete e armoniche.
Esempio: 50Hz + 100Hz + 150Hz in ambiente clinico.
Parametri: notch con banda esplicita oppure Quality Factor (Q) da 1 a 100.
Algoritmo: notch IIR biquad (zero-phase) con banda derivata da BW = f / Q o regressione armonica locale (CleanLine).

High-pass / Low-pass

Uso: scegli engine IIR o FIR nel popup.
Esempio: HP 1 Hz, LP 40 Hz per EEG classico.
Algoritmo: Butterworth IIR o FIR con finestra.

Smoothing (MA/EMA)

Uso: attenua jitter ad alta frequenza.
Esempio: preview pulita senza filtro duro.
Algoritmo: MA: media mobile, EMA: s_t = a*x_t + (1-a)*s_{t-1}.

Wavelet denoising / Artifact-spike suppression / SSA single-channel / Z-score

Uso: pulizia avanzata e normalizzazione.
Esempio: riduzione drift o componenti candidate dopo revisione della preview sul canale attivo.
Algoritmo: decomposizione wavelet o SSA single-channel; soglia outlier su sigma; normalizzazione z-score.

Menu Multichannel Proc

Common Average Reference (CAR)

Uso: applica riferimento medio comune su tutti i canali inclusi.
Esempio: riduzione componente comune di volume conduction.
Algoritmo: sottrazione media sample-by-sample.

Reference Tools / Spatial Transforms

Uso: apre pannello con metodi avanzati.
Metodi Reference: CAR, Median, Robust trimmed mean, PREP (solo passo robust-reference, non l'intera pipeline Bigdely-Shamlo), REST (Approx, non il REST di Yao 2001), Linked Mastoids, Custom pool.
Metodi Spatial: Bipolar, CSD Hjorth (tabella fissa 10-20; su canali non standard ricade sull'adiacenza per indice, non sulla topologia dello scalpo), CSD Perrin spherical spline.
Esempio: confronto REST vs CSD in pipeline identica.
Algoritmo: operazioni multicanale WASM (`mc-reref-*`) con eventuale coordinate montage.

EOG Regression / ECG Regression / SSP Projector

Uso: seleziona canali reference e strength.
Esempio: rimozione artefatti oculari/cardiaci.
Algoritmo: regressione lineare multicanale e proiezione subspace (PCA/SSP).

Bad Channel Correction / ASR / ICA

Uso: detect/repair canali, pulizia burst, separazione componenti.
Esempio: pipeline: Bad channels - ASR - ICA removal.
Algoritmo: metriche robustezza/correlazione, ASR (riscala l'ampiezza della componente PCA sopra soglia, non la ricostruisce dal sottospazio pulito), FastICA.

Menu Frequency Filters

Band-pass filter

Uso: scegli range/single, FIR/IIR, ordine, zero-phase e in modalita single usa banda o Q.
Esempio: 8-12 Hz per banda alpha.
Algoritmo: FIR (con transition width auto o manuale) o IIR stretto/largo; con Q la banda e` BW = center / Q.

Band-stop filter

Uso: rimozione banda mirata, anche in modalita stretta basata su Q.
Esempio: soppressione stretta 48-52 Hz.
Algoritmo: stop-band FIR/IIR con stesse opzioni del band-pass; in IIR stretto si comporta come notch centrato.

Peaking / Narrow Band-Pass

Uso: scorciatoia per aprire direttamente il band-pass stretto.
Esempio: isolare 10 Hz con Q=35.
Algoritmo: riusa il popup del band-pass preimpostato su IIR + single + Q.

Menu Decomposition

New Layer...

Uso: crea layer in banda, colore e label dedicati.
Esempio: layer Delta/Theta/Alpha con confronto visivo e sonoro.
Algoritmo: bandpass per-layer (FIR default), cache layer store, rendering e sonification FM.

Menu Analysis

FFT / PSD Welch / PSD raw / PSD percent / PSD Multitaper

Uso: seleziona vista spettro piu adatta al caso.
Esempio: usa Welch per stima stabile; Multitaper per leakage ridotto.
Algoritmo: FFT classica, periodogramma medio Welch, DPSS multitaper.

STFT / Wavelet Scalogram / SST / Hilbert Spectrum

Uso: analisi tempo-frequenza in base a risoluzione desiderata.
Esempio: transienti rapidi: wavelet; struttura continua: STFT; massima concentrazione: SST.
Algoritmo: trasformate tempo-frequenza bitmap in worker WASM.

PAC / Complexity & HHT

Uso: coupling fase-ampiezza e metriche non lineari.
Esempio: theta-gamma PAC su segmento cognitivo.
Algoritmo: fase low + envelope high + indice di modulazione; feature entropiche/frattali.

Source Modeling / Map Inspector / Neuro View 3D+2D

Uso: visualizzazioni topografiche 2D/3D e preset di interpolazione (sharp, standard, high-detail, wide-smooth, max-blend, focused, sparse-idw); e' una vista dell'ampiezza misurata ai sensori, non un forward model fisico (nessun volume conductor, nessuna lead field). Per una stima di sorgente vera vedi il pannello dedicato Source Localization (sLORETA/eLORETA).
Esempio: controlla evoluzione spaziale durante playback.
Algoritmo: interpolazione Gaussian/IDW elettrodi-superficie, rendering mesh/topomap e sincronizzazione tempo.

Frequency Histogram / GFP / RMS Difference / PLV

Uso: metriche aggregate frequenziali e spaziali.
Esempio: PLV tra canali frontali, GFP su tutto scalp.
Algoritmo: binning spettrale, deviazione spaziale (GFP), RMS differenziale, lock di fase.

Auto Pattern Discovery / Research Report / Sonification

Uso: pattern automatici, report stampabile, ascolto layer.
Esempio: genera report finale con pattern e confronto original/processed.
Algoritmo: template matching, batch-analysis WASM (no downsampling), sintesi FM sincronizzata.

Menu Features

Run Analysis (Sequential)

Uso: lancia il calcolo sequenziale completo feature.
Esempio: benchmark su canale attivo o confronto multi-sessione.
Algoritmo: compute-all-features/compute-single-feature WASM; supporto multichannel packed.

Menu Events

Load events...

Uso: importa eventi da .json/.csv/.event/.edf.event/.taf/.annotation.
Esempio: click evento per centrare main-top su onset.
Algoritmo: parser formato marker + normalizzazione tempo/durata + merge marker.

Menu Help

Validation Guide

Uso: riferimento formule e controlli rapidi MATLAB/MNE.
Esempio: verifica coerenza filtro prima del benchmark comparativo.
Algoritmo: guida documentale, non modifica pipeline.

Fullscreen

Uso: icona fullscreen in alto a destra.
Esempio: massimizza area grafica su monitor ridotti.
Algoritmo: browser Fullscreen API.

Workflow Consigliato EEG

1. Carica file + eventuale montage.
2. Remove DC, Detrend, Notch/CleanLine.
3. Bandpass target (FIR o IIR).
4. Re-reference (CAR/REST/Linked/CSD secondo protocollo).
5. Bad Channels, ASR, ICA se necessari.
6. Analisi (PSD/STFT/Wavelet/Neuro View/PAC).
7. Features + Research Report.

Validation Guide

Purpose

Questa guida descrive come funziona la validazione DSP attuale di Hertz: cosa viene controllato realmente, come interpretare PASS/WARN/FAIL e come replicare i check in MATLAB/Python.

La validazione viene eseguita step-by-step sulla pipeline (input vs output di ogni azione).

Current Validation Engine (Real Behavior)

Per-step checks (input vs output)

FAIL: output con NaN oppure segnale nullo/silenzio.
PASS remove-dc / detrend: media output vicina a zero (|mean| < 1.0).
WARN remove-dc / detrend: residuo DC ancora rilevante.
PASS altri filtri: variazione RMS in range plausibile.
WARN altri filtri: esplosione ampiezza (> +60 dB) o attenuazione estrema (< -60 dB, eccetto band-stop).

Stati nel pannello History

PASS (verde): comportamento coerente con soglie del validator.
WARN (arancio): risultato plausibile ma sospetto o estremo.
FAIL (rosso): risultato non valido (es. NaN/silenzio).
Replay: i parametri dello step (es. qualityFactor) restano serializzati per undo/redo e ricarica file.

Validation Scope & Limits

Cosa valida oggi

Coerenza numerica step-by-step della pipeline.
Stabilita ampiezza tramite confronto RMS input/output.
Rimozione DC per remove-dc e detrend.

Cosa non valida ancora direttamente

Attenuazione precisa alla frequenza target (es. notch 50/60) come metrica dedicata per step.
Maschere frequenziali complete passband/stopband per ogni filtro.
Confronto statistico automatico con reference esterni (MATLAB/MNE) dentro la UI.

Per validazioni piu avanzate usa la sezione sotto ("External Repro Checks") o i benchmark comparativi offline.

Core Formulas Used in Checks

RMS

Formula: RMS(x) = sqrt( (1/N) * sum(x[n]^2) )

RMS delta in dB

Formula: dB = 20 * log10( RMS(out) / max(RMS(in), 1e-10) )

Remove-DC / Detrend mean check

Formula: mean_out = (1/N) * sum(y[n])

PASS quando |mean_out| < 1.0.

External Repro Checks (MATLAB / Python)

Remove DC

%% MATLAB
y = x - mean(x);

# Python / NumPy
y = x - x.mean()

Detrend

%% MATLAB
y = detrend(x);

# Python / SciPy
from scipy.signal import detrend
y = detrend(x)

Notch 50/60 Hz (manual frequency check)

%% MATLAB
wo = 50/(fs/2); bw = wo/35;
[b,a] = iirnotch(wo,bw);
y = filtfilt(b,a,x);

# Python / MNE
import mne
y = mne.filter.notch_filter(x, sfreq=fs, freqs=[50])

Band-pass / High-pass / Low-pass

%% MATLAB (example: band-pass)
[b,a] = butter(4, [l h]/(fs/2), 'bandpass');
y = filtfilt(b,a,x);

# Python / MNE
y = mne.filter.filter_data(x, sfreq=fs, l_freq=l, h_freq=h)

RMS dB change

%% MATLAB
rms_in = sqrt(mean(x.^2));
rms_out = sqrt(mean(y.^2));
db = 20*log10(rms_out/max(rms_in,1e-10));

Feature Sanity Checks

Statistical base checks

RMS: sqrt( mean(x^2) )
Variance: mean( (x-mean(x))^2 )
Skewness: terzo momento standardizzato.
Kurtosis: quarto momento standardizzato.

Complexity and spectral checks

Shannon entropy: H = -sum p log(p)
Sample entropy: SampEn = -ln(A/B)
LZC: complessita da sequenza binarizzata.
Higuchi/Hurst/DFA: stime frattali e dipendenza long-range.
Hjorth: activity, mobility, complexity.
Spectral peak / dominant band: coerenza con PSD/STFT attesa.

Project Info

Filename – Samples – Rate (Hz)

Type – Active Channel – Duration – Patient – Recording – Start time – Montage –

Analysis Parameters

Spectral estimator settings for this session.
Defaults follow the selected profile; EEG reproduces the historical behaviour.

Signal Cutter

Trim signal to selected range.
Allowed only on raw signal (no history).

Start (s)

End (s)

Use Current View

Align markers after cut

Downsampling (WASM/MT)

Anti-alias FIR + decimation (single/multichannel).
Allowed only on raw signal (no history).

Target Rate (Hz)

Decimation Factor

Cutoff (Hz)

Transition (Hz)

–

Channels

Amp 0.0

No channels loaded

0 selected

Frequency Channel Finder

Source Mode Band Min Hz Max Hz Target Hz ± Hz Top N Include disabled channels

Load a multichannel file and run analysis.

Channel Ranking

No results yet.

CAR

No CAR applied.

Quick CAR applies average reference. Use Reference & Spatial below for advanced methods.

Reference & Spatial

Select method and source, then apply.

Channels -

Reference Pool -

Method -

Method Source

Exclude disabled Exclude bad

Average and Median use exclusions. Linked Mastoids uses fixed channel pair.

Not applied.

RMS Difference

Phase Locking Value

–

Source Modeling (Sensors)

This is a sensor-level amplitude view: it interpolates/smooths the measured signal across electrode positions for visualization only. It does not compute a volume conductor, a lead field, or any forward/inverse model, and it is not a source estimate. The presets below only change the interpolation blur radius and blend, nothing physical. For an actual source estimate, use the dedicated Source Localization (sLORETA/eLORETA) panel.

Interpolation Preset Compute Mode Output View Blur Radius

Extended coverage blending High-resolution rendering

Not applied.

ICA Setup

Mode Source Channels

Components Max Iter Tolerance Stride Seed

Quality uses FastICA full-rank. Speed uses FastICA + PCA 0.99 with ~90% components.

ICA Components

Run ICA to view components.

Sort by

Apply is disabled when downsampling is used.

ASR (Subspace Rescale)

When a PCA component exceeds the burst threshold, this rescales that component's own amplitude down to the calibrated limit. It does not reconstruct the component from the clean subspace of the other components, so residual contaminated waveform shape can remain (this is not full Artifact Subspace Reconstruction as in Mullen et al. 2015 / EEGLAB clean_asr).

Calibration Start (s) End (s) Window (s) Overlap Burst Criterion

Not applied.

ASR runs on the current multichannel processing pipeline.

Pipeline action inactive.

GFP Before / After

Correction Burden

Bad Channel Detection

Source Stride Var Z Flat Ratio Corr Min HF Noise Z Spatial Z Neighbors

Bad Channels

Run analysis to view bad channels.

Repairs write to processed.

Artifact Search

CRITERIA

Threshold-based amplitude

Abs threshold uV Min duration ms

Step-like artifact

Diff z-thr z Shift z-thr z

Window ms Refractory ms

Abnormality by kurtosis

Window ms Step ms

Kurtosis z-thr z Min duration ms

Add markers

Pipeline Actions

Valid.

Patterns 0

Discovery Settings

Mode

Dur (s)

Sim (%)

Reps

Max Hz

Min Ch

Lag ms

Ready

No patterns detected.
Select a range -> Right Click -> Find Patterns

Pattern Heatmap No data