sdr-visual-suite/internal/classifier/types.go

package classifier

// SignalClass is a coarse modulation label.
type SignalClass string

const (
	ClassAM      SignalClass = "AM"
	ClassNFM     SignalClass = "NFM"
	ClassWFM     SignalClass = "WFM"
	ClassWFMStereo SignalClass = "WFM_STEREO"
	ClassSSBUSB  SignalClass = "USB"
	ClassSSBLSB  SignalClass = "LSB"
	ClassCW      SignalClass = "CW"
	ClassFSK     SignalClass = "FSK"
	ClassPSK     SignalClass = "PSK"
	ClassDMR     SignalClass = "DMR"
	ClassDStar   SignalClass = "D-STAR"
	ClassFT8     SignalClass = "FT8"
	ClassWSPR    SignalClass = "WSPR"
	ClassNoise   SignalClass = "NOISE"
	ClassUnknown SignalClass = "UNKNOWN"
)

// Features are lightweight spectral features derived from a signal slice.
type Features struct {
	// Spectral
	BW3dB        float64 `json:"bw_3db_hz"`
	BW90         float64 `json:"bw_90_hz"`
	SpectralFlat float64 `json:"spectral_flat"`
	PeakToAvg    float64 `json:"peak_to_avg_db"`
	Symmetry     float64 `json:"symmetry"`
	RolloffLeft  float64 `json:"rolloff_left_db_khz"`
	RolloffRight float64 `json:"rolloff_right_db_khz"`
	// Temporal
	EnvVariance float64 `json:"env_variance"`
	ZeroCross   float64 `json:"zero_cross_rate"`
	InstFreqStd float64 `json:"inst_freq_std"`
	CrestFactor float64 `json:"crest_factor"`
}

// Classification is the classifier output attached to signals/events.
type Classification struct {
	ModType      SignalClass             `json:"mod_type"`
	Confidence   float64                 `json:"confidence"`
	BW3dB        float64                 `json:"bw_3db_hz"`
	Features     Features                `json:"features,omitempty"`
	MathFeatures *MathFeatures           `json:"math_features,omitempty"`
	PLL          *PLLResult              `json:"pll,omitempty"`
	SecondBest   SignalClass             `json:"second_best,omitempty"`
	Scores       map[SignalClass]float64 `json:"scores,omitempty"`
}

// SignalInput is the minimal input needed for classification.
type SignalInput struct {
	FirstBin int
	LastBin  int
	SNRDb    float64
	CenterHz float64
	BWHz     float64 // Occupied bandwidth from detector (edge-expanded)
}