SIGNAL_API_v1 — GX-TXT Documentation

Indice

math.signal 1.2.0 è un servizio scientifico CORE non selezionabile. Espone SIGNAL_API_v1; non è un modulo Analysis da eseguire e non pubblica da solo un workflow scientifico completo.

Backend corrente: GNU Octave con i package signal/control installati. Le operazioni sono seriali e non creano un worker pool autonomo.

1. Binding pubblici

GNU Octave:
  gxtxt_signal_v1(family, action, a, b, c, options)

Script Bridge:
  gxtxt_api_require('SIGNAL_API_v1@1:math.signal')
  gxtxt_api_call('SIGNAL_API_v1','family.action',{a,b,c,options})

2. Famiglie di operazioni

Famiglia	Funzioni principali	Uso
`convolution`	linear, circular, deconvolve	Convoluzione e deconvoluzione regolarizzata.
`correlation`	auto, cross, delay	Autocorrelazione, cross-correlazione e stima ritardo.
`filter`	inspect, causal, zero_phase, sos	Applicazione e ispezione di filtri.
`design`	Butterworth, Chebyshev I/II, elliptic, Bessel, FIR window, estimate_order	Progetto filtri esplicito.
`multirate`	decimate, interpolate, rational	Ricampionamento con anti-alias filtering.
`lti`	tf, zpk, ss, zoh, foh, tustin, matched...	Modelli LTI e conversioni continue/discrete.
`response`	evaluate, frequency, impulse, step, input	Risposta di sistemi LTI.
`spectral`	periodogram, welch, asd, cross_psd, coherence, frf_h1, frf_h2, window_metrics	Primitive spettrali riusabili.
`stft`	forward, inverse	STFT complessa e ricostruzione overlap-add.
`cepstrum`	real, complex, inverse, lifter	Analisi cepstrale.
`wavelet`	dwt, inverse_dwt, cwt, scalogram	Trasformate wavelet discrete/continue.
`generate`	sine, multi_tone, chirp, square, pulse, impulse, white/colored noise, AM, FM	Segnali deterministici o noise con seed dichiarato.
`analytic`	signal, envelope, phase, instantaneous_frequency	Hilbert/analytic signal e demodulazione.
`frequency_metric`	gain, delays, peak, resonance, bandwidth, Q, margins	Metriche di risposta in frequenza.
`time_metric`	step, slew, pulse	Rise/fall, settling, overshoot, slew, width, jitter.
`quality`	basic, snr, harmonics, spectrum	RMS, crest factor, SNR, THD, THD+N, SINAD, SFDR, ENOB.
`events`	crossings, period, delay	Eventi e timing con interpolazione lineare.

3. Che cosa NON fa SIGNAL_API_v1

Non sceglie da solo il Dataset sorgente.
Non decide che una variabile sia “il segnale” senza un binding.
Non pubblica automaticamente spectrum.table.
Non conserva Session provenance del workflow al posto del modulo Analysis.
Non sostituisce FFT Spectrum, Welch, Cross-Spectral o altri moduli ufficiali.

4. Typed nodes nello Script Bridge

Nel binding Script Bridge gli array sono nodi tipizzati con kind=array, shape, parte reale e opzionale parte immaginaria. Direct Octave usa invece normali array numerici e struct. Le unità restano esplicite; l'API non inventa il sample rate.

5. Relazione con NUMERIC_API_v1

math.signal dipende da math.numeric. La divisione concettuale è: NUMERIC_API contiene matematica generale; SIGNAL_API contiene matematica specifica di segnali e sistemi; i moduli Analysis definiscono workflow scientifici e output persistenti.